versus - cosmo modelfor versus system the second level is associated to the php code and the third...

P50596/DSAMTA-1982-09/00 Rome, 28.07.2009

Authors: Filodea Pastorelli, Stefania Pappagallo

VERSUS Technical Manual

VERSUS – Technical Manual of 55

Elsag Datamat spa Copyright

INDEX

Technical Manual .................................................................................................................................................... 1

1 ARCHITECTURAL DESIGN .................................................................................................................................... 5

2 RDBMS .................................................................................................................................................................. 5

3 VERSUS FRONT-END ........................................................................................................................................... 6

4 STANDARD AND CONDITIONAL VERIFICATIONS ................................................................................................ 7

4.1 The R environment .......................................................................................................................................... 7

4.2 Index generation .............................................................................................................................................. 7

4.3 Graphics generation ......................................................................................................................................... 8

5 WEB GUI .............................................................................................................................................................. 13

5.1 Web GUI and Mysql database ........................................................................................................................ 17

6 ANNEX : SOFTWARE INSTALLATION ................................................................................................................ 25

6.1 Installation Requirements ............................................................................................................................... 25

6.2 Installation Steps ........................................................................................................................................... 26

6.3 Directory organization .................................................................................................................................... 31

7 ANNEX : DATABASE ........................................................................................................................................... 32

8 ANNEX : TABLES OF DATABASE ....................................................................................................................... 33

9 ANNEX : CLASSES ............................................................................................................................................. 46

10 ANNEX : WEB FILES ........................................................................................................................................... 47



INDEX OF TABLES

Table 1. Types of operator ....................................................................................................................... 15

Table 2. Menu with Versus functions ........................................................................................................ 16

Table 3. Menu and functions for each type of user ................................................................................... 17

Table 4. Mysql tables manage data Versus system .................................................................................. 19

Table 5. Mysql tables manage verifications Versus system....................................................................... 20

Table 6. Mysql tables manage all items necessari to creation of verification in Versus system .................. 20

Table 7. Mysql tables manage conditional verification Versus system ....................................................... 20

Table 8. Mysql tables manage plots associated to score .......................................................................... 21

Table 9. Mysql tables manage plots associated to cross model graphics .................................................. 22

Table 10. Mysql tables manage plots associated to monthly graphics ....................................................... 22

Table 11. Mysql tables manage plots associated to time series graphics .................................................. 23

Table 12. Mysql tables manage plots associated to daily cycle graphics ................................................... 23



INDEX OF FIGURES

Figure 1. Architectural design ..................................................................................................................... 5

Figure 2. Standard and conditional verification graphics for continuous scores related to surface data ........ 8

Figure 3. Standard and conditional verification graphics for continuous scores related to upper air data. .... 9

Figure 4. Standard and conditional verification graphics for dicotomic scores related to surface data. ....... 10

Figure 5. Cross Model graphics, useful for scores model comparison. ...................................................... 11

Figure 6. Time Series graphics, useful for observation and forecast comparison during a month. ............. 11

Figure 7. Monthly graphics, useful for getting the trend of a scores during a month. ................................. 12

Figure 8. Template defined by Master.php ............................................................................................... 13

Figure 9. Web gui for Versus home page. ................................................................................................ 14

Figure 10. Web gui for Versus after login.................................................................................................. 16

Figure 11 DB MODEL .............................................................................................................................. 32



1 ARCHITECTURAL DESIGN

Versus system, debated in consortium COSMO, is a flexible and configurable tool that verifies the trends of the mathematics models in wether forecasting by means of a set of statistical scores. VERSUS consisting of following modules:

An RDBMS (MySQL) for: o hosting of data that has to be verified observation (synop and temp data) versus forecast (in grib

format) o configuration data for verification o managing the verification results (Verification results, Scorse and images)

Loader Front end for loading of data into DB Scores Front End for:

o scores computation, by means of R o graphical production, by means of jpgraph o storing the numeric and graphical resuls into DB

A Web-GUI for man machine interface

Figure 1. Architectural design

2 RDBMS

In “ANNEX : Database” there is the VERSUS DB MODEL while in “ANNEX : TABLES OF DATABASE” you can find the versus DB tables.



3 VERSUS FRONT-END

VERSUS system implements two kinds of front end:

Loader Front-End, for storing observations and forecasst into DB

Scores Front-End, for computing numerical and graphical scores defined as monthly or seasonal.

Loader Front end is responsible for loading of data according some configuration such as: The kind of FE that depends on the format of data: grib,bufr, ascii The stratifications of the stations The method of searching of the points: nearest, best nearest, the list of points that are included into a

circle of ray R The parameter altitude correction

Actually, data that VESUS system ingests are: Synop in bufr format that are loaded into surface_data table Temp in bufr format that are loaded into upperair_data table Gridded data in grib format that are loaded into grib table

Score Front end is responsible for scores computing and graphics generation on the base of DB data presence. This FE is activated once a day, it checks if there are scores to be executed and if related data (forecast and observation ) are loaded into DB, then compute the numerical scores and after the related graphical, seasonable configured into DB.

By means of WEB GUI is possible to configure, start up and shut down the front-end.

Technical documentation can be found in ANNEX C.



4 STANDARD AND CONDITIONAL VERIFICATIONS

4.1 The R environment

Standard and conditional verifications are carried out by means of R project.

R is a free software environment for statistical computing.

R is an integrated suite of software facilities for data manipulation, calculation and graphical display. Among other things it has:

