Command Line Version

PGOPHER is also available in a command line version, pgo[.exe] without the graphical user interface but with otherwise identical code. This is most useful when the output is to be used with other programs. Typical usage is:

pgo file.pgo

which will output a linelist as a text file using the parameters in the .pgo file. Common alternatives include:

pgo Mixture.PrintLevel=CSV file.pgo >file.csv

which will produce the line list in .csv format which, for example, spreadsheets can read. If a specific program is being written to use PGOPHER output, the binary linelist format may be quicker and easier to use:

pgo Mixture.PrintLevel=Binary Mixture.OThreshold=0 file.pgo >file.bin

Here Mixture.OThreshold=0 is being used to set a value in the Mixture object, in this case the cut off in line intensity; setting it to 0 ensures all lines are output. Any other parameter in any object can be set in this way; right click on the parameter in the constants view to show the name.Some of the intermediate objects can be omitted if their is no ambiguity; for example in the linear molecule example Mixture.Species.LinearMolecule.Excited.v=1.B can be abbreviated to Mixture.v=1.B.

To fit use:

pgo --fit file.pgo line.lin

The second file contains the observations. Alternative options are:

--fit	Normal line list fit
--intensityfit	Observations are intensity, not line positions
--fitlower	Fit to lower state energies
--fitupper	Fit to upper state energies
--contourfit	Contour fit; second file should normally be an overlay file in this case.
--fitcdlower	Fit to lower state common differences
--fitcdupper	Fit to upper state common differences

To produce a plot use:

pgo --plot file.pgo plot.txt

This produces a simple text file with the plot data as lists of x,y values; other available formats are .svg and .xfig. Use --eplot to generate a plot as a function of electric or magnetic field.

Other command line options are shown below.

--np n	Use n threads when calculating.
--overwrite	When fitting, write out a new .pgo file with the new parameters on top of the old one.
--newpgo	When fitting write out a new .pgo file with the new parameters to a file with name file1.pgo. (The number is chosen so as not to overwrite any existing file.)
--trackmemory	Show time and memory usage at end of run
--times	Show selected processing times at end of run.

The full graphical user interface version will load all the files given on the command line, and will also respond to most of the commands given above.