myRoupeiro 〜 soccer match data logger and analyzer 〜 How to use
What is myRoupeiro?
“myRoupeiro” is a free app for supporting your video analysis of soccer matches.
- Recording who, when, where and how was involved in the event from the video of the match and visualize the match results
- Visualize various events such as shoots and passes in the game
- Visualized results can be viewed interactively
- The analysis results are saved in html files so you can view those on other devices or share them with your teammates
- The data is saved in the csv file and xml file, so you can separately process those as you like and use those
- You can record the data in detail, or you can roughly record only what you care about
- Also supports a half-size court, can be used for analysis of youth soccer
- Completely free app
This program was originally created by the operator of this site (me) to support video analysis of our team’s matches. myRoupeiro is an application version that anyone can use. (android app only)
Roupeiro (Portuguese) is an important behind-the-scenes support for a soccer team, meaning a soccer team’s equipment clerk.
After that, named the app as myRoupeiro, hoping that it would be a useful tool to support your team.
We hope you can use the data analyzed by myRoupeiro for your daily practice and the next game etc.
It’s like this
Visualize the events during the match
- Shots
- Goals
- Passes
- Freekicks etc.
Take a look at the team data
- Stats table
- Team event data
- Pass matrix
analyze individual data
- Individual event data
- Pass direction, distance, ratio of success / failure
- Heat map
- Event map
Follow the events during the match in chronological order
Data entry
record various events/results during the game with taps
Notes
- Not include a video player
- myRoupeiro is an application for recording and analyzing by paying attention to the player who played near the ball within the range that could be shot with a video camera.
Therefore, it is not compatible with analysis such as the movement of the ball itself, the off-the-ball movement of players, and tracking data throughout the game. - a device with a large screen size, such as a tablet is recommended
How to use
<Data recording>
Record who, when, where and how was involved in the ball (we will call it an “event” here).
Launch and exit the app
Launch | Just like launching a normal app, tap the icon to launch myRoupeiro |
exit | Just like exiting a normal app, tap the Android task button (□) to display the multitask screen, and swipe up myRoupeiro to exit. |
Note: myRoupeiro does not have an auto-save feature. We recommend that you save your data frequently.
Screen description
・Main screen
When you start the app, the main screen will be displayed. We can enter event data here.
Menu bar
Title | Enter the title of the data to be analyzed |
team settings | Moves to the team information input screen |
import files | Import existing data files |
get ext-files | Import the data file of myRoupeiro created on another terminal etc. so that it can be used on the terminal currently in use |
hide ads | You can hide all ads for a period of time by completing watching a short video ad |
manual | Go to the manual page (external page = this page) |
license | show the license |
privacy policy | Go to the privacy policy page (external page = another page of this blog) |
Note: When the screen width is narrow, the menu may be hidden in ≡.
Video time input ・ First half / second half selection ・ Kickoff time input
Video Time | ・Enter the displaied time (hours, minutes, seconds) of the video in which the event you want to record occurred *The up arrow to move forward one by one, the down arrow to go back one by one |
1st period / 2nd period | Select the first half period or the second half period (otherwise it is considered to be the first half) |
Kickoff | Enter the kick-off year (last two digits of the year), month, day, and hours: minutes |
Note: Since myRoupeiro assumes that we will record while watching the video, it is assumed that we use “video time”.
Player/Area
① | The name of my team / the name of the opponent team *These are set on the my team settings screen and opp team settings screen |
② | Enter the score of your team / opponent team *final result is OK |
③ | The player list of my team / opponent team *these are set on the my team settings screen / opp team settings screen *Select the players involved in the event from here *”Dest” is used to record the destination of the ball when there is no receiver for the ball |
④ | Area to specify where players were involved in the event on the pitch |
clear dots | Deselect a player and erase the points drawn where they were involved in the event |
change ends | Swap the ends of both teams |
pitch size | coat size *select normal size or half size from the drop-down list *If not selected, it will be considered as normal size *In the above figure, “Normal” cort size is already selected |
Before event
The state of the ball before the event
ball holder; ball holder before the event
oneself | oneself |
ally | my team players |
opp | opponent team players |
loose ball | Loose ball / no ball holder |
drop ball | drop ball |
None | Not applicable |
ball state; Ball height condition
grounder | Grounder |
low | ball in the air from pitch to head |
high | ball in the air above the head |
Event
Event selection tab; type of event (9 types)
PASS | Events related to the passes |
SHOT | Ebents related to the Shots |
RECOVERY | Events related to ball recovery and clearance, etc. |
FAULT RECEIVED | events related to received fouls |
SET PIECE | Set pieces, throw-ins, kick-offs, etc. |
BALL OUT | Events which led to out of play |
CARD | Cards |
CHALLENGE | Challenging plays such as pressing, tackles, duels and dribbles |
CARRY | Dribbles (just for carrying the ball), traps or ball-keepings |
Event content selection button; Buttons for selecting event contents
attempt | Subcategory of event types (what was attempt to) |
result1 | Success and failure (good / bad failure) |
result2 | Content of the result (if applicable) |
pressure state | pressure state on the event |
body parts | Body parts involved in |
Direct/Indirect | Direct play or not |
ball state after | Ball height after the event |
next play | Next play after the event |
next holder | Next ball holder after the event |
Other buttons / areas
add event button | Add the event data to the data table |
︿ button | Clear the player selections and event points then move to the top of the screen |
Notification area | Message display area |
stretch list | Expand and display the data table |
delete selected row | Delete the selected row of data table |
Analyze! | Run analysis of the data |
Data table | Table for added events |
Note; You can see the data content in a popup by long-tapping the data row
my team setting screen
A setting screen for my team; my team name, uniform numbers, player names and positions.
Menu bar
opp team settings | Move to the opp team setting screen to input opponent team information |
Player information input area (up to 24 players)
# | Shirts number |
name | Player name |
posi | Position (select from dropdown list) |
Player display area
Player display area | Starting members / substitutions |
Note;
・ Double-tap the player icon to move the input cursor to the player information input area
・ Player positions and formation are not used for analysis, therefore not so important
opp team setting screen
A setting screen for opponent team; opponent team name, uniform numbers, player names, and positions.
Menu bar
back to main | Back to the main screen |
Other elements are the same as the my team setting screen
How to record events
record with taps who, when, where and how was involved in the event from the video of the match
If you tap again on the selected button, the selection will be canceled.
1 | Enter the match title, kickoff time, score and pitch size |
2 | Enter the team name and player information on the my team and opp team setting screen to return to the main screen |
3 | Watching the video of the match, enter the time when the event occurred in Video Time |
4 | Select first half period / second half period |
5 | Select the player(s) involved in the event and tap the position in the pitch area If there is a receiver of the ball (at the pass event etc.), select the receiver and tap the position where the ball was received (If there is no receiver of the ball due to failure etc., use “dest” instead of the player and tap the position the ball was destined) *the ball passer always comes first to be inputed, the receiver comes next. *clear dots button can be used to reset the player selections and the dots on the pitch area |
6 | Select the ball holder and ball height before the event from Before event |
7 | Select the event type from the Event Selection tab |
8 | Select the each content from attempt to next holder *If there is no applicable one, leave it as it is |
9 | Press the add event button to add the event data to the data table |
10 | Repeat 3 to 9 *contents can be selected in any order |
Note;
If the events occuered at the same time, for example, if an interception event of the opponent’s ball led to a pass event immidiatey, it is better to treat and record those separately for two events, “recovery / intercept” and “pass”, respectively.
correction of event data
1 | Double-tap the row in the data table row you want to modify, you will be able to edit the event data. The text of “add event” will change to “finish edit” |
2 | When you have finished editing the event data, press the finish edit button to finish editing. |
Note; If you long-tap a row of the data table, you can see the content of that row in a popup. To turn off the pop-up, tap anywhere on the screen.
Deletion of event data
1 | In the data table, tap a row(rows) to select for which you want to delete |
2 | tap delete selected row button |
Note; Deletion is irreversible, so be careful
Save data
Save the data.
1 | Tap save data on the menu bar |
2 | Enter file names and tap the save button |
3 | .xml and .csv files will be generated. |
.xml file | this file stores match information and player information |
.csv file | this file stores event data |
Note:
・myRoupeiro does not have an auto-save feature. Saving your data frequently is recommended.
・The data is saved in the “Download” folder.
Import data
Import data files (.xml file, .csv file) generated by myRoupeiro
1 | Tap import data on the menu bar |
2 | Select the .xml and .csv files to load and tap the load button *You can also load files one by one |
Loading external data
The myRoupeiro data created on other devices cannot be read as they are.
Therefore make those file readable for myRoupeiro on your using device.
1 | Tap get ext-files on the menu bar |
2 | Select the .xml and .csv files (or one of them) created on other devices and tap the load button |
3 | readable files for myRoupeiro on your using device are generated with “fetched-” added to the beginning of the file name. |
4 | The generated files can be read from import data in the menu bar |
<Data analysis>
Run analysis
Tap the Analyze! button to run the analysis then go to the Match Results screen.
Match Results screen
From this screen, you can show the results of each analysis.
Event Data | Event data analysis result |
Team Data | Team data analysis results |
Individual Data | Individual data analysis results |
Time Series of Events | Time series of the events with positions where the event occurred |
Note:
・Analysis results are saved in html files (data are saved in the “Downloads” folder), so you can check them on other devices with a browser and share them with your team.
<Event Data>
Data name | description |
Shots | Shots |
Goals | Events directly linked to the goal |
Corners | Corner kicks and the next events |
Freekicks | Free kicks and next events |
Challenges | Press (including loose ones), duels, tackles and challenging dribbles |
Recoveries | Pass interceptions, ball recoveries, etc. |
Turnovers | switching between offense and defense For example, a pass was intercepted and the offense and defense changed, and so on |
Shot Assists | Event that assisted shots |
Assists | Event that assisted goals |
Passes | Positions of successful passers and receivers. The arrow indicates the direction of movement of the ball |
Passers | passers positions of successful passes |
Receivers | receivers positions of successful passes |
Pop-up
You can see the details in a popup when you mouse over the marker.
Example; Shots
row | expression in pop-up | description |
1 | (-23.32, -2.04) | X-coordinate and y-coordinate with the center mark as the origin (0, 0) (approximate x-axis distance and y-axis distance (meters) from the origin) |
2 | Time 52ʼ25” | Video display time (does not match the elapsed time of the match) |
3 | sane (no.10 Byern) | Player name (number team name) |
4 | oneself | Ball holder before the event |
5 | grounder | Ball height before the event |
6 | SHOT | Event type |
7 | Success | Success or failure of the event (result1) |
8 | GOAL | Event result (result2) |
9 | loose press | Pressure status received at the time of the event (Other examples; yourself_on_partner) |
10 | foot L | Part played |
11 | INDIRECT | Whether it is direct play |
12 | ON TARGET | Whether it flew to the frame |
13 | long | The flight distance of the ball after the event. long is about 30m above |
14 | high | Ball height after the event (high; above the head) |
15 | KICK OFF | Next play after the event (if goal event, next play is kick off) |
<Team Data>
Stats table
Item | Description |
GOAL | Goals |
BALL POSSESSION | Ball retention rate (%) *estimated from my team’s ball retention time |
SHOTS(On target) | Number of shots *Including attempt of shots not touching the ball (result2; close to touch) *Number of shots on target in parentheses |
PASSES(Success) | Number of successful passes. Success rate (%) in parentheses |
DUEL GROUND(Won) | The number of duel wins that are not aerial. Win rate (%) in parentheses |
DUEL AERIAL(Won) | The number of duel wins in aerial. Win rate (%) in parentheses |
CORNERS | Number of corner kicks |
PENALTIES | Number of penalty kicks |
CARDS | Number of cards issued |
Tree Map
Tree map summarizes all the events.
- It is displayed separately in the first half and the second half.
- There, the results sorted by event type are nested.
- In addition, individual results are nested within each event.
- The larger the area, the higher the number of events counted.
- You can see the breakdown by tapping the nested part
- Other breakdowns
- Success / Good Failure / Bad Failure
- Pressure condition (free / loose press / 1 on 1 / 1 on many / many on 1)
- Body parts
- Direct play/Indirect play
- Ball direction
- Ball distance (short / middle / long) etc.
*You can also see the number of times the event was counted.
*Please ignore “None”
- Other breakdowns
Pass Matrix
A matrix table showing the passers and receivers of successful passes
*Vertical axis; passers / Horizontal axis; receivers
*The intensity of red is proportional to the number of passes
<Individual Data>
Individual data analysis results
Event tree map | Events involving individuals and their breakdown *You can see the details by tapping |
Pass direction/distance | Breakdown of all passes ・direction ・distance ・number of passes ・success / failure ratio in that direction *Regardless of the direction of the player’s body, the opponent’s goal line side is always on the top and the own goal line side is on the bottom *From the inside of the circle ・ Short pass (approximately up to about 15m) ・ Middle pass (approximately from 15m to 30m) ・ Long pass (approximately 30m over) *Color intensities are proportional to the number of passes |
Heat map | Player’s positon and how many times involved in events *The first half data and the second half data are shown so that the attack directions are the same. |
Event map | Position of event and type *The first half data and the second half data are shown so that the attack directions are the same. *You can turn points on / off by clicking the legend below. |
<Time Series of Events>
You can check the events in chronological order along with the position of the event with animation.
The colors of the dots indicate the ball holder just before the event (based on the ball holder selected on the Before event).
●; my team’s ball
●; loose ball
●; opponent team’s ball
<Event definition / description>
*You can reinterpret and redefine these to make it easier to use according to your situation.
PASS; passes
Major classification | description |
normal | nomal passed |
CROSS | cross |
THROUGH BALL | through ball |
DEEP BALL | Highball aimed at the back of the defense |
Kick(GK) | Passes by GK kick after catching the ball |
Throw(GK) | Passes by GK throw after catching the ball |
VOLUNTARY | Returned the ball Intentionally to the opposite team |
Subcategory | Description |
OFFSIDE | Be offside |
CLEARANCE | be cleared |
assist | Assist |
Loose ball | Led to a loose ball |
SAVED | Saved or caught the ball by the keeper |
Mistake(opp) | The quality of the pass was low, but it worked for some reason due to the mistake of the other party |
Pass to opps | Passed to the opponent team |
Aiming space | Feed the ball as aiming a space |
miskick | Miskick / pass miss |
OUT | Led to out of play |
INTERCEPTION | Be intercepted |
BLOCKED | Blocked |
REFEREE HIT | Hit the referee |
SHOT; shots
Major classification | Description |
GOAL | Goal |
BLOCKED | Blocked |
SAVED | Saved or caught by a goalkeeper |
WOODWORK | Hit the goal frame |
OUT | Out of the frame and goes to out of play |
Close to touch | Not able to touch the ball to shot (counted as a shot here) |
REFEREE HIT | Hit the referee |
Direction | Description |
ON TARGET | Shot on goal |
OFF TARGET | Shot out of goal |
Recovery; Ball recofery
Major classification | Description |
CLEARANCE | Cleared |
INTERCEPTION | Intercepted |
Ball recovery | Loose ball / second ball recovery or intentional play |
BLOCKED | Blocked shot / cross |
Course block | Protect the ball by blocking the opponent’s direction |
Catch(GK) | GK caught the ball (when own team was defensive) |
REFEREE HIT | Hit the referee |
FAULT RECEIVED; Received faults
Major classification | Description |
Get FK | Got a free kick |
ADVANTAGE | Advantage applied |
PENALTY | Got a penalty kick |
BALL OUT; led to out of play
Major classification | Description |
CLEARANCE | Cleared and made it out of play |
VOLUNTARY | made it out of play Intentionally to stop play |
FORCED | Stop play by referee |
END HALF | End of first half / second half period |
REFEREE HIT | Hit the referee |
Mistouch | Failed ball control and led to out of play |
HAND BALL | Hand ball |
SET PIECE; Set pieces
Major classification | Description |
GOAL KICK | Goal kicks |
FREE KICK | Free kicks |
FREE KICK SHOT | Free kicks with intention to shot |
CORNER KICK | Corner kicks |
THROW IN | Throw-in |
KICK OFF | kick offs |
RETAKEN | Retaken a set piece |
Subcategory | Description |
BLOCKED | Blocked |
CLEARANCE | Be cleared |
assist | Assist |
GOAL | Goal |
SAVED | Saved or caught by a goalkeeper |
WOODWORK | Hit the frame |
OUT | Out of play as it is outside the frame |
Aiming space | Feed the ball as aiming a space |
Own goal | Scored with own goal |
Direction | Description |
ON TARGET | Shot on goal |
OFF TARGET | Shot out of goal |
CHALLENGE; Challenging plays
Major classification | Description |
pressing | Pressing (can be any kind of presses) |
TACKLE | Tackle s |
DRIBBLE | Dribble (challenging) |
GROUND | Ground duels |
AERIAL | Aerial duels |
Subcategory | Description |
FAULT | Fouls |
ADVANTAGE | Applied advantage |
PENALTY | Give a penalty kick |
THEFT | Stolen the ball |
WON | Won a dual |
LOST | Lost a duel |
Just for reference;
We record as “Success” for pressing with a noticeable good effect, “Bad failure” for pressing with a noticeable adverse effect, and “Good failure” for others.
CARRY; Carry/controll the ball
Major classification | Description |
DRIBBLE | Dribble(not challenging, just carrying) |
Trap | Trap the ball |
keep | Keep the ball |
Subcategory | Description |
Ball out | Led to out of play |
CLEARANCE | Be cleared |
THEFT | Stolen the ball |
FAULT | Fouls |
Loose ball | Led to a loose ball |
Others
Category | Expression | Description |
Event result | Success | event successful |
Bad Failure | unsuccessful due to “no good” play or poor quality | |
Good Failure | Intentional and relatively good quality but unsuccessful | |
Pressure condition | Free | Free |
Loose press | Loose pressure | |
1_on_1 | One-on-one or similar stuation | |
1_on_many | One-on-many or similar situation | |
many_on_1 | Many-on-one or similar stuation | |
Opp_free | Let your opponent play for free (when your team is on the defensive side) | |
Body parts | Foot R/Foot L/foot either | Right foot / left foot / both or unknown |
HEAD | Head | |
Body | Body | |
both hands | Both hands | |
hand R | Right hand | |
hand L | Left hand | |
Direct play | DIRECT/INDIRECT | Direct/indirect play |
Distance | short/middle/long | 〜15m/15〜30m/30m〜 (approximately) |
Ball height | grounder/low/high | Grounder / ground to head / above head |
Next play | inplay | inplay |
THROW IN | throw in | |
GOAL KICK | goal kick | |
CORNER KICK | corner kick | |
FREE KICK | free kick | |
drop ball | drop ball | |
PENALTY | Penalty kick | |
KICK OFF | kick off (as the next play after the goal) | |
lost score | lost srore | |
Next ball holder | my ball/opp ball | my team’s ball/opponent team’s ball |
loose ball | loose ball (i.e. no body) | |
referee | referee | |
Ball condition before the event | grounder/low/high | Grounder / ground to head / above head |
イベント前ボール保持者 ball holder before the event | oneself | oneself |
ally | my team | |
opp | opponent team | |
loose ball | loose ball | |
drop ball | drop ball |