File Explorer - boschmotorsport/WinDarab GitHub Wiki
- File Explorer
The usability of WinDarab’s File Explorer is much the same way as Windows’ Windows Explorer.
File Explorer is used to manage all WinDarab supported files:
- WinDarab 7 files
- WinDarab 6 files
- WDServer Telemetry files
- Linked files
- MDF Files
- MSX files
Hint | In addition to access files on existing disk drives you access them through locations. A location in fact represents the affiliation of files with a specific drive and folder. Using locations simplifies access and management of files. See chapter Locations< |
- Open File Explorer Window if not opened.
- Choose “Windows → Dockable Windows → Files*” or press “F3” to open the File Explorer Window.
- Choose Open file in the File Explorer Window toolbar.
Choose WinDarab-Button/ Open measurement file in Darab ribbon
The File Explorer window is divided into:
- Open File dialog box
- File Inform window
The Open File dialog box allows you to browse through drives, folders, locations and select the file you want to open.
This area displays sub-folders and files contained in the selected folder.
To select an item you can either use your keyboard or your mouse. Whenever possible a preview of the selected file will be displayed.
If the selected file has a password protection act as shown in Open Password-protected Files.
Hints: | You can select more than one file by using the Ctrl- or Shift-key. Whatever action you have chosen (e.g. open or delete) will be performed for each file and in the selection order |
The combo box “Show Inform” allows you to choose whether the File Inform window to should be shown or not. | |
Folders can be created, renamed, and deleted in the Open File dialog box in the same way as regular windows folders in the Windows Explorer. |
-
Open the selected file(s) by pressing the “Open”-button. If there is more than one file selected, the files are opened as one file. You can also select “Open as single files” in the “Open”-button’s dropdown list to open all selected files as single files.
-
If you use the Shift-key while pressing the “Open” button, the “open linked files”-dialog appears. In this dialog you can change the order of the linked files, delete single files from the list or save the list as a predefined filegroup in the same folder as the used files are saved in. After that, you can open this exact filegroup by opening the generated filegroup-file.
File Info is divided to 3 groups:
- Comments
- Statusblock labels
- CardMemory Info
To select one item navigate with the arrows.
These enables you to view the following file information:
Comments | Configuration Tools | Display configuration tool information stored in the WinDarab file. |
Comment field | Display the vehicle settings. | |
Comment | Display the logger data specific comments. | |
Statusblock label | Statusblock label | Display the available status block label |
CardMemory Info | Logbook | Display memory card log book |
Measinfo | Display memory card measurement info | |
Sections | Display memory card sections |
You can save data in any folder and on any disk drive you choose. In addition it is possible to create locations. WinDarab defines the special folder Data file location as container for all locations. A location actually is a link to a specific folder which enables you to save files in, or open files from, different locations quickly – without having to navigate the entire drive and folder structure. |
Follow the steps below to add a folder to the Data file locations folder:
- Open the File Explorer
- Choose the folder you want to define as location.
- Click on the button:
- A link to the selected folder is generated and added to the Data file locations folder.
Hint: | A location can be deleted or renamed in the same way as regular windows link to a folder in the Windows Explorer. |
The File Explorer Window displays and manages all logger data files opened in the File Explorer (see Opening Files). WinDarab supports the following logger files:
- WinDarab 7 Files
- WinDarab 6 Files
- WDServer Telemetry Files
- Linked Files
- MDF Files
- MSX Files
Open File Explorer Window
Select Windows → Dockable windows → Files from Darab Ribbon to open the File Explorer Window.
The File Explorer Window is a dockable window. It contains a toolbar and a WinDarab file list window.
Opens the File Explorer (see File Explorer) | |
Close the selected file | |
Create an overlay to compare files/laps (see Overlay). Each overlay is displayed in a different color. | |
Zoom and compare fastest laps of each overlay. | |
Change the color of the selected overlay | |
Reduce the lap list. The "outing #"- line under the file name in the file list will not be displayed. |
The file list contains a list of all opened files in the File Explorer.
Under the file name the outing number is displayed. The laps are listed under the outing number. Each lap is indicated with a lap number and a lap time. The fastest lap is marked with the label Beschreibung: . If an overlay is assigned to a lap it is displayed by a colored point before the lap number.
Hint: | If the menu point "Reduce lap list" is selected the line "Outing #" will be hidden. |
After right-click on an item in the File Explorer window a context menu opens. The context menu contains the following options (some variations depending on file or lap is highlighted):
Open | Opens a new file. |
Append | Opens a new file and appends it to the selected lap. |
Replace | With this menu-item, you can replace the file by another file. After clicking on the item, the open-file-dialog opens, where you can select the file replacing the file in the file-explorer. |
Setupsheet | Open the setupsheet editor |
Out-Lap | Sets the "Outlap" flag on the selected lap |
In-Lap | Sets the "Inlap" flag on the selected lap |
Ignore as fastest Lap | Ignore the currently selected lap as "Fastest Lap" |
Renumber | Opens a sub-menu to provide options for renumbering laps (alters the lap-stack) This is useful with missed beacons or manually inserted |
Close | You can use the close menu item to close this file. |
Fastest laps | Zoom and compare fastest laps of each overlay. |
Reduce lap list | Reduce the lap list. The "outing #"- line under the file name in the file list will not be displayed. |
Overlay provides the possibility to compare laps/files and to add a lap/file to an oscilloscope (see chapter Oscilloscope). Overlays are displayed as points in different colors.
By default at least one overlay exists in the File Explorer Window. If you open a file in the File Explorer (see chapter File Explorer) the overlay is assigned to the fastest lap of the file.
Hint: | Click with the right mouse button on one overlay point or the overlay row to open the overlay context menu. |
Add | Add an overlay in the overlay list under the File Explorer window toolbar. If at least one file is opened in the File Explorer window the overlay is assigned to the next longer lasting lap without overlay in the first file of the list. If each lap has an assigned overlay already all subsequent overlays will be assigned to the longest lap in the first file. |
Show overlay | Globally hides this overlay and all associated channels |
Replace file | Replace the file of the selected overlay. The File Explorer is opened and allows you to select the new file. |
Detach file | Detach the file from the overlay. After this, the overlay has no file. |
Change color | A color palette is opened that allows you to select the color of the selected overlay. |
Overlay Coloring | Allow selected overlay to use the global selection for channel coloring or override it |
Delete | Select this menu point to delete the overlay. |
Pin lap | Pin this lap, scrolling the cursor will stop at the lap end. Can also be used to set a base file for referencing when looking at telemetry on another overlay |
Use as x-axis overlay | Select this option to use this overlay as base-overlay for the x-axis. |
Use as base for differences | Select this option to use this overlay as the base-overlay for difference-channels (comparing 2+ overlays). |
This function can be used to compare one (or more) overlays to a datum lap. This is useful for telemetry.
- Create an overlay
- Open the file containing your 'Datum' or 'Reference' lap
- Assign an overlay to the lap to be pinned (Datum/Reference) lap
- Right click on the orb → Select Pin Lap
- Assign the other overlays to your telemetry source, or files you would like to compare to the Pinned Lap
- The visualization of an overlay can be disabled (hidden) – while the file keeps opened and attached to the overlay.
- To hide an overlay use the overlay context menu in the file explorer. An overlay is shown again, if you select the same context menu item or – simly – by clicking into the overlay column to select a lap. Alternatively you can use the “Hide” context menu in the oscilloscope (“H” key).
- What happens, if an overlay is hidden:
- The oscilloscope hide all channel of hidden overlays
- The trackmap doesn’t show the position of the car.
- All analysis windows hide the evaluation results of hidden overlays (except LapAnalysis)
- As long as an overlay is hidden most calculations for the attached files are stopped/disabled.
Only “Event rules” and “LapAnalysis” are still evaluated.
Files can be opened by dragging them from your windows file system into the WinDarab FileExplorer. Depending on the location where you drop the file, the file can be added to the file-list, replace an other file or replace an overlay.
Adding a file | You can add a file to the file-list by dropping it anywhere on the list but an existing filename or overhead-column. Your files will be added to the list. If you add more than one file to the list, as default, they will be added as one file. To open more files as single files, press Ctrl while dropping the files. |
Adding a file to a Filegroup | You can add one or more files to a filegroup by dropping them over an existing file. When you drag the files over an existing file, the target is highlighted to show that you can add the files. |
Replacing a file | You can replace one or more files by dropping a file over an existing file while pressing the Shift-key. When you drag the files over an existing file, the target is highlighted to show that it can be replaced. |
Replacing an overlay | Dropping a file on an overlay-column adds the file to the file-list and assigns the columns overlay-color to the new added file. If this removes the last overlay from a file, this file will be removed. |
When a file is opened in the file explorer, the containing folder as well as all of his sub folders are monitored for new darab files. When a new darab file is created in a monitored folder, darab shows a balloon tip to let the user know that a new file was created.
In addition to this balloon tip, a region on the bottom side of the file explorer is created where all new files are listet.
You can open these files by dragging them into the file explorer (see Drag and Drop) or by using the contextmenu.
Hint: | The separator between the new files and the file explorer can be dragged to reduce the size of the region. You also can minimize/maximize the region with a double-click on the separator. |