computePtclImpactSpectrum.py

This analysis script outputs cumulative and per dump information about the particles that were recorded by an speciesAbsPtclData2 history, to enable their spectrum to be determined.

-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.

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

(string, required)

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

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

(int, required, default = 0)

<comp> is the physical component to plot the spectrum against.

-n <num>, --numBins=<num>

(int, required, default = 32)

<num> is the number of energy bins.

-T <N>, --threshold=<N>

(float, optional)

Particle densities below the chosen <N> will be ignored.

-w, --overwrite

(flag)

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

Output

This analysis script outputs a vizschema compatible field file with position index along one coordinate and the kinetic energy of the particles along the other axis. These density fields can help to analyze the particle distribution results in the simulation domain.

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.

Example

We can use this on the cylHallThruster example. See Fig. 556 for example values to set in the analyzer dialog box.

analyzer settings

Fig. 556 computePtclImpactSpectrum.py settings

The output then looks like that shown in Fig. 557.

Fields from analyzer

Fig. 557 computePtclImpactSpectrum.py analyzer applied to elecAbsData dataset in the cylindrical hall thruster example.