| Ambos lados da revisão anteriorRevisão anterior | |
| routine [2025/07/18 20:44] – [Attempts Panel] admin | routine [2025/07/18 20:46] (atual) – admin |
|---|
| ====== Routine ====== | ====== Routine ====== |
| |
| The routine represents the execution of the user's [[Programming|code]] in a specific arena. The routine panel, located in the upper left corner of sBotics, allows you to start, stop, and restart the simulation. Routine information, such as score, time, and multipliers, are displayed in the upper center of the screen, as illustrated in the image below. | The routine represents the execution of the user's [[Programming|code]] in a specific arena. The routine panel, located at the top-left corner of sBotics, allows you to start, stop, and restart the simulation. Routine information such as score, time, and multipliers is displayed at the top center of the screen, as shown below. |
| |
| {{ rotina-barra.png }} | {{ rotina-barra.png }} |
| |
| To start the routine, click the "play" symbol. To stop it, click the square in the same location. If you wish to restart the scenario, use the restart icon (''↺''). | To start the routine, click the "play" icon. To stop it, click the square in the same place. If you want to restart the scenario, use the restart icon (''↺''). |
| |
| ===== Console ===== | ===== Console ===== |
| |
| The console is the main tool for data output in sBotics, along with the Buzzer and LED components. It allows you to print sensor values, display text, and describe the robot's step-by-step execution. | The console is the main output tool in sBotics, along with the Buzzer and LED components. It allows you to print sensor values, display text, and describe the step-by-step execution of the robot. |
| |
| {{ console.png }} | {{ console.png }} |
| |
| > It is possible to clear the console manually through the broom icon and access the detailed log by clicking the document icon, both located on the right side of the panel. | > You can manually clear the console using the broom icon, and access the detailed log by clicking the document icon, both located on the right side of the panel. |
| |
| ==== Log ==== | ==== Log File ==== |
| |
| The log file, accessible through the "Document" icon in the console panel, is an external record to sBotics. It allows you to generate graphs, ''.csv'' files, and other complex implementations from the data generated during the simulation. | The log file, accessible via the "Document" icon on the console panel, is an external record generated by sBotics. It allows you to create charts, ''.csv'' files, and other advanced implementations based on data generated during the simulation. |
| |
| ===== Scorer/Tracker ===== | ===== Scoring / Tracker ===== |
| |
| sBotics uses tiles to score the routine. Each tile has a score value, which is added (or multiplied) to the total as the robot navigates the arena. | sBotics uses tiles to score the routine. Each tile has a score value, which is added (or multiplied) to the total score as the robot moves around the arena. |
| |
| The path, formed by tiles, can be divided into smaller segments, called "trajetos" (routes), using "Checkpoints." A typical sBotics arena can contain one or more trajetos. Deviating from the correct trajeto can result in a "Progress Failure." | The path, formed by tiles, can be divided into smaller segments called "tracks" using "Checkpoints". A typical sBotics arena may contain one or more tracks. Leaving the correct track may result in a "Progress Failure". |
| |
| ==== Trajeto / Checkpoints ==== | ==== Track / Checkpoints ==== |
| |
| As mentioned earlier, the trajeto is subdivided into checkpoints. In the routine panel, the checkpoint tiles are identified by orange arrows, which indicate the direction in which the robot will be repositioned when starting a new attempt from that checkpoint. If the trajeto passes through the same tile in different positions, multiple arrows will be displayed. | As mentioned earlier, the track is subdivided by checkpoints. On the routine panel, checkpoint tiles are marked with orange arrows indicating the direction in which the robot will be repositioned when starting a new attempt from that checkpoint. If the track passes over the same tile in different directions, multiple arrows will be shown. |
| |
| In this way, the arena below, when considering the checkpoints, is segmented into small trajetos. | Thus, the arena below is segmented into small tracks when considering the checkpoints. |
| |
| {{arena.png?450}} {{arena-trajeto.png?450}} | {{arena.png?450}} {{arena-trajeto.png?450}} |
| ==== Progress Failure ==== | ==== Progress Failure ==== |
| |
| If the robot deviates from the expected trajeto, a progress failure counter will be displayed in the lower corner of the interface, indicating the type of failure and the remaining time before penalization. In the example below, the counter indicates a failure due to robot inactivity. | If the robot deviates from the expected track, a progress failure counter will appear at the bottom of the interface, indicating the type of failure and the remaining time before penalty. In the example below, the counter shows a failure due to robot inactivity. |
| |
| {{ contador-lop.png?475 }} | {{ contador-lop.png?475 }} |
| |
| > When it reaches zero, a new attempt is started, forcing the robot to restart. | > When the counter reaches zero, a new attempt starts, forcing the robot to restart. |
| |
| For progress failures related to the trajeto, deviating more than two tiles results in a "grave" (severe) failure, while deviating only one tile results in a "leve" (minor) failure. The time granted for correction varies according to the arena configuration, being 50 seconds for minor failures and 10 seconds for severe failures in OBR. | For track-related progress failures, deviating by more than two tiles results in a "severe" failure, while deviating by only one tile is a "minor" failure. The time allowed to correct the deviation varies depending on the arena setup — 50 seconds for minor failures and 10 seconds for severe failures in OBR competitions. |
| |
| {{falha-leve.png?450}} {{falha-grave.png?450}} | {{falha-leve.png?450}} {{falha-grave.png?450}} |
| |
| //Observe nas imagens acima que desviar um ladrilho é indicado por laranja, enquanto desviar dois ou mais é indicado por vermelho.// | //Note in the images above: a one-tile deviation is marked in orange, while two or more tiles is marked in red.// |
| |
| ===== Attempts Panel ===== | ===== Attempts Panel ===== |
| {{ rotina-painel.png?200}} | {{ rotina-painel.png?200}} |
| |
| The routine panel allows you to start new attempts and advance to other trajetos, if available. It also displays the routine status in relation to attempts and trajetos. | The routine panel allows you to start new attempts and move on to other tracks if available. It also shows the routine's status in terms of attempts and tracks. |
| |
| ^ {{ icons8-fuse-symbol-100.png?64 }} ^ {{ icons8-refresh-100.png?64 }} ^ {{ icons8-return-90.png?64 }} ^ | ^ {{ icons8-fuse-symbol-100.png?64 }} ^ {{ icons8-refresh-100.png?64 }} ^ {{ icons8-return-90.png?64 }} ^ |
| ^ Path ^ No. of Tries ^ Total Attempts ^ | ^ Track ^ Attempt ^ Total Attempts ^ |
| | Current trajeto number | Attempt number in the current trajeto | Total number of attempts across all trajetos | | | Current track number | Current attempt number within this track | Total number of attempts across all tracks | |
| |
| > //Observação:// O painel de tentativas e as funcionalidades de nova tentativa e avanço só estão disponíveis em arenas do tipo "linha/trajeto". | > //Note:// The attempts panel and the retry/advance features are only available in "line/track"-type arenas. |
| |
| ==== New Attempt / Advance ==== | ==== Retry / Advance ==== |
| |
| It is possible to restart the current trajeto or advance to the next, restarting the robot's position and code. | You can restart the current track or move on to the next one, resetting the robot's position and code. |
| |
| Note: In some arenas, the "Advance" button will only be available after a minimum number of attempts (3 in OBR). | Note: In some arenas, the "Advance" button is only available after a minimum number of attempts (3 in OBR). |
| |
| > To keep values between attempts, use static variables: "''estatico numero''" / "''estatico texto''" / "''estatico booleano''" in rEduc or 'static double' / 'static string' / 'static bool' in C#. | > To preserve values between attempts, use static variables: "''estatico numero''" / "''estatico texto''" / "''estatico booleano''" in rEduc or 'static double' / 'static string' / 'static bool' in C#. |
| |
| ===== Execution Report ===== | ===== Execution Report ===== |
| |
| The execution report, displayed at the bottom of the attempts panel, records routine events in two formats: simplified and detailed. | The execution report, displayed at the bottom of the attempts panel, logs routine events in two formats: simplified and detailed. |
| |
| Both reports allow recreating the robot's path and identifying scoring and failure points. The detailed report is used by the competition system to verify execution integrity. | Both reports allow you to recreate the robot's path and identify scoring points and failures. The detailed report is used by the competition system to verify the execution's integrity. |
| |
| **Example of a report excerpt:** | **Example of a Report Snippet:** |
| |
| <code> | <code> |
| [0:00] Pontuação adicionada; | [0:00] Score added; |
| ↳ 5 Pts. (×1,00); | ↳ 5 pts. (×1.00); |
| ↳ 1 @ 1. | ↳ 1 @ 1. |
| |
| [0:00] Entrou no ladrilho pela primeira vez: 0; | [0:00] First time on tile: 0; |
| |
| [0:05] Superou ladrilho: 0; | [0:05] Passed over tile: 0; |
| |
| [0:05] Entrou no ladrilho pela primeira vez: 1; | [0:05] First time on tile: 1; |
| |
| [0:11] Pontuação adicionada; | [0:11] Score added; |
| ↳ 15 Pts. (×1,00); | ↳ 15 pts. (×1.00); |
| ↳ 1 @ 1. | ↳ 1 @ 1. |
| </code> | </code> |
