Element File

Element file is a parameter file to set the elements and define the plotting rules.

Samples

The line with the first character "!" is the comment line.

.
1st line maximum page number
2nd line number of elements the number of vertical/horizontal element
3rd line chart order the initial position (TOP or BTM), the direction (CLM or ROW)
4th line margin ([mm]) left, right, top, bottom
5th line title (enclosed by '', within 256 characters)
6th line plotting time the initial time, the end time, the time interval, the unit of time
Note : These specifications are NOT valid in case any one of the initial time, the end time or the time unit are less than -50
    the unit of time
  • 60 : hour
  • 1 : minute
7--(7+n)th lines plotting elements
Note : The elements of 15th-19th columns can be set arbitrary.
1st column type1 NuSDaS parameters
2nd column type2
3rd column type3
4th column member
5th column nmap chart order
6th column kt plotting time
Note : This specification is valid in case any one of the initial time, the end time or the time unit are less than -50
7th column level NuSDaS parameter
specify the level for the horizontal plotting, and the upper limit level for the vertical cross section plotting.
8th column elem NuSDaS parameters
    Remarkable Elements
  • WIND : wind (arrow)
  • VECT : wind (vector)
  • STRM : stream line
  • WINDD : wind direction (0-360 clockwise rotation from north=0)
  • ISTC : wind speed
  • VOR : vorticity
  • DIV : divergence <<<<<<< element.html
  • SHEAR : intensity of deformation (stretching and shear deformation) =======
  • SHEAR : intensity of deformation(stretching and shear deformation)
  • VWS : Vertical Shear(use u,v,w)(kz=from 3 to nz-2)
  • VS : Vertical Shear(use only u,v)(kz=from 3 to nz-2)
  • RI : Richardson number(kz=from 3 to nz-2) >>>>>>> 1.17
  • CIRCUL : vertical circulation
  • EPT : equivalent potential temperature
  • WETH : weather map
  • WETHQ : weather map (by SMQR, SMQS, SMQH)
  • SSI : SSI
  • KI : K-index
  • CAPE : CAPE
  • RH_D : diagnostic relative humidity calculated from T and TTD
  • TSEC : time of lightning (the difference between lightning time and valid time are expressed by "-". unit : sec)
  • TDD : multiplicity of lightning
  • TKK : types of lightning discharge ( 0 : single intra-cloud lightning discharge, 1 : leader stroke of plural intra-cloud lightning discharge, 4:leader stroke of ground discharge)
  • TEC : estimated lightning current ( only for ground discharge. If it's multiple intercould discharge, the value of the leader stroke is denoted. unit : kA)
  • LINE+n : plot a straight line horizontally, which is formed from the two points defined by the 16th-19th columns of the elements in "n" lines after.
  • LINE-n : plot a straight line horizontally, which is formed from the two points defined by the 16th-19th columns of the elements in "n" lines before.
  • BOX+n : plot a quadrangle defined by the 16-19th columns in "n" line after in its plotting area.
  • BOX-n : plot a quadrangle defined by the 16-19th columns in "n" line before in its plotting area.
  • GRIDxx : plot grid points of input data. xx means the plot interval. This element can be used in case the grid point information is different between the data and plotting area.
  • LEVEL : This element can be used to plot a vertical cross section of the model level data.
  • TSEA : the mean sea level temperature (lapse rate : 0.6K/100m) This option is valid only for AMeDAS data.
  • TSEA5 : the mean sea level temperature (lapse rate : 0.5K/100m) This option is valid only for AMeDAS data.
  • TSEA55 : the mean sea level temperature (lapse rate : 0.55K/100m) This option is valid only for AMeDAS data.
  • RM60 : accumulated analysis precipitation RR60LV.
  • RM10 : accumulated analysis precipitation RR10LV.
  • ALBEDT, ALBEDB : albed at TOA or Sfc(0.0〜1.0)
  • LWP, IWP, TWP : liquid water path, ice water path, LWP+IWP(vertical integration of cloud from cloud microphysics)(kg/m^2)
  • LWPRAD, IWPRAD, TWPRAD : liquid water path, ice water path, LWPRAD+IWPRAD(vertical integration of cloud used in radiation calculation)(kg/m^2)
  • VISRAD : Visiblity(km) (diagnosed by the Kunkel(1984) formula using the cloud for radiation calculation)
9th column sp
  • # : original plot
  • + : add the value of the element specified in the next line to plot
  • - : subtract the value of the element specified in the next line to plot
  • i : subtract the value of the element specified in the next line to plot incremantaly
  • % : subtract the value of the element specified in the next line, and divide by the element to plot
  • M : average with the value of the element specified in the next line to plot. This is the same with the case of more than 3 lines. All elements are considered to have the same weight "1".
10th column contr contour interval
Note : Use the default value in case the set value is more than 1.e+30.
Default value is defined in the following manner.
Serch an element from the table file. The file is defined according to the color; the table file depends color parameter
  • color=-3,-5,-10,-15,-20,-103,-105,-110,-115,-120,-203,-205,-210,-215,-220,-303,-305,-310,-315,-320 : paint table
  • others : contour table file
If the element is not in the above mentioned table files, the default value is automatically calculated from the maximum and the minumum value.
11th color color numbers
  • >1 : plot a contour using the color specified by "color"
  • -1 : refer the Color Table File
  • -2 : plot precipitation using gray scale colors for each contour (filling)
  • -3 : plot arbitrary elements using gray scale colors (filling)
  • -4 : plot precipitation using bright colors (filling)
  • -5 : plot arbitrary elements using rainbow colors (filling)
  • -6 : plot a weather map using different colors for each weather (symbol)
  • -7 : plot a weather map using different colors for each weather (filling)
  • -8 : plot an incremental map using different colors for positive values and negative values.
  • -9 : plot precipitation using different colors for each contour
  • -10 : plot an incremental map using different gradation colors for positive values and negative values (filling)
  • -11 : plot arbitrary elements using different colors for each contour and region (filling)
  • -12 : plot AMeDAS observation values using different gray scale colors for each threshold
  • -13 : plot AMeDAS observation values using different rainbow colors for each threshold
  • -14 : plot precipitation using different bright colors for each contour according to HKO definition (filling)
  • -15 : plot arbitrary elements using different rainbow colors in the opposite order of "-5" (filling)
  • -20 : plot an incremental map using different gradation colors for positive values and negative values in the opposite order of "-10"(filling)
  • -102 : same as "-2", and add the color bar
  • -103 : same as "-3", and add the color bar
  • -104 : same as "-4", and add the color bar
  • -105 : same as "-5", and add the color bar
  • -109 : same as "-9", and add the color bar
  • -110 : same as "-10", and add the color bar
  • -112 : same as "-12", and add the color bar
  • -113 : same as "-13", and add the color bar
  • -114 : same as "-14", and add the color bar
  • -115 : same as "-15", and add the color bar
  • -120 : same as "-20", and add the color bar
  • -203 : same as "-3", add the color bar and do not plot the contour
  • -205 : same as "-5", add the color bar and do not plot the contour
  • -210 : same as "-10", add the color bar and do not plot the contour
  • -215 : same as "-15", add the color bar and do not plot the contour
  • -220 : same as "-20", add the color bar and do not plot the contour
  • -303 : same as "-3", and do not plot the contour
  • -305 : same as "-5", and do not plot the contour
  • -310 : same as "-10", and do not plot the contour
  • -315 : same as "-15", and do not plot the contour
  • -320 : same as "-20", and do not plot the contour
  • -xx : same as "-xx", and decide the height of the picture considering the space for the color bar (the color bar is not plotted actually) .
  • -6xx : same as "-1xx", and decide the height of the picture considering the space for the color bar.
  • -7xx : same as "-2xx", and decide the height of the picture considering the space for the color bar.
  • -8xx : same as "-3xx", and decide the height of the picture considering the space for the color bar (the color bar is not plotted actually) .
mod(color/1000, 10)=-1 :

Use the Color Table File specified by the device number, which is indicated by 2-digit number to the left. You can arbitrarily set the paint colors using this function. The meaning of the third figure to the left is the same as the above.
Example)-1135 : Read the color table of the device number 35, and add the color bar.
To set a Color Table File, decide R/G/B values(0-255, respectively) for each color in the table. The number of colors should be (2 * ncolor+ 1) for "ncolor", which is specified in the fifth column of the "paint_table.txt.". (Example)

