Fandom

Documentation

Man page (METRo)

133pages on
this wiki
Add New Page
Talk0 Share

metro(1)

NAME

      metro - METRo is a road weather forecast software from Environment Canada.

SYNOPSIS

 metro  [--config  filename][--enable-sunshadow  [--sunshadow-method method]] [--help] 
              [--fix-deep-soil-temperature temperature] [--generate-config file‐name] 
              [--input-forecast filename] [--input-observation filename] [--input-station filename]
              [--lang  [fr|en]]  [--log-file  filename]  [--output-roadcast filename]  
              [--output-subsurface-levels]  [--roadcast-start-date  date]  [--selftest]  [--silent] 
              [--use-anthropogenic-flux]   [--use-infrared-forecast] [--use-sst-sensor-depth]
              [--use-solarflux-forecast] [--verbose-level level] [--version]


DESCRIPTION

 With  the help of observations provided by roads weather stations (road
      weather information system, RWIS) and the atmospheric  forecast,  METRo
      can  predict  the  roads  conditions  with particular interest such as:
      freezing rain, accumulation of snow, frost or defrost soil.

OPTIONS

      --config filename
             If a configuration file is provided, the options  in  this  file
             can be used instead of those given in command line.  To generate
             a file with the requested format, see the option --generate-con-
             fig .

      --enable-sunshadow
            Optional.  METRo uses sun-shadow algorithm to determine
            if the road is exposed to sun at a particular time. There is 
            two methods to compute this shadow. See the option --sunshadow-method 
            for more details. The station XML file contains the information about
            the visible elevation of the road under the '<visible-horizon>' element. The 
            sun-shadow routine requires <azimuth>, <elevation> pairs being ordered 
            by growing azimuths values and also uniform step in azimuth is required 
            (i.e, each neighbour azimuth values are displaced by same distance), 
            otherwise it can give a wrong results.

      --help Display a list of command line options.

     --fix-deep-soil-temperature temperature
           Optional. Fix the deep soil temperature to a given value in degree Celsius. 
           'temperature' must be a number between the maximum and minimum road 
           temperature values given in metro_constant.py. When this flag is not set, 
           the default value is computed from the surface and deep sensor values.

      --generate-config filename
             Generate  an  empty  config file.  You can then fill the options
             that will be used if the option --config is set to filename on a
             subsequent call to metro.

      --input-forecast filename
             Set where is the atmospheric forecast file.

      --input-observation filename
             filename is where the observation of the RWIS station is.

      --input-station filename
             filename is where the configuration file of the RWIS station is.

      -lang fr|en
             Choose the language of message for METRo.  Default  is  english.
             Only french is currently implemented as other language.

      --log-file filename
             Set the path of the metro log file.

      --output-subsurface-levels
             Starting from version 3.2.0
             Put in the output roadcast all the temperature for the subsurfaces
             levels, 19 levels for roads or a uniform grid at every cm for bridges.
             WARNING: Using this option slow down METRo by a factor of 2.

      --roadcast-start-date date
             Optionnal.  If this argument is not present,  the  date  of  the
             last  observation is used. Date of the first roadcast.  The for-
             mat is ISO 8601.  See http://en.wikipedia.org/wiki/ISO_8601  for
             further details.

      --selftest
             Execute  a  test  with  default  files provided with metro. This 
             command uses the option --output-subsurface-levels.

      --silent
             Do not write in the standard output.

      --sunshadow-method method
            Optionnal. Only used if --enable-sunshadow is set. 'method' takes 
            the value of [1|2]. If no value is given, '1' is used as the default value.
            1 = Basic method (default). It sets solar flux to zero when Sun is below
                visible horizon
            2 = Enhanced method. Replaces global solar flux with its diffuse component 
                when Sun is below visible horizon.

      --use-anthropogenic-flux
             Optionnal. Use this argument if you want to provide the anthropogenic 
             flux  in  the  atmospheric forecast  file instead of using the default 
             value of 10 W/m². The tag for anthropogenic flux in forecast file is '<fa>'.

      --use-infrared-forecast
             Starting from version 3.2.0
             Optionnal. Use this argument if you want to provide the infra-fred 
             flux in the atmospheric forecast file instead of a theoretical flux  
             based on cloud cover. The tag for infra-red flux in forecast file 
             is '<ir>'.

      --use-sst-sensor-depth
            Optionnal. Use this argument if the subsurface sensor is not at 0.4 m 
            from the surface. This value can be between 0.2 m and 0.6 m. The modified 
            value should be in the station XML config file under the element <>

      --use-solarflux-forecast
             Starting from version 3.2.0
             Optionnal. Use this argument if you want to provide the solar 
             flux in  the atmospheric  forecast  file  instead  of a theoretical
             flux based on cloud cover. The tag for solar flux in forecast file
             is '<sf>'.

      --verbose-level level
             Select the verbose level of the logged messages of metro.
             1- No log is made of any message
             2- Minimal level
             3- Normal (default)
             4- Full
             5- Debug

      --version
             output version information and exit



AUTHOR

      Written by Miguel Tremblay, François Fortin, Yves Delage and 
      Louis-Philippe Crevier.

COPYRIGHT

      COPYRIGHT  ©  2004,  Service  Meteorologique  du  Canada,  Environnement
      Canada.  See documentation for details at 
      http://documentation.wikia.com/wiki/METRo .
      This is free software; see the source for copying conditions.  There is
      NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
      PURPOSE.

REPORTING BUGS

      Report bugs to <metro-developers@gna.org>                      metro(1)


Logo ec
This page is part of the documentation of the METRo software. Back to the table of content.

Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.