computeTimeSeriesAmplitude.py

This analyzer script computes the amplitude of a time series or more specifically calculates the instantaneous amplitude of history at the specified frequency.

-s <simname>, --simulationName=<simname>

(string, required)

<simname> is the name of the simulation to be analyzed. The file extension should NOT be included in this text field.

-f, --frequency

(float, required)

The frequency at which history will be analyzed.

-H <histname>, --historyName=<histname>

(string, required)

<histname> is the name of the history dataset to analyze.

-O <outname>, --outputFileName=<outname>

(string, optional, default = SIMULATIONNAME_timeSeriesAmplitude)

<outname> is the name of the file into which the amplitude will be written.

-c <comp>, --component=<comp>

(int, optional, default = 0)

<comp> is the component to select within a multi-component dataset.

-w, --overwrite

(flag)

Whether a dataset or group should be overwritten if it already exists.

Output

This script prints out formatted text in two columns. The first column is the time axis in seconds, and the second column is the amplitude of the time series. The scripts also creates a VizSchema-compliant Hdf5 file that contains a new dataset that can be visualized in Composer. The name of the new HDF5 file is SIMULATIONNAME_timeSeriesAmplitude.vsh5 that contains the dataset Amplitude_FREQ, where FREQ is the filter frequency with periods replaced by underscores.

If you are running this analyzer from the UI, and the output dataset file already exists, then it will be overwritten each time the analyzer is run, unless you uncheck the Overwrite Existing Files box near the bottom of the Analysis Results pane.

If you are running the analyzer from the command line, the dataset will not be overwritten unless the -w, or --overwrite flag is specified on the command line.

The results of your analyzer may not be written into the output file if you have not specified the overwrite option to be True.