255  255  255
0    0    255
....

mod(color/1000, 10)=-2 :

Use the Color Table File specified by the device number. The Color Table File shows the colors for various levels, which are devided by each threshold value. The meaning of the third figure to the left is the same as the above, although contour lines are not plotted regardless of the third figure.
The threshold value, RGB values(0-255) and numdec (optional) should be respectively defined for each level.
(Example)

0.5    0  255 255  1
1.0    0  102 255
3.0    0    0 255
5.0    0  204   0
999.9 255   0   0
In the above configuration, the first line indicate to plot the value less than 0.5 with the color of RGB (0,255,255). The second line indicate to plot the value, which is more than 0.5 and less than 1, with the color of RGB (0,102,255).
To specify the degit of color bar lavel value, set the numdec at the 5th column. To specify the upper(lower) limit of color bar, set white(255,255,255) for the first(last) color.
12th column file NuSDaS root directory
Note : This specification is valid in case 1, ... , 99
13th column area the number of the Area File
14th column time date / time
  • 0 : the time is not updated (the time is automatically defined by the device number 1 at the boot time)
  • 1-50 : the time is updated according to the first line of the timecard of the specified device number (read without rewind)
  • 101-150 : the time is updated according to the time of next line on the timecard of the device number, which is specified by the two-digit number from the bottom (read without rewind)
  • others : the time is read automaticaly
