Introduction

This Wiki Page provides instructions on how to set-up for and use the Validation Processor Python Script. First the preliminaries that need to be installed on your computer followed by script usage instructions.

Prerequisites:

Download and install the latest version of these packages for your OS.

Installation of Python 2.5

http://www.python.org/download/

For Win32, use 'Python 2.5.2 Windows installer'

Steps:

Install Python
Add Python Installation directory to System PATH variable.
Check Python Installation by typing python at the command prompt.

You should see something similar to the following output and will now be in the python shell.

C:\>python
Python 2.5.2 (r252:60911, Feb 21 2008, 13:11:45) [MSC v.1310 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>

Enter quit() and you should be back a the DOS command line.

Installation of PyX 0.10

http://pyx.sourceforge.net/

Steps:

Extract the PyX-0.10.tar.gz file and then in the DOS command prompt change to the PyX-0.10 directory.
Once in the PyX-0.10 directory, enter the following at the command prompt:

python setup.py install

To Test the installation of PyX, enter the following lines into the command prompt:

C:\Documents and Settings\username\Desktop\PyX-0.10>python
Python 2.5.2 (r252:60911, Feb 21 2008, 13:11:45) [MSC v.1310 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import pyx
>>> quit()

If you see something similar to this then pyx is installed and python can find it.

NOTE: You may need to prefix the command above with sudo if you are running this on Linux or OS X. See the INSTALL file in the PyX directory for more information.

Instructions for running Validation Processor Script:

NOTE: If you have not checked out the repository to your local computer, you will need to do this first. See the AccessingSubversionRepository Wiki page for instructions on how to check out a copy from the SVN repository.

To use the Validation Processing script, go to the Utilities\VnV_Processing directory within the FDS-SMV project directory on your local machine.

There are three files in this directory:

The Validation Configuration File: Validation_Data_Config_File.csv
The Verification Configuration File: Verification_Data_Config_File.csv
The Python Script: Validation_Data_Processor.py

At the top of the Python script there are lines that you can comment or uncomment to select the processing of Validation data or Verification data.

NOTE: You can only select one at a time to process. Uncommenting both will result in the second set to be used as it will be last to set the variables used later in the script.

To run the script, open a command line prompt and type: python Validation_Data_Processor.py

You will see many lines of output as the files are processed and the pdf plots are created. This process can take a few minutes, 10 to 15 minutes is normal.

Also, you may edit the configuration files as necessary to set the files that you want to process. This is optional, as the versions in the repository are setup to process all existing V&V data sets. This applies primarily to the lines in the configuration file that start with a d. The d lines are used to indicate the comparison data to be plotted, which are also used to generate the data in the scatter plots.