6. Log Browser

6.1. Database

The log database consist of a set of Labber log files organized in a special folder structure. When running a measurement, the program will save the configuration and data in a single file in the folder “<Database folder>/xxxx/yy/Data_yyzz”, where <Database folder> is the base database folder as set in the Preferences window (see Section PrefsFolder), xxxx is the current year (four digits), yy is the current month (two digits) and yyzz is the current month+day (total four digits). As an example, the database folder for logs created on January 29, 2014 would be “<Database folder>/2014/01/Data_0129”.

The user can add additional data like images, scripts or even subfolders to folders within the main database folder. The Log Browser and the Measurement programs will ignore any additional files when scanning for Labber log files.

6.2. Log browser dialog

The Log browser is used to browse through the measured data and give a quick overview of the individual log files. The Log Browser is started by from the system tray menu (“Show Log Browser”) or by selecting “Window/Show Log Browser” from the main Instrument Server window. When starting, the program will scan through the default database folder for log files.

_images/LogBrowserTrace.png

The Log Browser window.

Figure LogBrowser shows the main Log Browser window. The dialog consist of a tool bar at the top, with sections on the left showing the database structure, a list in the center with log files, and finally a graph and info controls on the right giving a preview of the selected log file. The function of the various controls are described below.

6.2.1. Database hierarchy view

The four fields Project, Tags, User and Date on the left-hand side of the Log Browser dialog give an overview of the database hierarchy and allow the user to limit the selection of logs visible in the main log list. The Project, Tags and Date entries can be expanded to reveal subfolder selection. The filtering process is exclusive, meaning that only log files that fulfill the constraints of all the four fields are shown in the log list. Selecting the “- All entries -” item in one of the controls will disable the filtering for that field. The Project, Tags, User and Date fields can be hidden from the View-menu in the main menubar.

6.2.2. Log list

The list in the center of the dialog shows the logs in the database that fulfill the constraints set by the hierarchy fields on the left. Logs that contain particularly important data can be starred, which will make them easier to spot in a large selection of logs. To star a log, either right-click the entry and select “Star” from the pop-up menu, or select a log and use the “Star”-button in the tool bar at the top of the window, or just press the space bar after a log has been selected.

The controls in the toolbar aboce the log list provide options for showing only starred log and for filtering logs by name. The log list can be sorted by Name, Creation date or Sweep dimensions by clicking the corresponding list header.

6.2.3. Graph / Log info

The graph in the top-right corner gives a quick preview of the contents of the selected log file. By default, the graph will show an image map if the data is two-dimensional in nature, and otherwise a line plot containing the first few entries in the log. The preview can be changed by creating a View in the Log Viewer, see Section Views for more information on Views. Below the graph, there are controls showing the Step sequence, the Log channels and the comment (if present) of the currently selected log.

6.2.4. Tool bar

The toolbar contains the following buttons:

Open Database:
Open another database than the default one used by the Measurement program. The dialog that opens should be pointed to the folder containing the Year-folders of the log database.
Reload Database:
Reload the current database and scan through all the log files. This is needed if log files have been manually added to the database folder.
Star:
Star/unstar the currently selected log.
Plot Traces:
This will open the currently selected log in the Log Viewer, see Section LogViewer for more information about the Log Viewer dialog.
Plot Image Map:
If the selected log contains 2-dimensional data, this button will open the data as an image plot in the Log Viewer.
Show config:
The button will show/hide an additional side bar with all the instrument configurations in the currently selected log. At the bottom of the sidebar, there will also be a checkbox “Show all quantities”; if checked, all instrument quantities and values are shown in the list, otherwise only the quantities present as channels in the Measurement configuration are displayed.