15th column mode image types
  • h : horizontal plotting
  • v : vertical cross section
  • t : time series vertical cross section in the specified lattice
  • z : horizontal plotting at the specified altitude (m)
  • y : time series line segment cross section at the specified NuSDaS surface
  • w : time series line segment cross section at the specified altitude
    Note : h is automatically set if you don't set the parameters.
16th-19th column region x of start point (ist), x of end point (ien), y of start point (jst), y of end point (jen)
  • For horizontal plotting
    Specify the plotting area. x of start/end point, and y of start/end point are adjusted automatically (start pointFor vertical cross section
    Specify the horizontal area, in which the vertical cross section is defined. Being different from the horizontal plotting, the value of (ist),(ien),(jst) and (jen) are not adjusted automatically. (ist) can be bigger than (ien), and (jst) can be bigger than (jen).
Note : The file specified in "area" is used if you don't set the parameters.
(8+n)th line end of plotting element end
(9+n)th line intervals(space) of plotting
number of remarks		 plotting interval of grid point, plotting interval of wind, number of weather map remarks
Note : Plot interval of grid pont (intgrd) is valid when it is more than : 1.
Note : Plot interval of wind (intwnd) is valid when it is more than 1.
Note : The number of wheather map remarks is arbitrary (more than 0 if any).
(10+n)th line smoothing a smoothing constant for the weather except precipitation, the smoothing constant for precipitation
Note : Valid for the smoothing constant more than 2.
(11+n)th line interval of latitude and longtitude of the map
(12+n)th line minimum searching range, maximum searching range
(13+n)th line accumulative precipitation time (unit[time unit specified in 6th line]) accumulative precipitation time except the weather map, accumulative precipitation time of the weather map
(14+n)th line the threshold of precipitation (unit[0.1mm])
(15+n)th line the contour of rain (unit[0.1mm]) Example : 10, 50, 100, 200, 500, 1000, 9999, -99,
Note : 10 x variables can be specified at the maximum. The last value should be negative
(16+n)th line the conversion of wind unit, the ratio of horizontal wind speed to vertical wind speed
  • conversion of wind unit : 1 ... m/s --> knot, -1 ... knot --> m/s.
    Note : To display the output without unit conversion, set 0.
    Basically, the unit of NHM wind output is m/s.
    Note : Currently, the unit conversion is valid for WIND, VECT, STRM, ISTC, MXWS.
  • ratio of horizontal wind speed to vertical wind speed : CIRCUL vertical wind speed is multiplied by this ratio.
    Note : The default value is used for the negative value
    Note : The value is automatically set for the value more than 1.e+30
    Note : -1.0 is set when you don't set the parameters.
(17+n)th line the conversion of temperature unit
  • 1 : K --> C
  • -1 : C --> K
(18+n)th line the threshold of topography (unit[m])
(19+n)th line the symbols in vertical cross section, line segment in horizontal plotting ( arbitrary) the symbols for (ist,jst), the symbols for (ien,jen), the size of symbol, the color of the symbols in a vertical cross section, the symbols and the line colors in horizontal plotting