File Read

This component can be used to read pre-formatted, columnar text data from a file, and then input this data directly into a PSCAD simulation. The data file may include up to 11 columns of data, each column containing information representing an individual scalar control signal.

Before the data file can be used within a simulation project, the data sampling rate (or time step) must be somehow related to the simulation environment. This is accomplished in one of two ways:

If the time step in the time column of the data file (or the sampling frequency for that matter) is not an integer multiple of the PSCAD simulation time step, then the component will linearly interpolate the data to a value corresponding to the PSCAD simulation time step.

The output of this component is provided to the PSCAD simulation as an output data vector, where each element of the output array represents the corresponding single column of the input data file. If you intend to inject the data from a particular column (or columns) in the file, then you must tap the output array using the Data Signal Array Tap component, as shown below for a 4 column data file.

NOTE: If the input file contains only one column of data (not including time), then the output signal will be a scalar (i.e. dimension 1). Therefore, a Data Signal Array Tap is not required in this case.

Input Parameters

File Name	Text		Name of the file containing the data to be read (Ex. data.txt)

Path to the File Given As	Choice		Select relative path or absolute path. Click on relative path if you are giving the File Name relative to the current working directory. Use absolute path if you are giving the File Name as an absolute path (Ex. C:\data.txt).

Number of Columns in the Output File	Choice		Select 1 to 11 to indicate the number of columns in the file to be read. If Sampling Time Information \| first column contains sampling time is selected, then the first column must be time

Sampling Time Information	Choice		Select first column contains sampling time or known sampling frequency. If Known Sampling Frequency is selected, then all data contained in the file will be output at the given Sampling Frequency

At the End of Datafile	Choice		Select output the last read values, rewind and replay again or extrapolate. See Data File Format for more details.

Sampling Frequency	REAL	Literal	The known sampling frequency. This input is enabled if Sampling Time Information \| known sampling frequency is selected

Delay	REAL	Literal	Specify a delay, before which all data will be assumed to be the value specified under Before the Delay.

Before the Delay	Choice		Select zero or output the first value of the datafile. If zero is selected, all data will be assumed 0.0 during the specified Delay. If output the first value of the datafile is selected, data will be assumed equal to the first data value during the specified Delay.

File Read

Description

Input Parameters