metro - METRo is a road weather forecast software from Environment Canada.
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]
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.
--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
Written by Miguel Tremblay, François Fortin, Yves Delage and Louis-Philippe Crevier.
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.
Report bugs to <firstname.lastname@example.org> metro(1)
|This page is part of the documentation of the METRo software. Back to the table of content.|