RTXPS on-line Manual: one page summary

Release: 1.3
Date: July 2003
Revision:2.0
Rtxpsd has been extended by 3 new functions in order to be able to run external executables, pass descriptor values to and receive descriptor values from those executables.

Functions:

  1. run_executable(executable_path,input_file,output_file) Rtxpsd runs the specified executable (using system command) with two parameters: input file and output file.

  2. set_input(template_name,input_file) Rtxpsd instantiates - converts a template file and creates an input file for an external rtxpsd executable. Template files contain just descriptor names, input files contain paires of descriptor names and descriptor values.

  3. read_output(output_file) Rtxpsd read values from a file containing pairs of descriptor names and descriptor values.

Models are executables located ojn the local file system of the RTXPS server (/acad2/RISC/models/bin) and run using rtxps function run_executable.

Input files are to be created using rtxps function set_input, see above.

Input files are created on the basis of existing template files. Template files are supposed to be complete.

Output files can be read using rtxps function read_output. Template, input, and output files consist of descriptor names, descriptors values and optionally units: 

    Spill_duration          2               min
Feed_rate               45.8            l/s
Storage_temperature     0               oC
Fire_type               pool
Confinement             no
Pool_diameter           2.5             m

Models currently implemented (R1.3)

Current implementation includes three models using this interface strategy. They available operational models are:
  1. BLAST: explosion model
  2. PUFF: dynamic atmospheric dispersion
  3. FIRE: checmial fire model
  4. BLTM: dynamic river spill model

BLAST: steady-state explosion model

Blast is a simple explosion model based on a TNT equivalent explsive mass approach. It uses the following input descriptors and default, example data: 
substance_name          JP-5 
Explosive_mass          1000            kg
Blast_Strength          2
The corresponding outputs are stored in the descriptors: 
exposed_area 110.25 ha
exposed_population 707
and it generates 3 images available to the HTML display functions:
  • pressure_field /risc/pressure_field.gif
  • pressure_distribution /risc/pressure_distribution.gif
  • blast_summary /risc/blast_summary.gif

PUFF: dynamic multi-puff atmospheric dispersion model

This is an implementation of the US EPA INPUFF 4.2 model, using the DWM diagnostic wind model as a pre-processor.

The input descriptors in the template area: 

Domain_size             5000            m
Resolution              25              m
Time_step               1               min
Total_duration          1               hour
Source_x                1407            m
Source_y                2411            m
Source_height           1               m
Source_diameter         0.1             m
Gas_velocity            1               m
Gas_temperature         23              Deg C
Wind_speed              1               m/s
Wind_direction          245             deg
Stability_class         2
Air_temperature         23              Deg C
Inversion_height        1000            m
emission_ts             /acad2/RISC/models/data/puff
output_template         /var/www/html/risc/template.dat
output_config           /var/www/html/risc/output/kbm.dat

Puff model generates a time series of result rasters. They are located according to the information in output template. Puff model generates output configuration file which is used by result viewers. Ooutput configuration file is a copy of output template with the exception of number of rows and columns which are apdated (according to Domain_size and Resolution).

The time series of the model results can be viewed by a Java applet that provides dynamic and user controlled animation.

FIRE: steady-state chemical fire model

Fire is a steady-state fire model originally developed by SYRECO. It uses the following input descriptors: 
Spill_duration          2               min
Feed_rate               45.8            l/s
Storage_temperature     0               oC
Fire_type               pool
Confinement             no
Pool_diameter           2.5             m
Trench_length           20.0            m
Trench_width            3.0             m
Trench_orientation      0.0             deg
Base_level              0.0             m
Wind_speed              1.0             min
Wind_direction          0.0             deg
Air_temperature         20.0            oC
Air_humidity            50.0            %
It output descriptors are: 
exposed_area 1875 m2
exposed_population 5
total_mass 198.6 t
hight_of_fire 12.7 m
and it generates 3 images:
  • temperature_field /risc/temperature_field.gif
  • temperature_distribution /risc/temperature_distribution.gif
  • summary /risc/summary.gif

BLTM: dynamic aquatic dispersion model

The BLTM model uses a single input file, and generates both an output file with numerical results and a parallel set of PNG images, one for each time step.

Please note that the current version is not fully integrated, but is available as a stand-alone model for local use.

Input data file

TEST EXAMPLE FOR DISCHARGE INPUT MODE 1. RENAME THIS FILE TO INPUT.IN


Number of substances: 1
Number of grid points: 30
Number of time steps: 20
Time step size(minutes): 0.5
Dissolved oxygen tracing (1/0 - yes/no): 0
Oil modeling (1/0 - yes/no): 1

	SUBSTANCE AND SPILL DATA
Duration: 10
Disp. coeff.: 0.5
Discharge input mode: 1
Subst.N    Label    Decay    Density    Thickness (mm)
  1        Sub1     0          8e5           0.1

	     DISCHARGE
Time step  Sub1
  1        20000.0
  2        20000.0
  3        20000.0
  4        20000.0
  5        20000.0
  6        20000.0
  7        20000.0
  8        20000.0
  9        10000.0
 10        5000.0

	  FLOW DATA
Surface speed at the inflow(m/s): 0.4
Fraction coefficient: 0.75
Grid N     Dist.      H       TW       BW
  1        0.0       5.0     5.0      5.0
  2       10.0       5.0     5.0      5.0
  3       20.0       5.0     5.0      5.0
  4       30.0       5.0     5.0      5.0
  5       40.0       5.0     5.0      5.0
  6       50.0       5.0     5.0      5.0
  7       60.0       5.0     5.0      5.0
  8       70.0       5.0     5.0      5.0
  9       80.0       5.0     5.0      5.0
  10      90.0       5.0     5.0      5.0
  11     100.0       5.0     5.0      5.0
  12     110.0       5.0     5.0      5.0
  13     120.0       5.0     5.0      5.0
  14     130.0       5.0     5.0      5.0
  15     140.0       5.0     5.0      5.0
  16     150.0       5.0     5.0      5.0
  17     160.0       5.0     5.0      5.0
  18     170.0       5.0     5.0      5.0
  19     180.0       5.0     5.0      5.0
  20     190.0       5.0     5.0      5.0
  21     200.0       5.0     5.0      5.0
  22     210.0       5.0     5.0      5.0
  23     220.0       5.0     5.0      5.0
  24     230.0       5.0     5.0      5.0
  25     240.0       5.0     5.0      5.0
  26     250.0       5.0     5.0      5.0
  27     260.0       5.0     5.0      5.0
  28     270.0       5.0     5.0      5.0
  29     280.0       5.0     5.0      5.0
  30     290.0       5.0     5.0      5.0

	DISSOLVED OXYGEN DATA
Initial DO concentration: 50
Oxygen consumption period (min): 1

Subst.N    Oxygen consumption
  1              5.00
  2              3.00

 


© Copyright 1995-2012 by:   ESS   Environmental Software and Services GmbH AUSTRIA | print page