Log File Management

After a number of experiments all sequence and session logs needs to be organized. This are done in four steps by the Log File Management tool. (Sequence Grabber, Version Update, Log File Extraction, Calculations) In Sequence Grabber a proper directory structure with relevant file names are set up. In Version Update the log files are updated to latest log file version. The Log File Extraction creates one log file for each event type represented in a session log file and inserts them in the directory structure. The Calculator makes calculations and inserts them as xml files in the directory structure.

Logfile Structure
Sequence Grabber
Version Update
Log File Extraction
Calculations
ProcessWindow



Logfile Structure

The logfiles are stored in the <C3FIRE-SESSION-LOGS> folder.
If you install C3Fire at C:\ then the <C3FIRE-SESSION-LOGS> folder are C:\C3LearningLabs\C3Fire\Server\SessionLogs\

Every session is stored in one folder with the name of the session.
The C3Fire server automatically creates unique names for all the sessions.
Example :

C:\C3LearningLabs\C3Fire\Server\SessionLogs\
    c3fire-1
    c3fire-2
    c3fire-5
    c3fire-6
    c3fire-8
    c3fire-15


From the beginning the logfile folder contains the logfile and the configuration files for that session.
Example : (Session name = c3fire-8)

C:\C3LearningLabs\C3Fire\Server\SessionLogs\c3fire-8\
    c3fire-8.log
    configuration-8.con
    map-8.gif
    scenario-8.sce


Rename

You can rename the session folder, but then you need to change the name of the files in the folder so that they have the same name pattern. The renaming can only be done if you are using C3Fire version 3.2.2 or higher.
Example : (If you want to rename the file 8 to Test)

C:\C3LearningLabs\C3Fire\Server\SessionLogs\c3fire-Test\
    c3fire-Test.log
    configuration-Test.con
    map-Test.gif
    scenario-Test.sce


Processing and Calculations

When you start some calculation or processing of a logfile you must have the folder structure intact. If you want to process the session with name 8 you should select the folder C:\C3LearningLabs\C3Fire\Server\SessionLogs\c3fire-8\

If you have run an experiment series than you should COPY all the session you want to process to experiment data folder. Example : If you have run nine sessions you can copy all of them to
C:\Experiemnt-Data\
    c3fire-1
    c3fire-2
    c3fire-5
    c3fire-6
    c3fire-8
    c3fire-15
    c3fire-16
    c3fire-17
    c3fire-18

If you want to process all the session in the experiment you should select the folder C:\Experiemnt-Data\



Sequence Grabber

When you have done a number of experiments it is difficult to organize the sequence and session logs. Sequence grabber helps you to organise those files.

The Sequence grabber focuses on one sequence log, it takes all session logs belonging to that sequence and stores them in a selected output directory. The Sequence grabber also rename the session log numbers from the numbers automatically given by the system, at the experiment time, to session number defined in the sequence definition.

Example 1 : When you are running session ' 5 ' in sequence ' A ', the C3Fire system sets the name for the session log by counting up the previously made session by one. This means that session ' 5 ' in sequence ' A ' may have session number 123 in the sessions log directory.
The sequence grabber then renames the session ' 123 ' to ' 5 ' and store the session in the output directory.
The output directory is selected in the Sequence grabber tool.


Example 2 : Before you run the Sequence Grabber you may have the following directories.
Sequence Logs directory that contains all the sequences ' A, B, C, D and E '.
Session Logs directory that contains all the sessions ' 80, 81, 82, ... 140 '.
Then you can run the sequence grabber for ' A ' and then for sequence ' B ' to ' E ', defining the output directory as C:/exp/set1/ with the new sequence names as ' A ... E '.

After you have runned the Sequence Grabber you will have the following directory structure:
C:/exp/set1/A/ : containing sessions '1, 2, 3, 4'
C:/exp/set1/B/ : containing sessions '1, 2, 3, 4'
...
C:/exp/set1/E/ : containing sessions '1, 2, 3, 4'


Usage

Step 1 Select the sequence you want to grab.
Example 'C:/c3fire/sequencelogs/A/'

The selectded sequence should be a directory containing a sequence file with the same name as the selected directory. For the example above there should exista a file namned A.seq, 'C:/c3fire/sequencelogs/A/A.seq'
Step 2 Select the directory where all the session log files are stored.
Example 'C:/c3fire/sessionlogs/'
Step 3 Select the output directory where you want to store the new sequence.
Example 'C:/exp/set1/'
Step 4 Select the new sequence name.
The new name must be unique. It should not exist in the output directory.
Example 'A'.
Step 5 Press the 'Grab Sessions' button.

Se picture below.

The grab sequence process information is viewed in the foot of the analysis window and in the process window. The process window is opened in the menu with selection; Window->Process_Window.



Figure 1. Example on a Sequence grabber user interface.





Version Update

In Version Update the log files are updated to latest log file version.
Logfiles with missing end are also fixed.


Usage


Step 1 Select the directory with all logfiles that you want to update.
The update are done recursively in every subdirectory.
Example 'C:/exp/set1/'
Step 2 Press the 'Update Log Files' button.



Figure 2. Example on a Log File update user interface.





Log File Extraction

The main session log file generated by the C3Fire system is one large file containing all types of events.
All events have an event number, which make them unique, and they are sorted after time and the event number. This makes it difficult to find the evaluation of a single event type.

The Log File Extraction generates a new log file for every event type in the main session log file. For more information about the event types chose Event Types in left menu. When the Log File Extractor finds a session log file it creates the directory structure /Measurements/LogFiles/ in the same directory as the session log file. The generated event type log files are stored in that created directory, /Measurements/LogFiles/ .

Information about the Event Types is found in left menu.


Usage


Step 1 Select the directory you want to have extracted.
Example 'C:/exp/set1/'
Step 2 Press the 'Extract Log Files' button.



Figure 2. Example on a Log File Extraction user interface.





Calculations

When a Log File Extraction has been done you can perform calculations on the event type log files.
The calculations are stored in the Measurement/Calculations/ directory, which was created when the Log File Extraction was done.

A fire calculation file example:
Fire.xml

Usage

Step 1 Select the directory you want to do calculations in.
Example 'C:/exp/set1/'
Step 2 Press the 'Calculate Fire' button.



Figure 3. Example on a Calculations user interface.