TSTool / Command / WriteNwsrfsEspTraceEnsemble

Overview
Command Editor
Command Syntax
Examples
Troubleshooting
See Also

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 command is available in the following TSTool menu:

Commands / Ensemble Processing

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

WriteNwsrfsEspTraceEnsemble Command Editor (see 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 the main TSTool Troubleshooting documentation.