an effective data handling and storage facility, a suite of operators for calculations on arrays, in particular matrices, a large, coherent, integrated collection of intermediate tools for data analysis, graphical facilities for data analysis and display either directly at the computer or on hardcopy, and a well developed, simple and effective programming language (called `S') which includes

conditionals, loops, user defined recursive functions and input and output facilities. (Indeed most of the system supplied functions are themselves written in the S language.)

4.2 Index generation

Herein are listed the R modules for scores generation:

surfaceScore.R: This module calculates the continuous scores related to the surface data. The structured followed approach is:

Retrieving from VERSUS DB of list of criteria that belong to surface continuous scores category. Getting the list of criteria that has to be carried out.

Retrieving from VERSUS DB the list of the station related to the stratification specified into criteria Getting from DB the forecast and synop observation list according to the ties previously configured

into criteria Retrieving from VERSUS DB the list of the indexes related to the select criteria Computing of scores on data retrieved Computing the suspect observation if required, and insert them into VERSUS DB Ingestion of scores and their classification into VERSUS DB

upperairScore.R: This module calculates the continuous scores related to the upper air data. The structured followed approach is:

Retrieving from VERSUS DB of list of criteria that belong to upper air continuous scores category. Getting the list of criteria that has to be carried out.

Retrieving from VERSUS DB the list of the station related to the stratification specified into criteria Getting from DB the forecast and temp observation list according to the ties previously configured

into criteria, taking into account the levels Retrieving from VERSUS DB the list of the indexes related to the select criteria Computing of scores on data retrieved on the base of levels Computing the suspect observation if required, and insert them into VERSUS DB Ingestion of scores and their classification into VERSUS DB

dicotomicScore.R: This module calculates the dichotomy scores related to the surface data. The structured followed approach is:

Retrieving from VERSUS DB of list of criteria that belong to surface dichotomy scores category. Getting the list of criteria that has to be carried out.

Retrieving from VERSUS DB the list of the station related to the stratification specified into criteria Getting from DB the forecast and synop observation list according to the ties previously configured

into criteria. Adjusting the cumulated fields either on observation or forecast Retrieving from VERSUS DB the list of the indexes related to the select criteria Retrieving from VERSUS DB the list of thresholds related to the criteria Computing of contingency table on the base of thresholds selected



Scores computing Computing the suspect observation if required, and insert them into VERSUS DB Ingestion of scores and their classification into VERSUS DB

surfaceConditionalScore.R: This module calculates the scores for conditional verifications related to the surface data. The approach is analogous to surfaceScore.R except that forecast and observation are retrieved on the base of conditions defined on criteria.

dicotomicConditionalScore.R: This module calculates the dichotomy scores for conditional verification related to the surface data. The approach is analogous to dicotomicScore.R except that forecast and observation are retrieved on the base of conditions defined on criteria.

4.3 Graphics generation

After scores computing a lots of graphics are generated by meas of jpGraph library that is a Object-Oriented Graph creating library for PHP >= 4.3.

Herein are listed the graphic categories that VERSUS is able to produce.

Figure 2. Standard and conditional verification graphics for continuous scores related to surface data



Figure 3. Standard and conditional verification graphics for continuous scores related to upper air data.



Figure 4. Standard and conditional verification graphics for dicotomic scores related to surface data.



Figure 5. Cross Model graphics, useful for scores model comparison.

Figure 6. Time Series graphics, useful for observation and forecast comparison during a month.



Figure 7. Monthly graphics, useful for getting the trend of a scores during a month.



5 WEB GUI

Versus is a complex system composed also by a Web GUI. Usually a system with a web GUI has a complex technical model composed by a first level associated to web gui (web browser), a second level associated to the application core (server side code), a third level associated to the database.

For Versus system the second level is associated to the PHP code and the third level to the Mysql database.

Web GUI for Versus is composed by different areas. For the free area it is not necessary the login, it is on the left and has Glossary and Tutorial, while for the others functions it is necessary to login.

Each web page has a template ‘Master.php’ which has the common layout for the web site. Below it is possible to view the web page organization using the template defined by ‘Master.php’.

Figure 8. Template defined by Master.php

All web pages are shown into the central area using the technique of server buffer .

In order to utilize all the features of this system, JavaScript must be enabled in your browser. Please follow the instructions below to activate JavaScript on your computer.

Internet Explorer 7.0 and above

Go to Tools > Internet Options > click on the Security tab

Click on the Custom Level button and scroll towards the bottom of the list

Make sure Active Scripting is enabled

Save the settings and refresh the page

Mozilla Firefox 3.0 and above

Go to Tools > Options > click on the Content tab

Check the box, Enable JavaScript

Save the settings and refresh the page



It is necessary enable pop-ups from Versus address.

Firefox Go to the Edit->Preferences menu and choose the Content icon at the top of the dialog. If "Block pop-up windows" is checked, add www.nanohub.org to the Exceptions list. Firefox also uses plugins to filter pop-ups. The most common plugin is NoScript. To enable a pop-up for a particular page, select the highlighted "S" icon at the bottom of the browser to instruct NoScript to allow the pop-up.

Internet Explorer Go to Tools->Internet Options menu. Click on the Privacy tab. Uncheck the field 'Block pop-ups' ('Turn on Pop-up Blocker' in IE 7.x). This will unblock pop-ups from all sites. To only allow pop-ups from nanoHUB, check 'Block pop-ups' and click on Settings. Enter nanohub.org in the field 'Address of Web site to allow:' and click Add. Close all windows.

The Gui is optimized for 1280x1024 resolution with last versions of Internet Explorer (7.x) and Mozilla Firefox (3.x).

Figure 9. Web gui for Versus home page.

After the login operation, Versus system shows on the right side all menu to manage standard and conditional verifications. All menu on the right side are relative to the type of current operator .

At the moment Versus has different type of operators:

Name

Description

Administrator The administrator can do everything, so he can also create and delete other users.



Operator The operator can do a subset of functions

Consultant The consultant can only see the graphical results associated to the verifications created and executed by operator and administrator.

Table 1. Types of operator

Menu

Description

User Administration To manage Versus users.

Process Administration To manage Front Ends.

Log Administration To manage log files.

Standard Verification To manage standard verifications.

Conditional Verification To manage conditional verifications.

Stratification To manage all stratifications of stations.

COSI To manages the COSI index

Run To manage all runs (0,12,etc…).

Station To manage all stations.

Index To manage continuous and dicotomic index

Forecast Method To manage all methods for verifications.

Forecast Model To manage all models.

Parameter To manage all parameters.

Subspect Observation To manage all suspect values relative to observation values

Data Report To manage data download.

Standard Report To manage all index plots associated to the standard verifications.

Conditional Report To manage all index plots associated to the conditional verifications.

COSI Report To manages COSI report

Time Series To manage all plots associated to the time series.

Daily Cycle To manage all plots associated to the daily cycle.

Cross Model Graphic To manage all cross model plots.

Monthly Graphic To manage all monthly plots.



Table 2. Menu with Versus functions

Figure 10. Web gui for Versus after login

MENU ADMINISTRATOR OPERATOR CONSULTANT

Process Administration X

User Administration X

Log Administration X

Standard Verification X X

Conditional Verification X X

Time Series X X

Daily Cycle X X

Stratification X X

COSI X X

Station X X

Index X X

Run X X

Forecast Method X

Forecast Model X

Parameter X



Suspect Value X

Data Report X X1 X2

Standard Report X X3

Show X X Periodical Run X X

Conditional Report X3

Show X X Periodical Run X X

COSI Report X X Time Series Report X X X3

Daily Cycle Report X X X3

Cross Model Graphic X X X3

Show X X Registration X X

Monthly Graphic X X X3

Show X X Registration X X

Table 3. Menu and functions for each type of user

5.1 Web GUI and Mysql database

1 The Operator cannot delete data. 2 The Consultant cannot delete data. 3 The Consultant can only view and download graphic 3



Versus uses a Mysql database called ‘versus’. All web pages are dynamic pages created by PHP code that uses a database connection to execute all queries.

Example PHP code:

//create a connection

$con = mysql_connect(HOST, MYSQL_USER, MYSQL_PASSWORD);

//select the database to do the query

mysql_select_db(MYSQL_DBNAME);

//define and execute the query

$sql_query = "SELECT * FROM XXXX";

$res_criteria = mysql_query($sql_query)

If ($msg_errno == 0) {

while ($riga = mysql_fetch_array($res_criteria , MYSQL_BOTH)) {

$var1 = $riga[field_name];

…

}

} else {

print "[Message: DB Select error :$query . N°: ".mysql_errno()."]";

}

//close the connection

mysql_close($con);

Below it is shown how VERSUS web gui uses the mysql database for each its function.

5.1.1 Process Management

Versus manages starting and stopping of the acquisition and stopping process (see VERSUS Front-End)



5.1.2 Data Report

Versus manages the downloading and the control of Forecast and Observation data.

Mysql Tables

Description

grib To manage forecast data

surface_data To manage observation for surface data

upperair_data To manage observation for upper air data

cuspect_value To manage the observation value that can be caused by an observation error

Table 4. Mysql tables manage data Versus system

5.1.3 Standard and Conditional Verification

Versus creates verification on data, so it is necessary to define all fields used to create a verification (standard or conditional). Versus manages standard and conditional verifications.

To create a verification it is necessary to define

a description

a typology of frequency (monthly 1, seasonal 3, data fixed 2)

a run

a stratification (a set of stations)

a parameter for Observations

a parameter, a model, a method and a grid for Forecasts

a set of index to check for the verification

Mysql Tables

Description

select_criteria To manage the conditional and standard verifications

select_criteria_has_v_index To manage the link between conditional and standard verifications with index information

select_criteria_has_method To manage the link between conditional and standard verifications with method information



log_score To manage log associated to verification

Table 5. Mysql tables manage verifications Versus system

For information like stratification, parameter OBS and FCS, index, method, run, Versus uses a lot of database tables

Mysql Tables

Description

run To manage all runs used by Versus

stratification To manage stratifications

station To manage all stations to use to define a stratification

v_index To manage all indexes used by Versus verification

fcs_parameter To manage all parameter for forecast

grid To manage all grids used for forecast

model_process To manage all models used for forecast

registered_grib To associate fcs_parameter, grid and model

obs_parameter To manage all parameters for observation

suspect_obs To manage all suspect values caused by an observation error

Table 6. Mysql tables manage all items necessari to creation of verification in Versus system

To manage each table (insert, update and delete records) the user can use the web gui (web pages) and the menu on the right side.

For standard verifications the system uses a special field into select_criteria table with criteria_type = 0,1,2

for standard verification on surface data and continuous index

for standard verification on surface data and dicotomic index

for standard verification on upper air data.

For conditional verifications the system uses a special field into select_criteria table with criteria_type = 3. For conditional verifications Versus uses also

Mysql Tables

Description

conditional_verification To manage all information associated to the conditions

Table 7. Mysql tables manage conditional verification Versus system



To plot index associated to all verifications it is necessary to configure the graphic so it is necessary define

path and file name to create

all colors and styles to use during plotting

Versus inserts all information to create the plot into ‘graphical_formula’ table with the field ‘id_graphical_formula_type’=2,3.

2: for plot with continuous index or dicotomic index by thresholds

3: for plot with dicotomic index by steps

Mysql Tables

Description

graphical_formula For general information

associated to the plot.

Title, path, format, range

graphical_formula_has_select_criteria_index For information associated to each line to plot.

Each line is associated to a verification and a index to plot

graphical_output For information associated to PNG file

Table 8. Mysql tables manage plots associated to score

5.1.4 Cross Model

With Versus it is possible to create cross model graphics.

User has to choose at least two verifications relative to a data range and some indexes.

Versus insert all information to create the cross model plot into ‘graphical_formula’ table with the field ‘id_graphical_formula_type’=1,4,5.

1: for cross model with continuous index

4: for cross model with dicotomic index by steps

5: for cross model with dicotomic index by thresholds

All other information to customize the plot are into ‘graphical_formula_has_select_criteria’.

Mysql Tables

Description

graphical_formula For general information associated to the plot.


graphical_formula_has_select_criteria For information associated to each line to plot.



Each line is associated to a verification and a index to plot


Table 9. Mysql tables manage plots associated to cross model graphics

5.1.5 Monthly Graphics

With Versus it is possible to create monthly graphics. User has to choose a model, a data range (using months) and a index. Versus insert all information to create the plot into ‘graphical_formula’ table with the field ‘id_graphical_formula_type=6’.


6: for monthly graphics

Mysql Tables

Description




graphical_formula_has_select_criteria For information associated to bar plot.


Table 10. Mysql tables manage plots associated to monthly graphics

5.1.6 Time Series

With Versus it is possible to create Time Series. They are special verification so it is necessary to create a standard verification with criteria_type = 5 and associated to a month (frequency=2 with start_data= start of month and end_date=end of month).

For dicotomic indexes, the system save the cumulation info into the ‘int_step’ field.

The system inserts all information about the criteria verification into ‘select_criteria’ table and ‘select_criteria_has_v_index’ for 2 dummy indexes associated to Observation Parameter (19) and Forecast Parameter (20).

Versus insert all information to create the plot into ‘graphical_formula’ table with the field ‘id_graphical_formula_type=7’.


After the creation, Versus can plot the data.

7: for time series graphics

Mysql Tables

Description

select_criteria For standard verification

With criteria_type=5



select_criteria_has_v_index To associated two dummy index (19,20)






Table 11. Mysql tables manage plots associated to time series graphics

5.1.7 Daily Cycle

With Versus it is possible to create Time Series. They are special verification so it is necessary to create a standard verification with criteria_type = 6 and associated to a month (frequency=2 with start_data= start of month and end_date=end of month).

For dicotomic indexes, the system save the cumulation info into the ‘int_step’ field.

The system inserts all information about the criteria verification into ‘select_criteria’ table and ‘select_criteria_has_v_index’ for 2 dummy indexes associated to Observation Parameter (19) and Forecast Parameter (20).

Versus insert all information to create the plot into ‘graphical_formula’ table with the field ‘id_graphical_formula_type=8’. All other information to customize the plot are into ‘graphical_formula_has_select_criteria’.

After the creation, Versus can plot the data.

8: for daily cycle graphics

Mysql Tables

Description

select_criteria For standard verification

With criteria_type=5

select_criteria_has_v_index To associated two dummy index (19,20)






Table 12. Mysql tables manage plots associated to daily cycle graphics

5.1.8 COSI

With Versus it is possible to create COSI Index. The COSMO Index (henceforth called COSI) is a measure of the forecasting skill of the different COSMO models implementation in COSMO consortium.



It is based on COSMO model forecasts of selected parameters out to 48 hours ahead for a selected set of positions verified by comparison with station observations and is based on XX months of data (depending on the availability for any COSMO member). A score is calculated for each forecast included in COSI. The individual scores are then combined in a weighted average to form a single value.

COSI is compiled from the following parameters

Near-surface (2m) temperature

Near-surface (10m) wind speed & direction as wind vector

Precipitation yes/no (0.2, 2.0 and 10.0 mm over the preceding 6 hours)

Total cloud amount (at least 0-2, 3-6 and 7-8 oktas)

verified at

TBD number of station positions across the COSMO Country

at the following forecast ranges

T+3 up to T+xx (open choice) every 3 hours

Observations and forecasts are used at station positions across the COSMO country. The station list should be selected using the fullest available knowledge of the likely permanence of stations. However further changes may be expected in the future, due to unforeseen station closures, etc. In such an event, a nearby station will, where possible, be introduced as a replacement.

Note that observations of wind speed are reported in knots, but are converted to metres per second before use COSI calculation. The COSMO model forecasts of wind are in metres per second.

All model forecast runs can be verified.



6 ANNEX : SOFTWARE INSTALLATION

6.1 Installation Requirements

a. Hardware CPU: Intel Core2 Duo 2GHz RAM: 2 GB HD: 300 GB

b. Software

VERSUS has been developed on a Linux Machine with this features: Kernel 2.6.21 MYSQL v. 5.0.45 with engine INNODB PHP v. 5.2.1 or upper with MYSQL, gd v.2.0 graphic library, XML DOM and Apache modules Web server Apache 2.xxx4 R v. 2.5.0 with following additional packages: DBI v 0.2.3 RMYSQL 0.6.0 CircStats v. 0.2.3 WaveSlim v. 1.6 Fields v. 3.5 Verification v 1.20

SWIG v. 1.3.31 or upper GRIB API BUFR

We assume that this software is installed and operating on your machine.

All software requirements are necessary for the complete installation, so if during the installation the script file doesn’t find all software requirements the installation is broken.

6.1.1 Installation of GRIB-API

The Grib-API’s are a set of C functions developed by ECMWF for decoding and manipulating the files GRIB.

The process of GRIB assimilation of VERSUS is based on this software, so you must first install it:

1. go into directory VERSUS/software/grib_api-1.4.0;

4 Technical note.

For a proper functioning of Versus it is necessary:

to use the SetEnv directive in your /etc/httpd/conf/httpd.conf (before loading LoadModule env_module /usr/lib/apache/1.3/mod_env.so) : syntax: SetEnv BUFR_TABLES bufr tables path to set into your etc/php.ini with register_globals = Off and register_argc_argv=On



2. perform the installation as explained in the file INSTALL

(NOTE: VERSUS doesn’t support the GRIB2 yet, so, if you want, you can install the grib API package without jasper libs (configure –disable-jpeg);

6.1.2 Installation of JPgraph

JPgraph’s are a set of PHP object classes that use GD library PHP module.

JPgraph don’t need particular install operations, simply include their script into your PHP script and all is done. However, if you use True Type Fonts into your graphs (as VERSUS does), you must have these fonts installed.

In the VERSUS installation package the set of fonts that VERSUS use is provided. If you need, copy untar the file X11R6.tar.gz and place the fonts into your fonts directory (typically /usr/X11R6/lib/X11/fonts/truetype).

6.2 Installation Steps

To install VERSUS it is necessary to uncompress the tar file VERSUS.tar.gz .

gunzip VERSUS.tar.gz

tar xvf VERSUS.tar

The uncompress operation creates the structure of the system into the current directory.

The directory tree created is composed by: html sviluppo software data log conf

and also by some files for installation README makefile.in configure.ac install_VERSUS.sh install_VERSUS.conf

The ‘install_VERSUS.conf ‘ file is used to define all variables to the proper functioning of the system. Below there are all additional information about these variables

Name

Description

VERSUS_HOME directory where you want to install VERSUS

VERSUS_DB_HOST IP Address

Example: 172.16.101.40

VERSUS_DB_USER Name database user (Do not change for this Versus version)

Example: versus



VERSUS_DB_PASSW Password database user (Do not changefor this Versus version)

Example:

APACHE_DOC_ROOT Path that APACHE uses for web pages.

Example: /var/www/html/ (for Linux Fedora)

PHP_INCLUDE_DIR Path where there are PHP extended libraries.

Example: /usr/include/php / (for Linux Fedora)

VERSUS_JPGRAPH_DIR Path where there are the JPGraph libraries.

Example: /versus/VERSUS/software/jpgraph-2.3.3/src/

If the machine has not JPgraph set this path using VERSUS_HOME+/software/jpgraph-2.3.3/src/

VERSUS_BUFR_DIR Path where there are the BUFR libraries.

Example: /versus/VERSUS/software/bufr_000350/

VERSUS_GRIBAPI_DIR Path where there are the GRIB API.

Example:/versus/VERSUS/software/grib_api-1.3.0/

The script file ‘install_VERSUS.sh’ can install the system only if the configuration file ‘install_VERSUS.conf ‘ was previously fill by user. Below there are all checks that the script file ‘install_VERSUS.sh’ makes.

Versus can be installed only if the user is ‘root’.

Preliminary checks

Check if the user is ‘root’ Check if it exists a user is ‘versus’ Check if it is complete the configuration file ‘install_VERSUS.conf’ Check if there are all software requirements

Database creation

Create the file ‘versus_create_DB.sql’. It is used to database creation called ‘versus’ and with all privileges. Create the database using the file previously created (versus_create_DB.sql) Create all tables into the ‘versus’ databse using the file ‘versus_DB_structure.sql’



Installation of R classes Create the file ‘Versus_R.include’ where there are all variables used for the database connection. The file is created

into two directories software/R/R-script/versus_R.include and html/versus2/versus_R..include

Web Gui installation Create a symbolic link into the Apache Create the configuration file for all web pages $HOME/html/versus2/CommonDefine.php Create a symbolic link for CommonDefine.php in $HOME/sviluppo/classes/ Change the owner for all web page (‘versus’)

Phoenix installation Start the configuration process for Phoenix library ./configure --with-php=… --with-swig= … --with-bufr=… --with-grib=… --with-home=… Compile Phoenix library: Make Install Phoenix library : Make install

Technical note - Phoenix configuration

Below there are some notes about files used to Phoenix library configuration.

Directory and files

Description

software/Phoenix-0.8/

Configure.ac

Makefile.am

The file configuration ‘configure.scan’ is created by the autotool ‘autoscan’.

After it is necessary to customize this file and rename it ‘configure.ac’.

The file ‘Makefile.am’ is used to define all subdirectories to search the other ‘Makefile.am’.

Example:

SUBDIRS= src

software/Phoenix-0.8/src/

Makefile.am

The file ‘Makefile.am’ is used to define all subdirectories to search the other ‘Makefile.am’ and all operations to do.

Example:

SUBDIRS= grib bufr

all: @for name in $(SUBDIRS): do



…

done

software/Phoenix-0.8/src/grib

Makefile.am

The file ‘Makefile.am’ is used to define all operations to do for gribapi.

Example:

all: $(MAKE) –f Make_grib …

software/Phoenix-0.8/src/bufr

Makefile.am

The file ‘Makefile.am’ is used to define all operations to do for bufr.

Example:

all: $(MAKE) –f Make_bufr…

File: install_VERSUS.sh

The file for installation is a shell script that follows the previuously steps using different functions

….

….

….

#

# set current directory for installation

CURR_DIR=$(pwd)

# check the presence of configuration file for VERSUS system and load it

if [ -e $VERSUS_FILE_CONFIGURATION ]; then

source $VERSUS_FILE_CONFIGURATION

else

echo -e "$VERSUS_FILE_CONFIGURATION not found -- NO"

echo -e "It is not possible to install."

exit $EXIT_FAILURE

fi

# Step: check if user is the root

CheckCurrentUser



# Step: check if it exists 'versus' user

CheckVersusUser

# Step: check softwares installed on the machine

CheckSoftwareRequirements

#Step: create all directories used by VERSUS system

CreateSoftwareDirectories

#Step: check if the configuration file exists and has valid information

CheckConfigurationFile

# Step: create the MyQL structure for versus system

ConfigureMySQL

# Step: configure web gui

ConfigureWEBGUI

# Step: configure R classes

ConfigureRClasses

#Step: install the Phoenix library

ConfigurePhoenix

….

….

…

Note.

If you want to disable the installation of one of the this step it is necessary only to use the character ‘#’ at the beginning of the code line.

This operation can be useful if on the machine VERSUS was installed and it doesn’t want reinstall one item.

Example: Disable mysql database installation

# Step: create the MyQL structure for versus system

#ConfigureMySQL



6.3 Directory organization

VERSUS is composed by the following directories:

Name Description

conf Directory with all configuration files

data Directory with all data to use for verifications.

This directory has some subdirectories relative to each type of data

(data/synop)

(data/temp)

(data/uppergrib)

(data/grib)

(data/bufrsynop)

(data/bufrtemp)

sviluppo Directory with

R code, for creation of scores (sviluppo/R)

PHP classes, for plots of scores (sviluppo/classes)

mysql Directory with all files used for database creation during the installation

software Directory with all softwares used by VERSUS system

(Bufr, gribapi, Phoenix…)

html Directory with

all web pages for WEB GUI system (html/versus2)

and plots created by Versus system (html/data)

log Directory with all log files associated to the Versus process



7 ANNEX : DATABASE

Figure 11 DB MODEL



8 ANNEX : TABLES OF DATABASE

Database Model plugin_tmp.xml

FORECAST

bitmap Filled when a bitmap is defined in the grib data ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_bitmap BIGINT(20) PK NN UNSIGNED

ds_bitmap INTEGER(11) NN

id_bitmap_type INTEGER NN UNSIGNED

bitmap_value BLOB NN AI

IndexName IndexType Columns

PRIMARY PRIMARY id_bitmap

id_bitmap Index id_bitmap

bitmap_FKIndex1 Index id_bitmap_type

fcs_parameter Contains list of forecast parameter classified by code table and parameter code ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

cd_param_identify INTEGER(11) PK NN

code_table INTEGER(11) PK NN

cd_fcs_type INTEGER NN UNSIGNED

measurement VARCHAR(256) NN

ds_fcs_parameter VARCHAR(256) NN


PRIMARY PRIMARY cd_param_identify code_table

fcs_parameter_FKIndex1 Index cd_fcs_type

grib In this table are loaded the forecast in grib format. The grib_value changes on the base of chose method. ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_grib BIGINT(20) PK NN UNSIGNED AI

id_method INTEGER NN UNSIGNED

id_station BIGINT(20) NN UNSIGNED

id_registered_grib BIGINT(20) NN UNSIGNED

run INTEGER(11) NN

dt_validity DATE NN

period1 INTEGER(11) NN

period2 INTEGER(11) NN

id_order INTEGER(11) NN

height FLOAT NN

lat FLOAT NN

lon FLOAT NN



grib_value FLOAT NN

accuracy INTEGER(11) NN

lnd_mask FLOAT

perturbation_number INTEGER NN 0

n_fcs_ensamble INTEGER NN UNSIGNED 0

verification_time DATETIME NN


PRIMARY PRIMARY id_grib

id_grib Index id_grib

grib_FKIndex1 Index id_registered_grib

grib_FKIndex32 Index id_station

grib_index_10 Unique Index id_station id_registered_grib run dt_validity period1 period2 id_order perturbation_number lnd_mask id_method

grib_index1984 Index id_station

grib_index1988 Index id_registered_grib dt_validity id_order period2 id_station perturbation_number lnd_mask

grib_index1991 Index id_registered_grib dt_validity id_order period1 id_station lnd_mask

grib_FKIndex3 Index id_method

grib_index2210 Index id_method id_order id_station id_registered_grib run verification_time

grib_index2229 Index run id_registered_grib dt_validity id_method

grid It is the grid of the gridded data ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_grid BIGINT(20) PK NN UNSIGNED AI

id_grid_type INTEGER NN UNSIGNED

lat_first DOUBLE

lon_first DOUBLE

lat_last DOUBLE

lon_last DOUBLE

ni FLOAT

nj FLOAT



di DOUBLE

dj DOUBLE

lat_polo FLOAT

lon_polo FLOAT

proiezione INTEGER

scan_mode VARCHAR(8)


PRIMARY PRIMARY id_grid

id_grid Index id_grid

grid_FKIndex1 Index id_grid_type

model_process It is the table that contains the list of weather model that VERSUS carried out ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

cd_model_process INTEGER(11) PK NN

id_center INTEGER PK NN UNSIGNED

id_model_type INTEGER NN UNSIGNED

ds_model_process VARCHAR(256) NN


PRIMARY PRIMARY cd_model_process id_center

model_process_FKIndex1 Index id_model_type

registered_grib It is the catalogue of numerical product that are classified into DB ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_registered_grib BIGINT(20) PK NN UNSIGNED

id_center INTEGER NN UNSIGNED

cd_model_process INTEGER(11) NN

code_table INTEGER(11) NN

cd_param_identify INTEGER(11) NN

id_bitmap BIGINT(20) NN UNSIGNED

id_grid BIGINT(20) NN UNSIGNED

id_time_unit INTEGER(11) NN

level2 INTEGER(11) NN

level1 INTEGER(11) NN

id_level INTEGER(11) NN

id_local_usage INTEGER(11) NN

time_range_ind INTEGER(11) NN


PRIMARY PRIMARY id_registered_grib

id_registered_grib Index id_registered_grib

registered_grib_FKIndex3 Index id_grid

registered_grib_FKIndex1 Index id_bitmap

registered_grib_FKIndex5 Index cd_param_identify code_table

registered_grib_FKIndex4 Index cd_model_process id_center



model_type ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_model_type INTEGER PK NN UNSIGNED AI

ds_model_type VARCHAR(256)

topography_file_path VARCHAR(256)

type_step INTEGER UNSIGNED


PRIMARY PRIMARY id_model_type

bitmap_type ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_bitmap_type INTEGER PK NN UNSIGNED AI

ds_bitmap_type VARCHAR(256)


PRIMARY PRIMARY id_bitmap_type

FRONTEND

frontend_acq Here are defined the list of VERSUS front end. There are two kind of FE:loader and score ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

fe_name VARCHAR(256) PK NN

id_stratification BIGINT NN 2

id_obs_type INTEGER NN UNSIGNED

log_dir VARCHAR(256) NN

input_dir VARCHAR(256) NN

error_dir VARCHAR(256) NN

backup_dir VARCHAR(256)

flg_on_off INTEGER(11) NN

ds_frontend_acq VARCHAR(256) NN

msg_name VARCHAR(256)

process_name VARCHAR(256)

parameter_correction_flg BOOL


PRIMARY PRIMARY fe_name

frontend_acq_FKIndex1 Index id_obs_type

frontend_acq_FKIndex2 Index id_stratification

station It contains the meteorological station information ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_station BIGINT(20) PK NN UNSIGNED AI

block_number CHAR(2)

station_number CHAR(3)

cd_icao VARCHAR(4)

id_station_type SMALLINT NN UNSIGNED



ds_station VARCHAR(246)

lon FLOAT NN

lat FLOAT NN

height_station INTEGER NN UNSIGNED

country CHAR(64) NN

flg_activation BOOL NN


PRIMARY PRIMARY id_station

id_station_type Index id_station_type

id_station Index id_station

station_FKIndex1 Index id_station_type

station_stratifi ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_station BIGINT(20) PK NN UNSIGNED

id_stratification BIGINT PK NN


PRIMARY PRIMARY id_station id_stratification

station_stratifi_FKIndex1 Index id_station

station_stratifi_FKIndex2 Index id_stratification

station_type ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_station_type SMALLINT PK NN UNSIGNED

ds_station_type VARCHAR(256) NN


PRIMARY PRIMARY id_station_type

method Here are listed the method of point choose ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_method INTEGER PK NN UNSIGNED AI

ds_method VARCHAR(256)

algorithm VARCHAR(256)

parameter VARCHAR(256)


PRIMARY PRIMARY id_method

frontend_acq_has_method Only for loader FE. It is possible to specify what method apply to the FE ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

fe_name VARCHAR(256) PK NN

id_method INTEGER PK NN UNSIGNED


PRIMARY PRIMARY fe_name



id_method

frontend_acq_has_method_FKIndex1 Index fe_name

frontend_acq_has_method_FKIndex2 Index id_method

GRAPH OUTPUT

graphical_output Containg the graphical results of the scores ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_graphical_formula BIGINT PK NN

date_start DATE PK NN

date_end DATE PK NN

graphical_path_name VARCHAR(256) NN


PRIMARY PRIMARY id_graphical_formula date_start date_end

graphical_output_FKIndex1 Index id_graphical_formula

graphical_formula Contains the graphical information for scores plotting ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_graphical_formula BIGINT PK NN AI

id_graphical_formula_type INTEGER NN UNSIGNED

cd_criteria_type INTEGER NN UNSIGNED 1

title VARCHAR(256)

file_ext CHAR(3)

scale_min FLOAT

scale_max FLOAT

x_title VARCHAR(64)

y_title VARCHAR(64)

version VARCHAR(64)

directory_path VARCHAR(256)

date_start DATE

date_end DATE

threshold FLOAT


PRIMARY PRIMARY id_graphical_formula

graphical_formula_FKIndex1 Index cd_criteria_type

graphical_formula_FKIndex2 Index id_graphical_formula_type

graphical_formula_has_select_criteria_index Contains the information of a single graphical element ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_graphical_formula BIGINT PK NN

id_v_index INT PK NN

id_select_criteria BIGINT PK NN UNSIGNED



step FLOAT PK NN 0

legend VARCHAR(256) NN

line_style VARCHAR(256) NN

line_color VARCHAR(256) NN


PRIMARY PRIMARY id_graphical_formula id_v_index id_select_criteria step

graphical_formula_has_select_criteria_has_v_index_FKIndex1 Index id_graphical_formula

graphical_formula_has_select_criteria_has_v_index_FKIndex2 Index id_select_criteria id_v_index

NUMERICAL OUTPUT

index_output Here are stored numerical results of the scores ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

step INTEGER(11) PK NN



date_start DATE PK NN

date_end DATE PK NN

index_value FLOAT PK NN

index_threshold DOUBLE PK NN 0

a FLOAT

b FLOAT

c FLOAT

d FLOAT

number_value INTEGER(11) NN

start_threshold DOUBLE 9999


PRIMARY PRIMARY step id_v_index id_select_criteria date_start date_end index_value index_threshold

FKIndex1 Index id_select_criteria id_v_index

cosi_output ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_cosi_output BIGINT PK NN AI

id_cosi BIGINT NN

step INTEGER UNSIGNED

date_start DATE

date_end DATE

cosi_value FLOAT



number_value INTEGER UNSIGNED


PRIMARY PRIMARY id_cosi_output

cosi_output_FKIndex1 Index id_cosi

cosi_output_idx Unique Index id_cosi step date_start date_end

OBS

surface_data In this table are loaded synop observation ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_surface BIGINT(20) PK NN UNSIGNED AI

id_obs_type INTEGER NN UNSIGNED

cd_obs_parameter INTEGER(11) NN


h_validity INTEGER(11) NN

dt_validity DATE NN

surface_value FLOAT NN

dt_insert DATE NN

confidence INTEGER UNSIGNED

verification_time DATETIME NN


PRIMARY PRIMARY id_surface

cd_obs_parameter Index cd_obs_parameter

id_synop Index id_surface

synop_data_FKIndex1 Index cd_obs_parameter

synop_data_FKIndex2 Index id_station

synop_data_index1366 Unique Index cd_obs_parameter id_station h_validity dt_validity surface_value

surface_data_FKIndex3 Index id_obs_type

surface_data_index1982 Index id_station

idx1 Index id_station h_validity dt_validity cd_obs_parameter

idx2 Index cd_obs_parameter h_validity dt_validity

surface_data_index2215 Index cd_obs_parameter id_station verification_time

surface_data_index2231 Index cd_obs_parameter dt_validity id_obs_type

stratification



Contains the stratification defined by user on wihich compute the verification ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_stratification BIGINT PK NN AI

ds_stratification VARCHAR(256) NN


PRIMARY PRIMARY id_stratification

obs_type ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_obs_type INTEGER PK NN UNSIGNED AI

ds_obs_type VARCHAR(256)


PRIMARY PRIMARY id_obs_type

suspect_value ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_suspect_value BIGINT PK NN AI


id_select_criteria BIGINT NN UNSIGNED

dt_validity_obs DATE

verification_time DATETIME

obs_value FLOAT

dt_validity_fcs DATE

fcs_value FLOAT

fcs_step INTEGER UNSIGNED


PRIMARY PRIMARY id_suspect_value

suspect_value_FKIndex1 Index id_select_criteria

suspect_value_FKIndex2 Index id_station

SERVICES TABLE

upperair_level ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

cd_level INTEGER(11) PK NN

ds_level VARCHAR(256) NN


PRIMARY PRIMARY cd_level

run Available run ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_run INTEGER PK NN UNSIGNED AI

ds_run VARCHAR(128)




PRIMARY PRIMARY id_run

user management

v_role ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

cd_v_role INTEGER(11) PK NN

ds_v_role VARCHAR(256) NN


PRIMARY PRIMARY cd_v_role

v_user ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_v_user INTEGER PK NN UNSIGNED AI

pwd VARCHAR(256) PK NN

login VARCHAR(256) NN

cd_v_role INTEGER(11) NN

v_user_surname VARCHAR(256)

v_user_name VARCHAR(256) NN


PRIMARY PRIMARY id_v_user pwd

id_user Index id_v_user

v_user_FKIndex1 Index cd_v_role

v_user_index1386 Unique Index login

VERIFICATION

select_criteria Here are defined the criteria of selection of the data for scores generation. ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc


ds_select_criteria VARCHAR(256) NN

id_stratification BIGINT NN



id_frequency INTEGER UNSIGNED

start_date DATE

end_date DATE

start_step INTEGER(11) NN

end_step INTEGER(11) NN

int_step INTEGER(11) NN

run INTEGER(11) NN



cd_criteria_type INTEGER UNSIGNED 0

rag INTEGER UNSIGNED 0

suspect_obs_flg BOOL

time_obs_flg BOOL 0


PRIMARY PRIMARY id_select_criteria

cd_obs_parameter Index cd_obs_parameter

select_criteria_FKIndex3 Index cd_obs_parameter

select_criteria_FKIndex6 Index id_registered_grib

select_criteria_FKIndex7 Index id_stratification

select_criteria_FKIndex8 Index id_frequency

select_criteria_FKIndex5 Index cd_criteria_type

v_index Contains the algorithm of the scores written in R language ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_v_index INT PK NN AI

ds_v_index VARCHAR(256) NN

v_procedure VARCHAR(256) NN

analisys_type INT NN

is_skill_score SMALLINT UNSIGNED


PRIMARY PRIMARY id_v_index

frequency Frequency has the following value: 1 Monthly 2 Date interval 3 Seasonal ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_frequency INTEGER PK NN UNSIGNED AI

ds_frequency VARCHAR(256)


PRIMARY PRIMARY id_frequency

select_criteria_has_v_index Is the relationship between index and select criteria ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc




PRIMARY PRIMARY id_select_criteria id_v_index

select_criteria_has_v_index_FKIndex1 Index id_select_criteria

select_criteria_has_v_index_FKIndex2 Index id_v_index

select_criteria_has_method A select criteria coud be applied on different method of chose point



ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc


id_method INTEGER PK NN UNSIGNED

algorithm VARCHAR(256)


PRIMARY PRIMARY id_select_criteria id_method

select_criteria_has_method_FKIndex1 Index id_select_criteria

select_criteria_has_method_FKIndex2 Index id_method

log_score ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_log_score BIGINT PK NN AI

id_v_index INT NN


calculated_data DATE

to_compute INTEGER


PRIMARY PRIMARY id_log_score

log_score_FK Index id_select_criteria id_v_index

criteria_type The criteria type are: 0 Continuous standard criteria for surface data 1 Continuous standard criteria for upperair data 2 Dicotomic standard criteria 3 Continuous conditional criteria for surface data 4 Dicotomic conditional criteria 5 Time series 6 Daily Cycle ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

cd_criteria_type INTEGER PK NN UNSIGNED AI

ds_criteria_type VARCHAR(256)


PRIMARY PRIMARY cd_criteria_type

list_threshold The list of threshold for dichothomy scores ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_list_threshold BIGINT PK NN AI


ds_threshold VARCHAR(256)

threshold_value DOUBLE

start_th_value DOUBLE 9999


PRIMARY PRIMARY id_list_threshold

list_threshold_FKIndex1 Index id_select_criteria



conditional_function Used for conditional verification when the condition is a function ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_conditional_function BIGINT PK NN AI

ds_conditional_function VARCHAR(256)

function_cnd VARCHAR(256)


PRIMARY PRIMARY id_conditional_function

conditional_verification This table is used for conditional verification ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_conditional_verify BIGINT PK NN AI

id_conditional_function BIGINT NN




cnd1 VARCHAR(256)

cnd2 VARCHAR(256)


PRIMARY PRIMARY id_conditional_verify

condition_FKIndex1 Index cd_obs_parameter

condition_FKIndex2 Index id_registered_grib

condition_FKIndex3 Index id_select_criteria

conditional_verification_FKIndex4 Index id_conditional_function

cosi ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_cosi BIGINT PK NN AI

ds_cosi VARCHAR(64)


PRIMARY PRIMARY id_cosi

cosi_has_select_criteria ColumnName DataType PrimaryKey NotNull Flags Default Value Comment AutoInc

id_cosi BIGINT PK NN


weight INTEGER UNSIGNED


PRIMARY PRIMARY id_cosi id_select_criteria

cosi_has_select_criteria_FKIndex1 Index id_cosi

cosi_has_select_criteria_FKIndex2 Index id_select_criteria



9 ANNEX : CLASSES

The html documentation relative to this annex is in /sviluppo/html/index.html

Here are the classes, structs, unions and interfaces with brief descriptions:

continuosUpperAir Extract continuous upperair scores data from DB for graph continuousMonthlyGraphical Extract list of scores from DB for continuous surface monthly graphical production continuousMonthlySurface Extract continuous surface scores data from DB for a monthly graph continuousSurface Extract continuous surface scores data from DB for graph continuousSurfaceGraphical Extract list of scores from DB for continuous surface graphical production continuousUpperGraphical Extract list of scores from DB for continuous upper air graphical production data Extract data from DB for graph dicotomicGraphical Extract list of scores from DB for dicotomic graphical production dicotomicMonthlyGraphical Extract list of scores from DB for dicotomic surface monthly graphical production dicotomicMonthlySurface Extract dicotomic surface scores data from DB for a monthly graph dicotomicSurface Extract dicotomic scores from DB for graph dicotomicSurfaceByStep Extract dicotomic scores from DB for graph FEAcq FEAcq class manages the DB loader VERSUS front-end FEAcqItem FEAcqItem class manages a single loader front-end forecastData Extract forecast data from DB for graph graphical Extract the list of scores from DB for graphical production GraphicalOnDemand Extract list of data from DB for time series production graphicalOutput Manages the graphical output of the scores for VERSUS DB graphicMonthlyScore GraphicMonthlyScore manages graphical monthly production data graphicScore GraphicScore manages graphical production data graphicTimeSeries GraphicTimeSeries manages graphical time series graphicUpperairScore GraphicUpperairScore manages graphical upeerair production data listStation ListStation implements the object that manages the station list to find on grid monthlySurfaceScore Extract surface scores data from DB for a monthly graph numericalScore NumericalScore class manages the scores VERSUS front-end OBSBufrSynop OBSBufrSynop implements surface (synop data) VERSUS observation in BUFR

format OBSBufrTemp OBSBufrTemp implements surface (temp data) VERSUS observation in BUFR

format observationData Extract observation data from DB for graph OBSSynop OBSSynop implements surface (synop data) specific VERSUS observation OBSTemp OBSTemp implements an upperair (temp data) specific VERSUS observation score Extract scores data from DB for graph



scoreDaemon ScoreDaemon implements the process daemon of the scores ScoreProcessForce ScoreProcessForce implements the process of the scores timeSeriesData Extract observation data from DB for graph for Time Series. It is composed by

forecast and observation timeSeriesGraphical Extract list of data from DB for time series production topography Topography implements the decoding of topography grib versusDataIn VersusDataIn manages VERSUS data input versusForecast VersusForecast implements the decoding and inserting of forecast in GRIB

format into VERSUS DB versusObservation VersusObservation implements a generic VERSUS observation

10 ANNEX : WEB FILES

Here is a list of all documented files with brief descriptions:

VERSUS/html/versus2/ChooseItemFromDB.php This page is used to create a new panel used during the Verification Registration (Standard or Conditional)

VERSUS/html/versus2/CommonDefine.php File with the definition of Environment variable for VERSUS system

VERSUS/html/versus2/CommonFunction.php File with all generic functions used into VERSUS system

VERSUS/html/versus2/CommonGUIFunction.php File with all generic functions used into VERSUS system for gui widget used into web pages

VERSUS/html/versus2/CommonInclude.php File with all PHP pages include into all pages

VERSUS/html/versus2/ConditionalRegistration.php This page is associated to menu 'Conditional Verification': 'Registration'

VERSUS/html/versus2/COSIDelete.php This page associated to menu 'COSI': 'Delete'

VERSUS/html/versus2/COSIExecNumeric.php This page uses the PHP classes to create numerical score for the current verification

VERSUS/html/versus2/COSIForm.php This page is included by COSIRegistration.php (menu 'COSI': 'Registration')

VERSUS/html/versus2/COSIGraphicsDelete.php This page associated to menu 'COSI Report': 'Show' This page is called by COSIList.php The page gives the capability to delete graphics and delete record into graphical_output and comes back to the page COSIList.php Information by GET method: ID_COSI, DATA1, DATA2, PAGE



VERSUS/html/versus2/COSIList_Periodical.php This page associated to menu 'COSI Report': 'Run'

VERSUS/html/versus2/COSIReport.php This page shows a complete report about the current COSI definition

VERSUS/html/versus2/COSIScores.php This page allow to show all scores related to the current ID_COSI The page shows all single scores to use to calculate COSI global index into a data range

VERSUS/html/versus2/COSISearch.php This page associated to menu 'COSI Report'

VERSUS/html/versus2/CrossGraphicsDelete.php This page associated to menu 'Cross Model Graphic': 'Show'

VERSUS/html/versus2/CrossGraphicsList.php This page associated to menu 'Cross Model Graphic': 'Show'

VERSUS/html/versus2/DataDelete.php This page is associated to menu 'Data Management': 'Data Availability'

VERSUS/html/versus2/DataDownload.php This page is associated to menu 'Data Management': 'Data Download'

VERSUS/html/versus2/DataSave.php This page is associated to menu 'Data Management': 'Data Download'

VERSUS/html/versus2/DefineFieldsSearchCOSI.php This page associated to menu 'COSI Report'

VERSUS/html/versus2/DefineFieldsSearchCrossScore.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/DefineFieldsSearchScore_General.php This page associated to menu 'Standard Report': 'Show' and 'Conditional Report': 'Show'

VERSUS/html/versus2/DefineFieldsSearchScore_Monthly.php This page associated to menu 'Standard Report': 'Run' and 'Periodical Report':'Registration'

VERSUS/html/versus2/DefineFieldsSearchScore_TimeSeries.php This page associated to menu 'Time Series': 'Show'

VERSUS/html/versus2/DefineFieldsSearchScore_TimeSeries2.php This page associated to menu 'Time Series': 'Delete'

VERSUS/html/versus2/DefineFieldsSearchStation.php This page associated to menu 'Station': 'Modify' and 'Station': 'Delete'

VERSUS/html/versus2/FEForm.php This page is associated to menu 'Process Administration': 'Score Manager'

VERSUS/html/versus2/FEUpdate.php This page is associated to menu 'Process Administration': 'Score Manager'

VERSUS/html/versus2/GraphicConfiguration.php This page is used to configure a graphic on demand

VERSUS/html/versus2/GraphicConRegistration.php This page associated to menu 'Standard Report': 'Show' (for Surface Data and



Continuous index)

VERSUS/html/versus2/GraphicCrossConRegistration2.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/GraphicCrossDicGenRegistration2.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/GraphicCrossDicRegistrationByType.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/GraphicCrossRegistration.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/GraphicCrossUpperRegistration2.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/GraphicCrossViewer.php This page shows all plots associated to a cross model into a data range

VERSUS/html/versus2/GraphicDicGenRegistration.php This page associated to menu 'Standard Report': 'Show' (for for Surface Data and Dicotomic index)

VERSUS/html/versus2/GraphicDicRegistrationByType.php This page associated to menu 'Standard Report': 'Show' (for for Surface Data and Dicotomic index)

VERSUS/html/versus2/GraphicDicViewer.php This page shows all plots associated to a verification with dicotomic index into a data range

VERSUS/html/versus2/GraphicDownload.php This page is associated to menu 'Standard Report': 'Show' and 'Conditional Report': 'Show'

VERSUS/html/versus2/GraphicFunction.php File with all functions used into VERSUS system to create all plots associated to the criteria

VERSUS/html/versus2/GraphicMonthlyDicRegistration.php This page associated to menu 'Periodical Report':'Registration' for (Dicotomic index)

VERSUS/html/versus2/GraphicMonthlyGenRegistration.php This page associated to menu 'Monthly Report': 'Registration' and 'Show'

VERSUS/html/versus2/GraphicMonthlyRegistration.php This page associated to menu 'Periodical Report':'Registration'

VERSUS/html/versus2/GraphicMonthViewer.php This page shows the plots associated to a monthly verification into a data range

VERSUS/html/versus2/GraphicsDailyCycleDelete.php This page associated to menu 'Daily Cycle ': 'Show' (for delete graphics)

VERSUS/html/versus2/GraphicsDelete.php This page associated to menu 'Standard Report': 'Show' (for Surface Data and Continuous index)

VERSUS/html/versus2/GraphicsTimeSeriesDelete.php This page associated to menu 'Time Series ': 'Show' (for delete graphics)

VERSUS/html/versus2/GraphicTimeSeriesRegistration.php This page associated to menu 'Time



Series':'Registration' and 'Time Series':'Show'

VERSUS/html/versus2/GraphicTimeSeriesViewer.php This page shows all plots associated to the current time series into a data range

VERSUS/html/versus2/GraphicUpperRegistration.php This page associated to menu 'Standard Report': 'Show' (for Upper Air Data)

VERSUS/html/versus2/GraphicViewer.php This page shows all plots associated to a verification into a data range

VERSUS/html/versus2/GraphicViewer2.php This page shows a file png with original dimensions

VERSUS/html/versus2/index.php This page is the home page of Versus system

VERSUS/html/versus2/IndexForm.php This page is included by IndexRegistration.php and IndexUpdate.php

VERSUS/html/versus2/IndexRegistration.php This page is associated to menu 'Index': 'Registration'

VERSUS/html/versus2/IndexReport.php This page shows a complete report about the current index

VERSUS/html/versus2/IndexSelection.php This page is associated to menu 'Index': 'Modify'

VERSUS/html/versus2/IndexUpdate.php This page is associated to menu 'Index': 'Modify'

VERSUS/html/versus2/ListStationReport.php This page shows a complete report about all stations associated to a stratification

VERSUS/html/versus2/Login.php This page checks the process of login

VERSUS/html/versus2/LogMonitor.php This page is associated to menu 'Log Administration'

VERSUS/html/versus2/Logout.php This page shows a message error because the user validation is not possible

VERSUS/html/versus2/Master.php This page is the template used for the creation of all VERSUS Web GUI

VERSUS/html/versus2/MethodForm.php This page is included by MethodRegistration.php and MethodUpdate.php

VERSUS/html/versus2/MethodRegistration.php This page is associated to menu 'Method': 'Registration'

VERSUS/html/versus2/MethodReport.php This page shows a complete report about the current method

VERSUS/html/versus2/MethodSelection.php This page is associated to menu 'Method': 'Modify'

VERSUS/html/versus2/MethodUpdate.php This page is associated to menu 'Method': 'Modify'



VERSUS/html/versus2/ModelForm.php This page is included by ModelRegistration.php and ModelUpdate.php

VERSUS/html/versus2/ModelRegistration.php This page is associated to menu 'Model': 'Registration'

VERSUS/html/versus2/ModelReport.php This page shows a complete report about the current model

VERSUS/html/versus2/ModelSelection.php This page is associated to menu 'Model': 'Modify'

VERSUS/html/versus2/ModelTypeForm.php This page is included by ModelTypeRegistration.php and ModelTypeUpdate.php

VERSUS/html/versus2/ModelTypeFormReport.php This page shows a complete report about the current model Type

VERSUS/html/versus2/ModelTypeRegistration.php This page is associated to menu 'Model': 'Registration'

VERSUS/html/versus2/ModelTypeReport.php This page shows a complete report about the current model Type

VERSUS/html/versus2/ModelTypeUpdate.php This page is associated to menu 'Model': 'Modify'

VERSUS/html/versus2/ModelUpdate.php This page is associated to menu 'Model': 'Modify'

VERSUS/html/versus2/MonthlyGraphicsDelete.php This page associated to menu 'Monthly Report': 'Show'

VERSUS/html/versus2/MonthlyGraphicsList.php This page associated to menu 'Periodical Report': 'Show'

VERSUS/html/versus2/ParameterForm.php This page is included by ParameterRegistration.php and ParameterUpdate.php

VERSUS/html/versus2/ParameterRegistration.php This page is associated to menu 'Parameter': 'Registration'

VERSUS/html/versus2/ParameterReport.php This page shows a complete report about the current parameter

VERSUS/html/versus2/ParameterSelection.php This page is associated to menu 'Parameter': 'Modify'

VERSUS/html/versus2/ParameterUpdate.php This page is associated to menu 'Parameter': 'Modify'

VERSUS/html/versus2/ProcessDelete.php This page is associated to menu 'Process Administration': 'Acquisition Manager'

VERSUS/html/versus2/ProcessForm.php This page is included by ProcessRegistration.php and ProcessUpdate.php

VERSUS/html/versus2/ProcessLogs.php This page is called from LogMonitor.php



VERSUS/html/versus2/ProcessLogViewer.php This page shows the log file associated to the current process

VERSUS/html/versus2/ProcessMonitor.php This page is associated to menu 'Process Administration': 'Acquisition Manager'

VERSUS/html/versus2/ProcessRegistration.php This page is associated to menu 'Process Administration': 'Acquisition Registration'

VERSUS/html/versus2/ProcessReport.php This page shows a complete report about the current process

VERSUS/html/versus2/ProcessUpdate.php This page is associated to menu 'Process Administration': 'Acquisition Manager'

VERSUS/html/versus2/RunRegistration.php This page is associated to menu 'Run': 'Registration'

VERSUS/html/versus2/RunReport.php This page shows a complete report about the current run

VERSUS/html/versus2/SaveProcessLog.php This page download the log file associated to the current process

VERSUS/html/versus2/ScoreCond.php This page is included by ConditionalRegistration.php (menu 'Conditional Verification': 'Registration')

VERSUS/html/versus2/ScoreExecNumeric.php This page uses the PHP classes to create numerical score for the current verification

VERSUS/html/versus2/ScoreGraphics.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/ScoreList.php This page associated to menu 'Standard Report': 'Show'

VERSUS/html/versus2/ScoreList_Monthly.php This page associated to menu 'Standard Report': 'Run' and 'Periodical Report':'Registration'

VERSUS/html/versus2/ScoreList_Periodical.php This page associated to menu 'Standard Report': 'Run' and 'Periodical Report':'Registration'

VERSUS/html/versus2/ScoreMonitor.php This page is associated to menu 'Process Administration': 'Score Manager'

VERSUS/html/versus2/ScoreReport.php This page shows a complete report about the current verfication

VERSUS/html/versus2/ScoreSearch.php This page associated to menu 'Standard Report': 'Show', 'Verification Report': 'Show', 'Standard Verification': 'Delete' and 'Conditional Verification': 'Delete' User can define some information to search one or more standard verification to study

VERSUS/html/versus2/ScoreSearch_Cross.php This page associated to menu 'Cross Model Graphic': 'Registration'

VERSUS/html/versus2/ScoreSearch_Delete.php This page associated to menu 'Standard Verification': 'Delete'



VERSUS/html/versus2/ScoreSearch_Monthly.php This page associated to menu 'Monthly Graphic ':'Registration'

VERSUS/html/versus2/ScoreSearch_Periodical.php This page associated to menu 'Standard Report': 'Periodical Run'

VERSUS/html/versus2/ScoreStandard.php This page is included by StandardRegistration.php (menu 'Standard Verification': 'Registration')

VERSUS/html/versus2/ScoreSurfaceCond.php This page is included by ScoreCond.php (menu 'Conditional Verification': 'Registration')

VERSUS/html/versus2/ScoreSurfaceStandard.php This page is included by ScoreStandard.php (menu 'Standard Verification': 'Registration')

VERSUS/html/versus2/ScoreUpperStandard.php This page is included by ScoreStandard.php (menu 'Standard Verification': 'Registration')

VERSUS/html/versus2/SelectDBIndex.php This page is associated to menu 'Index': 'Delete'

VERSUS/html/versus2/SelectDBMethod.php This page is associated to menu 'Method': 'Delete'

VERSUS/html/versus2/SelectDBModel.php This page is associated to menu 'Model': 'Delete'

VERSUS/html/versus2/SelectDBParameter.php This page is associated to menu 'Parameter': 'Delete'

VERSUS/html/versus2/SelectDBRun.php This page is associated to menu 'Run': 'Delete'

VERSUS/html/versus2/SelectDBStation.php This page is associated to menu 'Station': 'Delete'

VERSUS/html/versus2/SelectDBStratification.php This page is associated to menu 'Stratification': 'Delete'

VERSUS/html/versus2/SelectDBUser.php This page is associated to menu 'User': 'Delete'

VERSUS/html/versus2/ShowCOSINumScore.php This page is used to show the numerical score associated to the COSI index To save the scores the page is used with the key TYPE: text, to save an ASCII file, excel, to save a xls file

VERSUS/html/versus2/ShowNumScore.php This page is used to show the numerical score associated to the verification (Standard and Conditional) and to save all scores into files

VERSUS/html/versus2/ShowSuspectValue.php This page is used to show the suspected values into numerical score associated to the verification (Standard and Conditional)

VERSUS/html/versus2/Small_Master.php This page is the template used for the



creation of all panel used for selection fro database

VERSUS/html/versus2/StandardRegistration.php This page associated to menu 'Standard Verification': 'Registration'

VERSUS/html/versus2/StationForm.php This page is included by StationRegistration.php and StationUpdate.php

VERSUS/html/versus2/StationGenRegistration.php This page associated to menu 'Station': 'Registration'

VERSUS/html/versus2/StationListDelete.php This page associated to menu 'Station': 'Delete'

VERSUS/html/versus2/StationListModify.php This page associated to menu 'Station': 'Modify'

VERSUS/html/versus2/StationRegistration.php This page is associated to menu 'Station': 'Registration'

VERSUS/html/versus2/StationReport.php This page shows a complete report about the current station

VERSUS/html/versus2/StationSearch.php This page associated to menu 'Station': 'Modify' and 'Delete'

VERSUS/html/versus2/StationSelection.php This page is associated to menu 'Station'

VERSUS/html/versus2/StationUpdate.php This page is associated to menu 'Station': 'Modify'

VERSUS/html/versus2/StratificationForm.php This page is included by StratificationRegistration.php and StratificationUpdate.php

VERSUS/html/versus2/StratificationRegistration.php This page is associated to menu 'Stratification': 'Registration'

VERSUS/html/versus2/StratificationReport.php This page shows a complete report about the current stratification

VERSUS/html/versus2/StratificationSelection.php This page is associated to menu 'Stratification': 'Modify'

VERSUS/html/versus2/StratificationUpdate.php This page is associated to menu 'Stratification': 'Modify'

VERSUS/html/versus2/SuspectValueForm.php This page is included by SuspectValueRegistration.php and SuspectValueUpdate.php

VERSUS/html/versus2/SuspectValueRegistration.php This page is associated to menu 'Suspect Value': 'Registration'

VERSUS/html/versus2/SuspectValueReport.php This page shows a complete report about the current suspect value associated to the obs parameter

VERSUS/html/versus2/SuspectValueSelection.php This page is associated to menu 'Suspect Value': 'Modify'

VERSUS/html/versus2/SuspectValueUpdate.php This page is associated to menu 'Suspect



Value': 'Modify'

VERSUS/html/versus2/TimeSeriesDelete.php This page associated to menu 'Time Series': 'Delete'

VERSUS/html/versus2/TimeSeriesList.php This page associated to menu 'Daily Cycle Report' and 'Time Series Report'

VERSUS/html/versus2/TimeSeriesRegistration.php This page is associated to menu 'Time Series': 'Registration' and 'Daily Cycle':'Registration'

VERSUS/html/versus2/TimeSeriesSearch.php This page associated to menu 'Time Series': 'Show'

VERSUS/html/versus2/UserRegistration.php This page is associated to menu 'User': 'Registration'

VERSUS/html/versus2/UserSelection.php This page is associated to menu 'User' : 'Modify'

VERSUS/html/versus2/UserUpdate.php This page is associated to menu 'User': 'Modify'

versus - cosmo modelfor versus system the second level is associated to the php code and the third...

Documents