This is a help document for DSLOG Reader. The document is organized by tab (e.g. Log Files, Graph Info, etc..)
If your program has crashed or you found a bug please report it in the issues or DM on ChiefDelphi.
In order to increase performance in the Log Files Tab the information for logs. The cache is stored in the same directory as the logs.
The Log Files Tab shows all log files in the selected path (Default is C:\Users\Public\Documents\FRC\Log Files). Simply clicking on a item in the list will load the log.
The headers for the log list are as following
- Time: When the log started
- Seconds: Total seconds the log file is
- Match #: FMS event match number
- Time Ago: Time since log was written
- Event: FMS Event code (this value is guessed if not available, this guessing can be turned off in the settings)
- Name: File name
Logs that belong to FMS matches are bold and have the following color scheme:
- Green: Practice Match
- Yellow: Qualification Match
- Red: Elimination Match
- Blue: Match not specified (Usually a practice match)
Logs that are currently being written to (Live) will appear as Lime green
Because some logs from FMS matches do provide their event ID the reader can guess the event ID by finding the closest log that has an event ID. If you have logs from different events that happened near the same time this guessing will not work.
This tab lets to enable and disable graph series, view probing information, and export. This also controls what information will be displayed on the Competition Tab
To enable or disable what series gets shown on the graph click the checkbox. Groups can also be minimized and maximized.
To change what profile is selected (change the names of the PDP items) click the Profile selector. If the Default is the only profile available you need to make a new profile with the Profile Editor.
To open the Profile Editor click the cog icon In the Graph Info Tab. Once open, the default profile cannot edited so I new one must be made.
Creating a new profile can either be done by creating one from scratch by clicking the Add Profile button or from another profile by clicking the Copy Profile Button
The Profile can renamed with the Profile Name box
Click the Add Group button to add a new group to the profile.
To change the name of a group just click and wait a second until it becomes editable.
To move a PDP slot a different group just drag and drop the item into a different group.
The PDP Slot label will show what slot number a selected slot is when the name has been changed. To edit a PDP slot name select it and wait a second for it's name to become editable. To change the color of PDP slot select it and click the change color button.
To add a group total or group delta to a group select a group that has at least two PDP slots in it and check the box for "Total in Group" or "Delta in Group". The Total is the sum of all the PDP slots in the group, you must have. The Delta is the standard deviation of all the PDP slots in the group.
To remove a group select it and click the Remove Group button.
The Profiles are saved to where the executable is in a file called ".dslogprofiles"
Click the graph to get the information at the point(should see red line). It only shows the information that is enabled in the series selector.
The Energy tab shows how much energy each PDP slot has used throughout the log.
The Export tab has tree modes, the current mode depends on what tab you are in (Graph, Events, Competition).
In this mode the log can be exported to CSV, the clipboard, or Image. ** Note when you export to CSV or clipboard only the values in view will be exported not the whole log**
The events can only export as a CSV
The competition mode can only export as an Image
This tab shows the main graph the current log is graphed.
This is where the data from the dslog file is displayed
To probe the graph simply click on the spot you want to know the values, only the series enabled will show up in the probe tab
To zoom click and drag the area you want to see
If you hover over one of the event points on the graph you can see what the event is at the bottom of the Graph Info tab.
The numbers in parentheses are only for Total PDP and group totals not for regular PDP slots and group deltas
When the reader is streaming a log file the top bar will turn green, Autoscroll can also be turned on.
The button sets the X axis labels to be time from match start
The match time button only works with logs connected to FMS and that have an auto.
Resets zoom to view full log
Finds and zooms into match
When reader is streaming this button allows Autoscroll to be enabled (when zoomed in the graph stays to the right side)
This tab shows all of the events in the log that is loaded
The color of the DS Time column depends on what mode the robot is in when the event occurred (gray for disabled, blue teleop, green auto)
Double clicking an event item will switch to the Graph Tab and set the probe to be where the event is.
This tab only shows up if there is at least one log where the FMS is connected (bold in log file list).
To select an Event use the Event filter in the Log Files Tab
