52'265W*UDSK$GPLQLVWUDWRU¶V0DQXDO
Yaroslav Sorokin
$SULO
,QVWLWXWHRI0DWKHPDWLFDO0DFKLQHVDQG6\VWHPV
&\EHUQHWLFV&HQWUH,006&&.LHY8NUDLQH
)RUVFKXQJV]HQWUXP.DUOVUXKH*PE+
,QVWLWXWIU.HUQXQG(QHUJLHWHFKQLN
RtGraph Administrator’s Manual
Page 2/26
&RQWHQWV
1
General notes..................................................................................................................3
1.1
What is RtGraph?....................................................................................................3
1.2
Who is RtGraph’s Administrator.............................................................................5
2
Administrating of RTTF Data Providers .........................................................................6
2.1
Knowledge about RODOS Real-Time DataBase (RTDB) .......................................7
2.1.1
Classification of the RTDB measured data ......................................................7
2.1.2
Data used for the model input..........................................................................7
2.1.3
Selection of data by RtGraph...........................................................................7
2.2
How to start analysis and visualization for new RTTF data provider .......................8
2.2.1
Configuration ..................................................................................................8
2.2.2
Manual test .....................................................................................................8
2.2.3
Automatic mode..............................................................................................8
2.3
How to start analysis and visualization of depot data for new RTTF data provider ..8
3
Administrating of Near-range Numerical Weather Forecast ..........................................10
4
Administrating of Far-range Numerical Weather Forecast ............................................10
5
Administrating of RODOS Automatic Mode Diagnose and Comparison.......................11
5.1
Configuration and test...........................................................................................11
5.2
How to run RtGraph automatically........................................................................11
5.2.1
Running RtGraph from crontab .....................................................................11
5.2.2
Running RtGraph from RODOS SystemController........................................12
6
Administrating of RtGraph’s Workspaces.....................................................................12
6.1
What is RtGraph workspace? ................................................................................12
6.2
Why RtGraph needs workspaces? .........................................................................12
6.3
Types of workspaces.............................................................................................13
6.4
How to define workspace......................................................................................15
6.4.1
swr-file..........................................................................................................15
6.4.2
wor-file .........................................................................................................16
6.4.2.1 How to add own map.................................................................................16
6.5
Examples of RtGraph’s workspaces. .....................................................................17
6.6
How to create simplest workspace for my RTTF data provider .............................17
7
Administrating of RtGraph’s Time Shedule ..................................................................18
7.1
Example of crontab:..............................................................................................18
7.2
How to stop warning e-mailing .............................................................................19
7.3
How to replace warning e-mailing by logging .......................................................19
8
Installation and testing ..................................................................................................20
8.1
Prerequisite things.................................................................................................20
8.2
Running installation and testing procedures ..........................................................20
8.2.1
Test of comparison of measurements and calculations in depot mode............21
8.2.1.1 Prerequisite things .....................................................................................21
8.2.1.2 Configuration ............................................................................................21
9
How to uninstall RtGraph .............................................................................................22
10
RTTF description......................................................................................................23
10.1 Language definition section ..................................................................................23
10.2 Parameters definition section ................................................................................23
10.2.1 one parameter definition section....................................................................23
10.2.1.1
parameter’s ID.......................................................................................23
10.2.1.2
parameter’s name ..................................................................................23
10.2.1.3
parameter’s level (height) ......................................................................23
10.2.1.4
parameter’s aggregation type .................................................................23
10.2.1.5
parameter’s unit .....................................................................................23
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 3/26
10.2.1.6
parameter’s medium ..............................................................................23
10.2.1.7
parameter’s object .................................................................................24
10.2.1.8
parameter’s sample time in minutes .......................................................24
10.3 Measurements section...........................................................................................24
10.3.1 One-provider-one-time measurements section ...............................................24
10.3.1.1
provider definition string .......................................................................24
10.3.1.1.1 provider’s ID .....................................................................................24
10.3.1.1.2 provider’s Name ................................................................................24
10.3.1.1.3 provider’s interval of measurements ..................................................24
10.3.1.1.4 provider’s number of stations in the measurements section ................24
10.3.1.2
time of provided measurements .............................................................24
10.3.1.3
stations-related measurements ...............................................................25
10.3.1.3.1 One-provider-one-time-one-station section ........................................25
10.3.1.3.1.1 Station’s definition string ............................................................25
10.3.1.3.1.1.1 station’s ID...........................................................................25
10.3.1.3.1.1.2 station’s name ......................................................................25
10.3.1.3.1.1.3 station’s longitude ................................................................25
10.3.1.3.1.1.4 station’s latitude ...................................................................25
10.3.1.3.1.1.5 station’s sealevel ..................................................................25
10.3.1.3.1.1.6 station’s code 1 ....................................................................25
10.3.1.3.1.1.7 station’s code 2 ....................................................................25
10.3.1.3.1.1.8 station’s number of levels.....................................................26
10.3.1.3.1.2 section of the level-related measurements ...................................26
10.3.1.3.1.2.1 string of level-related measurements.....................................26
10.3.1.3.1.2.1.1 number of measured parameters on the level..................26
10.3.1.3.1.2.1.2 height of the level ..........................................................26
10.3.1.3.1.2.1.3 measurements part.........................................................26
7DEOHRIILJXUHV
Figure
Figure
Figure
Figure
Figure
1 Example of site related workspaces .......................................................................13
2 Example of site related workspaces: analog of RODOS GRID...............................14
3 Example of administrative border workspace.........................................................14
4 Example of Provider – related workspace (blue points – points of measurements) .15
5 Example of definition of RtGraph’s workspace: Provider mast; site FZK ..............17
*HQHUDOQRWHV
:KDWLV5W*UDSK"
RtGraph is GRFXPHQWEDVHGVXEV\VWHP of RODOS which permanently produces documents
on the base of analysis of data from radiological and meteoroligical monitoring.
RtGraph produces documents in HTML format and documents which can be imported to
geographical information systems (GIS).
RtGraph produces documents on the base of analysis of input data which can be one of the
four types:
• Far-range Numerical Weather Forecasts in WMO GRIB format;
• Near-range Numerical Weather Forecasts in RODOS LSMC model format;
• radiological and meteoroligical data in RODOS-specific RTTF format;
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
•
Page 4/26
RODOS automatic mode calculations. (RtGraph produces documents about
FRPSDULVRQRIPHDVXUHPHQWVDQGFDOFXODWLRQV of RODOS when RODOS works in
automatic mode.)
RtGraph works 24 hours every day according to RtGraph‘s time-schedule. The time
schedule includes information about time when RtGraph must look for new data (minutes,
hours, days for every provider).
RtGraph does not require any activities from RODOS operator; it works standalone as
underground process (on the base of defined time-schedule).
RtGraph sends e-mail messages to rodos user in case of errors.
All documents are managed in RtGraph‘s document storage.
User interact with RtGraph by accessing RtGraph‘s document storage through standard
HTML browser or standard GIS browser.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 5/26
:KRLV5W*UDSK¶V$GPLQLVWUDWRU
RtGraph’s administrator is user of workstation where RODOS system installed. RtGraph’s
administrator is user with basic knowledge about RODOS and HP-UNIX.
RtGraph’s administrator must read RODOS RtGraph User’s Manual for begin.
Main tasks of RtGraph’s administrator are customization and maintain.
All customization and maintain tasks are described in this manual. The tasks are:
Installation and testing (chapter 8),
Administrating of RTTF Data Providers (chapter 2),
Administrating of Near-range Numerical Weather Forecast (chapter 3),
Administrating of Far-range Numerical Weather Forecast (chapter 4),
Administrating of RODOS Automatic Mode Diagnose and Comparison (chapter 5),
Administrating of RtGraph’s Time Shedule (chapter 7).
RtGraph’s administrator must read chapter 7 Administrating of RtGraph’s Time Shedule for
customization of any data provider. Other mentioned chapters (2 Administrating of RTTF
Data Providers, 3 Administrating of Near-range Numerical Weather Forecast, 4
Administrating of Far-range Numerical Weather Forecast, 5 Administrating of RODOS
Automatic Mode Diagnose and Comparison) are independent.
Additionally to the task defined in the mentioned chapters, RtGraph’s administrator must
read the diagnostic e-mail messages and fix the problems (RtGraph sends diagnostic e-mail
messages in case of any error).
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 6/26
$GPLQLVWUDWLQJRI577)'DWD3URYLGHUV
RtGraph intended for analysis and visualization of data from real-time RTTF data providers.
577) is used in RODOS format of files for import of data from monitoring network (from
data providers). RTTF format description exists in section 0 Step 3.
Run RODOS for site FZK, start automatic mode run. (You will find details in document
52'268VHU*XLGH6\VWHP,QWHUIDFH
6WHS
~rodos/rortg/step1
GDWH > .fnewer_run
GDWH > .fnewer
FG
PGWQDGVK
Output of the last command must include no error messages.
6WHS
Add 1mdtnad.sh to crontab.
Run FURQWDE –e rodos
and append “* * * * * cd ~rodos/rortg/tmp; ~rodos/rortg/step1/1mdtnad.sh >>~rodos/rolog/rocomp
2>>~rodos/rolog/rocomperr” in the cron table.
1RWH 6WHSmust be started LPPHGLDWHO\ after 6WHS
6.
$mkdir ~rodos/public_html; cd ~rodos/public_html; ln –s ../rortg/public public
6WHS
Step 7.Acceptance test.
During 10-30 minutes following file must be created:
~rodos/public/rocomp/NUserNRuns.html. (You can access the page through HTML browser.
You will find details about the page in chapter about Comparison in RtGraph User’s Manual).
How to uninstall RtGraph
6WHS Remove tasks from crontab.
Run FURQWDE –e rodos and remove from the cron table all lines which include substring
“~rodos/rortg”.
Make backup of all files which where created by RtGraph administrator(s) during
customization of RtGraph.
6WHS Remove ~rodos/rortg, if you have the directory.
6WHS
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 7/26
RTTF description.
Before starting RtGraph administration tasks with own (not included in distributive) RTTF
data provider you must make all necessary steps for customization of the RTTF data provider
in RODOS real-time database (see ?RTDB MANUAL?).
You will find basic knowledge about RODOS real-time database in the next section. The
knowledge is necessary for administration of RtGraph.
.QRZOHGJHDERXW52'265HDO7LPH'DWD%DVH57'%
&ODVVLILFDWLRQRIWKH57'%PHDVXUHGGDWD
RODOS incorporates real-time data and depot; they are stored in the form of by-pass data and
database data. %\SDVVGDWD and GDWDEDVHGDWD are classifications of the type of storing
(archiving) measured data. 'DWDEDVHGDWD are stored into the data base management system
(for example Allbase-SQL); access to the data is only possible in the form of requests to the
data base management system. %\SDVVGDWD are stored as rttf files. %\SDVVGDWD are
classified as GHSRWGDWD and UHDOWLPHGDWD. %\SDVVUHDOWLPHGDWDare data received from
the monitoring system. %\SDVVGHSRWGDWD are data which were emulated by the RODOS
ronetservice. %\SDVVGHSRWGDWD are stored into the directory
…/ronet/datdepot/0\3URYLGHU. %\SDVVUHDOWLPHGDWDDUHstored into the directory
…/ronet/rorttf/0\3URYLGHU.
Relations between the two classifications are shown in the table:
type of storing
data type
stored under
By-pass
Real-time
…/ronet/rorttf/0\3URYLGHU
Depot
…/ronet/datdepot/0\3URYLGHU
Database
Real-time
in database and in
/ronet/rorttf/0\3URYLGHU
Current data (new or from depot) always are available under …/ronet/rorttf/0\3URYLGHU or in
…/ronet/datdepot/0\3URYLGHU. In the case of by-pass-only mode (roautoconfig->access
mode=1), the database is not loaded (only rttf files exist). In the case of roautoconfig->access
mode=0, both database and rttf files (in …/ronet/rorttf/provider) exist.
'DWDXVHGIRUWKHPRGHOLQSXW
In the case of depot mode, the ronetservice puts old (depot) data into directory
.../romess/lsmc.dat/ for each new run. In the case of the real-time mode, the last available data
set from …/ronet/rorttf/0\3URYLGHU will be used for model input (stored in the directory
.../romess/lsmc.dat/ ).
6HOHFWLRQRIGDWDE\5W*UDSK
During each run of RtGraph, it looks into …/ronet/rorttf/0\3URYLGHU, selects from the 24hour data new files (files created after the previous run of the RtGraph) and creates documents
for the new files.
In depot mode, RtGraph will not find new data under …/ronet/rorttf/0\3URYLGHU.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 8/26
+RZWRVWDUWDQDO\VLVDQGYLVXDOL]DWLRQIRUQHZ577)GDWD
SURYLGHU
If you started the section then it means you make all necessary steps for customization of new
RTTF data provider in RODOS real-time database. Otherwise see begin of chapter 2
Administrating of RTTF Data Providers.
Now you have RTTF data provider with abbreviation 0\3URYLGHUThe same abbreviation
used in real-time database: ~rodos/ronet/rorttf/0\3URYLGHU is directory for real-time data
delivered from the provider and ~rodos/ronet/datdepot/0\3URYLGHUis directory for depot
data for the provider).
&RQILJXUDWLRQ
(See sections 6 Administrating
of RtGraph’s Workspaces for general information and section 6.4 How to define workspace
for necessary steps and section 6.6 How to create simplest workspace for my RTTF data
provider for quick start.)
6WHS. Create new directory for documents for the provider in
~rodos/rortg/public/msrmnts/0\3URYLGHU.
(mkdir ~rodos/rortg/public/msrmnts/0\3URYLGHU)
6WHS Copy file ~rodos/rortg/step8/lnwp.js to ~rodos/rortg/public/msrmnts/0\3URYLGHU
(the directory was created in Step 2.)
(cp ~rodos/rortg/step8/lnwp.js ~rodos/rortg/public/msrmnts/0\3URYLGHU)
6WHS Create settings for the provider (0\3URYLGHU.sh and .0\3URYLGHU.sh):
6WHS 'HILQHDWOHDVWRQHZRUNVSDFHIRUWKHGDWDSURYLGHU
1.
cd ~rodos/rortg/step7
2. cp ./pr1.sh ./0\3URYLGHU.sh
3. Edit ./0\3URYLGHU.sh: change "Chrtct=SU" to "Chrtct=0\3URYLGHU"
4. cp ./.prset.sh ./0\3URYLGHU.sh
6WHS.
1. mkdir ~rodos/rortg/wd/0\3URYLGHU
2. cp ~rodos/rortg/step8/set.sh ~rodos/rortg/wd/0\3URYLGHU
0DQXDOWHVW
Run following command for manual (not automatic) test:
~rodos/rortg/step7/0\3URYLGHU.sh
In case of any error you will see diagnostic messages.
In case of success new documents will be stored in
~rodos/rortg/public/msrmnts/0\3URYLGHU.
$XWRPDWLFPRGH
Add new entry to crontab. (See section 7 Administrating of RtGraph’s Time Shedule for
details.)
crontab –e
59 * * * * ~rodos/rortg/step7/0\3URYLGHU.sh
Modify ~rodos/rortg/public/msrmnts/prvdrs_and_times.html: add new link (see
examples in prvdrs_and_times.html).
+RZWRVWDUWDQDO\VLVDQGYLVXDOL]DWLRQRIGHSRWGDWDIRUQHZ
577)GDWDSURYLGHU
. Make all necessary configuration in accordance with 2.2 How to start analysis and
visualization for new RTTF data provider.
6WHS
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 9/26
.
6WHS
•
•
•
mkdir ~rodos/public/msrmnts/0\3URYLGHUBdepot
cp ~rodos/rortg/step8/lnwp.js ~rodos/rortg/public/msrmnts/0\3URYLGHUBdepot
cd ~rodos/rortg/step7; ln -s 0\3URYLGHU.sh 0\3URYLGHU _depot.sh
6WHS. Every time when new depot data available for the provider 0\3URYLGHU (in directory
~rodos/ronet/datdepot/0\3URYLGHU) run nanually: ~rodos/rortg/step7/0\3URYLGHU_depot.sh
–depot
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 10/26
$GPLQLVWUDWLQJRI1HDUUDQJH1XPHULFDO:HDWKHU
)RUHFDVW
•
•
•
•
•
cd ~rodos/rortg/step7
cp examples/lnwp.sh Edit lnwp.sh: check "RtgLctn=..." (RtgLctn must be equal to ~rodos/rortg)
cp examples/ lnwp.sh 5XQPDQXDOWHVW~rodos/rortg/step7/lnwp.sh (In case of any error you will see
diagnostic messages.)
. Add new entry to crontab. (See section 7 Administrating of
RtGraph’s Time Shedule for details.)
crontab –e
00 01 * * * ~rodos/rortg/step7/lnwp.sh
+RZWRUXQLQDXWRPDWLFPRGH
$GPLQLVWUDWLQJRI)DUUDQJH1XPHULFDO:HDWKHU)RUHFDVW
•
•
•
•
•
cd ~rodos/rortg/step7
cp examples/gnwp.sh Edit lnwp.sh: check "RtgLctn=..." (RtgLctn must be equal to ~rodos/rortg)
cp examples/gnwp.sh 5XQPDQXDOWHVW~rodos/rortg/step7/gnwp.sh (In case of any error you will see
diagnostic messages.)
• $XWRPDWLFPRGH. Add new entry to crontab. (See section 7 Administrating of
RtGraph’s Time Shedule for details.)
crontab –e
00 06 * * * ~rodos/rortg/step7/gnwp.sh
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 11/26
$GPLQLVWUDWLQJRI52'26$XWRPDWLF0RGH'LDJQRVH
DQG&RPSDULVRQ
&RQILJXUDWLRQDQGWHVW
Step 1.
cd ~rodos/rortg/step1
Make link: dcomp -> ~rodos/rocomp
Step 2. Manual test.
Run ~rodos/rortg/step1/1mdtnad.sh (it is first run).
First run (of ~rodos/rortg/step1/1mdtnad.sh) wiil create file .fnewer; HTML pages will not be
created.
Wait until finishing of cycle of RODOS run in automatic mode.
Run again (second time) ~rodos/rortg/step1/1mdtnad.sh.
HTML page ~rodos/rortg/step1/rocomp/NUserNRuns.html will be created.
+RZWRUXQ5W*UDSKDXWRPDWLFDOO\
The execution of of RtGraph (~rodos/rortg/step1/1mdtnad.sh) can be performed by two
methods:
1. Configuration of crontab for execution of 5W*UDSK after a delay of a specified time-step
(e.g. 1 minute. (see 5.2.1 Running RtGraph from crontab). Start from this case.
2. Creating the file ‘UWJUDSKFIJ‘ in the directory µ52'26B',5URHQYGLUDSSORSWLRQV‘.
RtGraph will be executed by SystemController in this case. (see 0 Example 1:
3. $crontab –e
* * * * * cd ~rodos/rortg/tmp; ~rodos/rortg/step1/1mdtnad.sh>>~rodos/rolog/rtgCompOut
!!aURGRVURORJUWJ&RPS(UU
RtGraph will look for new RODOS calculations every minute.
Example 2:
FURQWDE –e
0,10,20,30,40,50 * * * * cd ~rodos/rortg/tmp;
~rodos/rortg/step1/1mdtnad.sh>>~rodos/rolog/rtgCompOut!!aURGRVURORJUWJ&RPS(UU
RtGraph will look for new RODOS calculations every 10 minutes. You will wait for new
HTML-pages longer but it is better for system performance.
5. Running RtGraph from RODOS SystemController)
5XQQLQJ5W*UDSKIURPFURQWDE
Delete or rename file µ52'26B',5URHQYGLUDSSORSWLRQV‘ ()
Add new entry to crontab. (See section Administrating of RtGraph’s Time Shedule for
details.)
Example 1:
crontab –e
* * * * * cd ~rodos/rortg/tmp; ~rodos/rortg/step1/1mdtnad.sh!!aURGRVURORJUWJ&RPS2XW!!
aURGRVURORJUWJ&RPS(UU
RtGraph will look for new RODOS calculations every minute.
Example 2:
crontab –e
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 12/26
0,10,20,30,40,50 * * * * cd ~rodos/rortg/tmp;
~rodos/rortg/step1/1mdtnad.sh!!aURGRVURORJUWJ&RPS2XW!!aURGRVURORJUWJ&RPS(UU
RtGraph will look for new RODOS calculations every 10 minutes. You will wait for new
HTML-pages longer but it is better for system performance.
5XQQLQJ5W*UDSKIURP52'266\VWHP&RQWUROOHU
Remove call of RtGraph from crontab ().
Create file µ52'26B',5URHQYGLUDSSORSWLRQVUWJUDSKFIJ‘.
Create the file ‘UWJUDSKFIJ‘ in the directory µ52'26B',5URHQYGLUDSSORSWLRQV‘.
The advantage of using this file is the user-dependent configuration of calling
of
. If this file exists RtGraph will be called by the SystemController. The format
and the options to call 5W*UDSKare described below:
5W*UDSK
)RUPDW
UserId: option
3 options are possible to configure the call of RtGraph during an automatic run of the user
‘UserId‘
option1: synchron “call RtGraph in the synchronous mode“
option2: backward “call RtGraph“ in the backward and synchronous mode“
option3: no
“RtGraph will not be call by the SystemController“
Example:
rodos : synchron
The SystemController calls RtGraph every cycle during the automatic run in the
synchronous mode. Logging available in ~rodos/rolog/rocomp*.
$GPLQLVWUDWLQJRI5W*UDSK¶V:RUNVSDFHV
:KDWLV5W*UDSKZRUNVSDFH"
RtGraph workspace is geographical area inside of a bounding rectangle and information for
analysis and visualization of data inside of the area. Bounding rectangle defined as four real
numbers: minimum and maximum values of latitude and longitude.
:K\5W*UDSKQHHGVZRUNVSDFHV"
RtGraph intended to work 24 hours every day in DXWRPDWLFPRGH. It does not require any
activities from RODOS operator; it works VWDQGDORQHDVXQGHUJURXQGSURFHVV. Results of
RtGraph‘s work are documents (HTML, geographically related images and documents of
other standard formats). Any document can include analysis RQO\IRUFOHDUO\GHILQHG
JHRJUDSKLFDODUHD. This area defined in workspace. Workspace definition includes also
information about geographical maps and geographical objects attributes.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 13/26
7\SHVRIZRUNVSDFHV
From what reasons the bounding rectangle is defined?
Bounding rectangle may be defined on the base of administrative borders (country, land, etc.);
on the base of area covered by point of measurements of a monitoring data provider; on the
base of areas which are closed to nuclear power plant; or on the base of other user
preferences.
There are four types of workspaces in current RtGraph distribution:
• (NPP) site – related workspaces;
• provider related workspaces;
• administrative border workspaces;
• defined by user workspaces.
)LJXUH([DPSOHRIVLWHUHODWHGZRUNVSDFHV
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
)LJXUH([DPSOHRIVLWHUHODWHGZRUNVSDFHVDQDORJRI52'26*5,'
)LJXUH([DPSOHRIDGPLQLVWUDWLYHERUGHUZRUNVSDFH
6/9/2004 3:10 a10/p10
Page 14/26
RtGraph Administrator’s Manual
Page 15/26
)LJXUH([DPSOHRI3URYLGHU±UHODWHGZRUNVSDFHEOXHSRLQWV±SRLQWVRIPHDVXUHPHQWV
+RZWRGHILQHZRUNVSDFH
RtGraph intended for analysis and visualization of data from real-time data provider. During
processing of new data from the provider RtGraph looks for workspaces which where defined
for the provider. Every real-time data provider has XQLTXHabbreviation in RODOS real-time
database (like imis, mast, etc). All workspaces for all real-time data providers are stored in
separate directory (~rodos/rortg/wor).
VZUILOH
All workspaces for the real-time data provider enumerated in VZUILOH
If the real-time data provider has abbreviation 0\3URYLGHU then all workspaces for the
provider must be defined in file
~rodos/rortg/wor/0\3URYLGHU/0\3URYLGHU.swr.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 16/26
This file (VZUILOH) must include at least one row. Every row consists from four columns
separated by space: ERXQGLQJUHFWDQJOH; PDSOD\HUVILOH; QDPHRIZRUNVSDFH; SDUHQW
ZRUNVSDFH.
%RXQGLQJUHFWDQJOH defined in the form X1/X2/Y1/Y2(where X1 is minimum longitude; X2
is maximum longitude; Y1 is minimum longitude; Y2 is maximum longitude).
0DSOD\HUVILOH points to file (ZRUILOH) with definition of geographical layers (maps) which
objects must be drawn in addition to data from the provider. For example, in addition to
visualization of points with measurements of gamma dose rate, administrative borders must
be visualized. Format of the file described in section 6.4.2 wor-file.
1DPHRIZRUNVSDFH is descriptive name of the workspace.
3DUHQWZRUNVSDFH is name of workspace of the same type which fully cover this
(sub)workspace (or string “QR”).
ZRUILOH
Wor-file (or map layers file) defines all base maps. Base maps are geographical layers (maps)
which must be drawn in addition to geographical objects (points, polylines, poligones) which
produces in result of analysis of data from the provider. For example, in addition to
visualization of points with measurements of gamma dose rate, administrative borders must
be visualized.
The file includes one row for one layer. Every row consists from four columns: JHRJUDSKLFDO
REMHFWVILOHQDPH, line’s width, line’s color, line’s type (solid, doted, etc.). Only first column
must be specified for every row; other columns (line’s width, line’s color, line’s type) are
optional.
*HRJUDSKLFDOREMHFWVILOHQDPH is name of the file with geographical objects (polylines or
polygons). It is one of the files from 52'26FRPPXQLW\FRPPRQPDS. The files located in
directory ~rodos/rortg/wor/europe:
wor/europeHXUBOPLI - the country boundary;
wor/europeHXUBSPLI - the province boundary;
wor/europeHXUBZPLI - the water boundaries;
wor/europeHXUBFPLI - the city boundaries;
wor/europeHXUBUBSPLI(points of intersections), wor/europeHXUBUBUPLI
- RAILS;
wor/europeHXUBSJHVPLI(points of intersections), wor/europeHXUBUJHVPLI - ROADS.
The files have extension “.mif” but it is not MapInfo interchange format; it is RODOS
internal format (in accordance with license agreement the map may be distributed only in
RODOS internal format).
+RZWRDGGRZQPDS
You can use own map during definition of own 6.4.2 wor-file.
Step 1. 6HOHFWOD\HUVLQ0,)ILOHV. You need MIF (MapInfo interchange format) file for every
layer. If you have ESRI shape –files then convert the shape files to MIF-files.
Step 2. Create directory for your files. Create directory ~rodos/rortg/wor/P\ODQG (use any
name instead of³P\ODQG´).
Step 3. Convert files. For every MIF-file complete Step 4.
Step 4. Convert one MIF-file.
Put your MIF file in the directory ~rodos/rortg/wor/P\ODQG (see Step 2).
Note: You do not need MID-file.
If name of your file is P\PLI then runs the command: $gzip my.mif. (gzip – GNU Zip must
be in your PATH). my.mif.gz will be created. run the command: $mv my.mif.gz my.mif.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 17/26
([DPSOHVRI5W*UDSK¶VZRUNVSDFHV
URUWJ
ZRU
HXURSH
eur4_pges.mif
eur4_rges.mif
eur_c.mif
eur_l.mif
eur_p.mif
eur_r_p.mif
eur_r_r.mif
eur_w.mif
layers.ys.TXT
LPLV
PDVW
PDVWZRU
wor/europe/eur_p.mif
PDVWVZU
&R QWHQWVRIPDVWVZUILOH
8.1/8.7/49/49.4
wor/mast/mast.wor
7.1758/9.6758/48.2925/49.8925 wor/de_sites/FZK-Mast_rect4.wor
7.61/9.218/48.56/49.6154
wor/mast/FZK-Mast_rect3.wor
7.94/8.906/48.7744/49.4087
wor/mast/FZK-Mast_rect2.wor
8.2673/8.5846/48.9882/49.1967 wor/mast/FZK-Mast_rect1.wor
"MAST_measurements___" "no"
"FZK-Mast(site-related_workspace)_rect4_" "no"
"FZK-Mast(site-related_workspace)_rect.3_" "no"
"FZK-Mast(site-related_workspace)_rect.2_" "no"
"FZK-Mast(site-related_workspace)_rect.1_" "no"
)LJXUH([DPSOHRIGHILQLWLRQRI5W*UDSK¶VZRUNVSDFH3URYLGHUPDVWVLWH)=.
Figure 5 includes contents of swr file for provider PDVW and related files.
The swr file (~rodos/rortg/wor/PDVW.swr) includes 5 lines (5 subworkspaces):
Boundind rectangle
8.1/8.7/49/49.4
7.1758/9.6758/48.2925/49.8925
7.61/9.218/48.56/49.6154
7.94/8.906/48.7744/49.4087
8.2673/8.5846/48.9882/49.1967
Wor-file
ZRUPDVWPDVWZRU
wor/de_sites/FZK-Mast_rect4.wor
wor/mast/FZK-Mast_rect3.wor
wor/mast/FZK-Mast_rect2.wor
wor/mast/FZK-Mast_rect1.wor
Name of workspace
"MAST_measurements___"
"FZK-Mast(site-related_workspace)_rect4_"
"FZK-Mast(site-related_workspace)_rect.3_"
"FZK-Mast(site-related_workspace)_rect.2_"
"FZK-Mast(site-related_workspace)_rect.1_"
Parent
"no"
"no"
"no"
"no"
"no"
First workspace (defined at the first line in PDVW.swr) refers to layers file
~rodos/rortg/ZRUPDVWPDVWZRU
The layers file includes one layer (wor/europe/eur_p.mif); it means geographical objects
from ~rodos/rortg/wor/europe/eur_p.mif will be used (it is province boundary in accordance
with 6.4.2 wor-file).
Other wor-files (for other 4 workspaces) are not defined on the Figure 5.
+RZWRFUHDWHVLPSOHVWZRUNVSDFHIRUP\577)GDWDSURYLGHU
Let us you have RTTF data provider with abbreviation 0\3URYLGHUThe same abbreviation
used in real-time database: ~rodos/ronet/rorttf/0\3URYLGHU is directory for real-time data
delivered from the provider and ~rodos/ronet/datdepot/0\3URYLGHUis directory for depot for
the provider).
6WHS.Create directory ~rodos/rortg/wor/0\3URYLGHU.
6WHS. Create file ~rodos/rortg/wor/0\3URYLGHU0\3URYLGHU.swr. Write the line in
0\3URYLGHU.swr:
X1/X2/Y1/Y2 wor/0\3URYLGHU0\3URYLGHU.wor “0\3URYLGHU-workspace” “no”
.
Note: X1/X2/Y1/Y2 – real numbers (for example 8.1/8.7/49/49.4).
Please: no spaces between X1/X2/Y1/Y2.
6WHS. Create file ~rodos/rortg/wor/0\3URYLGHU0\3URYLGHU .wor. Write the line in
0\3URYLGHU.wor:
wor/europe/eur_p.mif
.
It is all: province boundaries (wor/europe/eur_p.mif) will be drawn in addition to visualization
of data from RTTF data provider with abbreviation 0\3URYLGHU.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 18/26
$GPLQLVWUDWLQJRI5W*UDSK¶V7LPH6KHGXOH
RtGraph uses crontab for time shedule.
You will find detailed description about usage of crontab in UNIX man pages (run man
crontab on your HP-UX workstation);
There is an example of the (rodos) user's crontab files in the directory ~rodos/rortg/step7.
The file is .rtgcron.tab.
You can schedule RtGraph by running the command "crontab .rtgcron.tab"
If you received a message like
"crontab: you are not authorized to use cron. Sorry.",
then read hp-ux manual pages for crontab(1) again or contact your system administrator.
([DPSOHRIFURQWDE
00 01 * * * ~rodos/rortg/step7/lnwp.sh
00 00,06 * * * ~rodos/rortg/step7/gnwp.sh
01,11,21,31,41,51 * * * * ~rodos/rortg/step7/mast.sh
* * * * * ~rodos/rortg/step1/1mdtnad.sh
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 19/26
+RZWRVWRSZDUQLQJHPDLOLQJ
RtGraph sends e-mail messages to rodos user in case of errors. If you want to stop the service,
then you have to append “>/dev/null 2>/dev/null” to every string (or to selected string) in
crontab.
Example:
00 01 * * * ~rodos/rortg/step7/lnwp.sh
00 00,06 * * * ~rodos/rortg/step7/gnwp.sh
01,11,21,31,41,51 * * * * ~rodos/rortg/step7/mast.sh
* * * * * ~rodos/rortg/step1/1mdtnad.sh !GHYQXOO!GHYQXOO
Last process (~rodos/rortg/step1/1mdtnad.sh) – comparison of measurements and calculations
- will not send diagnostic e-mails.
+RZWRUHSODFHZDUQLQJHPDLOLQJE\ORJJLQJ
RtGraph sends e-mail messages to rodos user in case of errors. If you want to stop the service,
then
you
have
to
append
“>~rodos/rolog/rtgComparisonOut
2>~rodos/rolog/rtgComparisonErr” to every string (or to selected string) in crontab.
Example:
00 01 * * * ~rodos/rortg/step7/lnwp.sh
00 00,06 * * * ~rodos/rortg/step7/gnwp.sh
01,11,21,31,41,51 * * * * ~rodos/rortg/step7/mast.sh
* * * * * cd ~rodos/rortg/tmp; ~rodos/rortg/step1/1mdtnad.sh !!aURGRVURORJUWJ&RPS2XW!!
aURGRVURORJUWJ&RPS(UU
Last process (~rodos/rortg/step1/1mdtnad.sh) – comparison of measurements and calculations
- will send diagnostic to log-files.
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 20/26
,QVWDOODWLRQDQGWHVWLQJ
3UHUHTXLVLWHWKLQJV
You have to start unix session as user rodos.
RtGraph must be installed in ~rodos/rortg.
Complete instructions from Chapter 9 How to uninstall RtGraph.
You will need following files for the installation:
• instrtgbin.sh – installation script;
• rortg.tar.gz – RtGraph installation archive;
• test.sh – script for testing of the installation;
• wd_imis_set.sh – other script for testing of the installation.
Put the files in the sub-directory ~rodos/RtGraph of the directory, where RODOS was
installed.
Check for permission attributes of the scripts (all scripts must be executable).
5XQQLQJLQVWDOODWLRQDQGWHVWLQJSURFHGXUHV
Change directory to ~rodos/RtGraph: $chdir ~rodos/RtGraph.
6WHS. Run installation script: $ instrtgbin.sh.
6WHS.Run test script: $test.sh.
1RWH: test.sh is time-consuming procedure. Run it at end of your working day and look for
results at next day.
The output of the testing procedure must be similar to this:
$>instrtgbin.sh ; test.sh
XXX run_GNWP
XXX end of run_GNWP
XXX run_LNWP
XXX end of run_LNWP
XXX run_mast
drwxrwxrwx 2 rodos rogrp
2048 Feb 24 18:04 wor/mast
new data not found (removing
PUBLIC_DIR:/fd1/rodos/rortg/public/msrmnts/mast/24.02.2004..19.33.47)
sort: Cannot open _NT
There are no html-pages (msg.94.96)
The html-page will not be generated: "/fd1/rodos/rortg/public/msrmnts/mast/alltimes.html"
XXX end of run_mast
XXX run_imis
XXX end of run_imis
Copy the output to text file for future analysis.
6WHSCheck for new documents.
If the output of tesh.sh includes
XXX run_GNWP
XXX end of run_GNWP
then check for Far-range numerical weather forecast documents in RtGraph’s document
storage (see RtGraph User’s Manual).
If the output of tesh.sh includes
XXX run_LNWP
XXX end of run_LNWP
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 21/26
then check for Near-range numerical weather forecast documents in RtGraph’s document
storage (see RtGraph User’s Manual).
If the output of tesh.sh includes
XXX run_imis
XXX end of run_imis
then check for documents about measurements from data provider imis in RtGraph’s
document storage (see RtGraph User’s Manual).
Also, check for documents about depot measurements from data provider FZK-mast. (You
will find details in RtGraph User’s Manual).
7HVWRIFRPSDULVRQRIPHDVXUHPHQWVDQGFDOFXODWLRQVLQGHSRW
PRGH
3UHUHTXLVLWHWKLQJV
RODOS was installed and tested in automatic mode (site- FZK, mode depot).
File ~rodos/.rotaskinit includes line which starts with “ronetservice”. This line
(ronetservice) includes option –r dep (“-r dep” means depot mode, alternative value of the
option is “-r realt” – real-time mode).
Example: ronetservice resy13 /fd1/rodos/robin/ronetservice -e /fd1/rodos -r dep NET.
&RQILJXUDWLRQ
6WHS
cd ~rodos/rortg/public
ln -s ~rodos/rocomp rocomp
6WHS
Edit ~rodos/rortg/public/rtdb.html:
replace string
<li><a href="GXPP\KWPO">Diagnose and comparison</a></li>
by the string:
<li><a href="URFRPS18VHU15XQVKWPO">Diagnose and comparison</a></li>
.
6WHS
Run RODOS for site FZK, start automatic mode run. (You will find details in document
52'268VHU*XLGH6\VWHP,QWHUIDFH).
6WHS
cd ~rodos/rortg/step1
date > .fnewer_run
date > .fnewer
1mdtnad.sh
Output of the last command must include no error messages.
6WHS.
Add 1mdtnad.sh to crontab.
Run crontab –e rodos
and append “* * * * * cd ~rodos/rortg/tmp; ~rodos/rortg/step1/1mdtnad.sh >>~rodos/rolog/rocomp
2>>~rodos/rolog/rocomperr” in the cron table.
1RWH: 6WHS must be started LPPHGLDWHO\ after 6WHS.
6WHS
mkdir ~rodos/public_html; cd ~rodos/public_html; ln –s ../rortg/public public
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 22/26
.Acceptance test.
During 10-30 minutes following file must be created:
~rodos/public/rocomp/NUserNRuns.html. (You can access the page through HTML browser.
You will find details about the page in chapter about Comparison in 5W*UDSK 8VHU¶V
0DQXDO).
6WHS
+RZWRXQLQVWDOO5W*UDSK
. Remove tasks from crontab.
Run FURQWDE –e rodos and remove from the cron table all lines which include substring
6WHS
“~rodos/rortg”.
. Make backup of all files which where created by RtGraph administrator(s) during
customization of RtGraph.
6WHS. Remove ~rodos/rortg, if you have the directory.
6WHS
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 23/26
577)GHVFULSWLRQ
This description is valid at 2002-04-07.
/DQJXDJHGHILQLWLRQVHFWLRQ
This section is optional. It does not appears in the by-pass processed rttf-files.
3DUDPHWHUVGHILQLWLRQVHFWLRQ
Is a set of definitions of parameter. Definition of one parameter described in the one
parameter definition section.
The section starts after line “#IDnumber,type,height,aggregation,unit,medium,object,sampletime”.
The section stops before line “\BEGIN_RTT”.
RQHSDUDPHWHUGHILQLWLRQVHFWLRQ
is a line which starts from the ‘#’-sign. It includes , parameter’s ID, parameter’s name,
parameter’s level, parameter’s , parameter’s unit, parameter’s medium, parameter’s sample
time in minutes which are separated by comma; undefined (unknown or unapplicable) fields
are marked as ‘-‘.
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶V,'
unique per computer integer number;
the same parameter (for example temperature of air) on different levels (height) has different
ids.
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶VQDPH
string
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶VOHYHOKHLJKW
integer number
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶VDJJUHJDWLRQW\SH
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶VXQLW
string
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶VPHGLXP
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 24/26
SDUDPHWHU¶VREMHFW
it is nuclide name or similar (dose rate of the nuclide, etc)
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
SDUDPHWHU¶VVDPSOHWLPHLQPLQXWHV
Example: 2'/%UXWWRG>I@X6YK/XIW2'/%UXWWR
0HDVXUHPHQWVVHFWLRQ
Starts from “\BEGIN_RTT”-tag and closed by the “END_RTT”-tag. It includes at least one
One-provider-one-time measurements section.
2QHSURYLGHURQHWLPHPHDVXUHPHQWVVHFWLRQ
includes provider definition string (which includes provider’s attributes and time of provided
measurements) and data - stations-related measurements
SURYLGHUGHILQLWLRQVWULQJ
Has not special tag. It consists from several fields (provider’s ID, provider’s Name, provider’s
interval of measurements, provider’s number of stations in the measurements section) which
are separated by ‘,’.
The string includes also time of provided measurements.
Example: LPLV
SURYLGHU¶V,'
is a unique on the computer integer number.
Example: LPLV
SURYLGHU¶V1DPH
is a string.
Example: LPLV
SURYLGHU¶VLQWHUYDORIPHDVXUHPHQWV
Example: LPLV
SURYLGHU¶VQXPEHURIVWDWLRQVLQWKHPHDVXUHPHQWVVHFWLRQ
it is attribute of the file (not of the provider)
Example: LPLV
WLPHRISURYLGHGPHDVXUHPHQWV
of the One-provider-one-time measurements section included into provider definition string. It
is last field of the string (the fields are separated by ‘,’). The format of the field is
yyyymmddHHMMSS
Example: LPLV
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 25/26
VWDWLRQVUHODWHGPHDVXUHPHQWV
Includes at least one One-provider-one-time-one-station section.
2QHSURYLGHURQHWLPHRQHVWDWLRQVHFWLRQ
includes Station’s definition string and at least one section of the level-related measurements
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
6WDWLRQ¶VGHILQLWLRQVWULQJ
Is a set of ‘,’-separated fields preceded by “\STATION”-tag.
10.3.1.3.1.1.1 station’s ID
is a unique on the computer integer number. (exception is helicopter data)
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
10.3.1.3.1.1.2 station’s name
is a unique for the provider string
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
10.3.1.3.1.1.3 station’s longitude
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
10.3.1.3.1.1.4 station’s latitude
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
10.3.1.3.1.1.5 station’s sealevel
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
10.3.1.3.1.1.6 station’s code 1
string
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
10.3.1.3.1.1.7 station’s code 2
string
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
6/9/2004 3:10 a10/p10
RtGraph Administrator’s Manual
Page 26/26
10.3.1.3.1.1.8 station’s number of levels
is number of levels for which exist measurements in the measurements section of the file. (it
equals to number of lines which follow to the Station’s definition string.
Example: ?67$7,21%HUOLQ.DUOVKRUVW=
=
VHFWLRQRIWKHOHYHOUHODWHGPHDVXUHPHQWV
includes at least one string of level-related measurements
10.3.1.3.1.2.1 string of level-related measurements
includes separated by ‘,’ number of measured parameters on the level, height of the level and
measurements part.
Example: 2,0,14:4.43,15:0
QXPEHURIPHDVXUHGSDUDPHWHUVRQWKHOHYHO
Example: ,0,14:4.43,15:0 ( is number of measured parameters on the level)
KHLJKWRIWKHOHYHO
Example: 2,,14:4.43,15:0 ( is height of the level (m))
PHDVXUHPHQWVSDUW
is a set of pears of SDUDPHWHU¶V,' (one from the parameter’s ID described in Parameters
definition section) and value. Total number of the pears equals to the 10.3.1.3.1.2.1.1 number
of measured parameters on the level.
Example: 2,0, ( is measurements part. There are two measurements
on the level-for parameter with ID and for parameter with ID . The measured value for
parameter with ID equals to . The measured value for parameter with ID equals to
.)
6/9/2004 3:10 a10/p10