Skip to content

TSTool / Command / WriteNwsrfsEspTraceEnsemble


Overview

The WriteNwsrfsEspTraceEnsemble command writes time series traces to the specified National Weather Service River Forecast System (NWSRFS) Ensemble Streamflow Prediction (ESP) trace ensemble file. See the NWSRFS ESP Trace Ensemble Input Type Appendix for more information about the file format. The time series should have the same header information, with the sequence number indicating the trace years. For example use time series that are managed as an ensemble in TSTool.

Command Editor

The following dialog is used to edit the command and illustrates the command syntax.

WriteNwsrfsEspTraceEnsemble

WriteNwsrfsEspTraceEnsemble Command Editor (see also the full-size image)

Command Syntax

The command syntax is as follows:

WriteNwsrfsEspTraceEnsemble(Parameter="Value",...)

Command Parameters

Parameter                          Description Default                           
OutputFile The NWSRFS ESP trace ensemble output file. The path to the file can be absolute or relative to the working directory. None – must be specified.
CarryoverGroup The carryover group to use in the trace file header information Blank.
ForecastGroup The forecast group to use in the trace file header information. Blank.
Segment The segment identifier to use in the trace file header information. Location part of the time series identifier, from the first time series.
SegmentDescription The segment description to use in the trace file header information. Blank.
Latitude The latitude for the station to use in the trace file header information, decimal degrees. Missing.
Longitude The longitude for the station to use in the trace file header information, decimal degrees. Missing.
RFC The river forecast center to use in the trace file header information. Blank.
TSList Indicates the time series to be output, one of:
  • AllTS – all available time series will be output.
  • SelectedTS – time series that have been selected with the SelectTimeSeries command will be output.
  • EnsembleID – time series in the ensemble specified by Blank.
AllTS
EnsembleID The ensemble to write, if TSList=EnsembleID. Required if TSList=EnsembleID.

Examples

See the automated tests.

A sample commands file to convert an ensemble from a DateValue file to NWS ESP format is as follows:

ReadDateValue(InputFile="Data/FRANH.ESP.SQME.1HOUR.QPF1.TRACE2001")
WriteNwsrfsEspTraceEnsemble(OutputFile="Results/FRANH.FRANH.SQME.01.CS",CarryoverGroup="FRANH",ForecastGroup="FRANH",SegmentDescription="FRANH",Latitude="43",Longitude="-72",RFC="NH",TSList="AllTS")

Troubleshooting

See Also