ni2.plo

Inputfile for the BS-PLO plotting program.

inform
postscript ni2.ps
portrait
rows_per_page 2
columns_per_page 1
energy_range 850 880
lorentzian 0.2 999.
gaussian 0.1
old_racah ni2.rac_out
frame_title Ni2+
spectrum
end

inform

inform turns on more of the program messages, such as writing out each spectral line as it is read. Primarily used for checking that the program is working.

dont_inform Deactivates the inform command. (default)

postscript

postscript [filename] [int] All output to the given file will be done using postscript commands. This is the default mode. The optional integer value specifies the number of points to use in the calculation of the spectrum (default is 1000).

hpgl [filename] [int] Output to the given file will use HPGL commands. The formatting is designed for A4 paper on a HP LaserJet.

xy [filename] [int] Outputs the spectrum as a list of (x,y) coordinates. The default number of points to output is 400.

portrait/landscape

portrait This sets the output mode to use normal A4 portrait mode for those devices that actually produce printer output.

landscape This sets the output mode for the printer devices as A4 landscape. This is the default.

rows/columns

rows_per_page This sets the number of rows of spectra that are put on an output page. The default is 1.

columns_per_page This sets the number of columns of spectra that are put on an output page. The default is 1.

vertical_order This sets the order in which spectra are added to a page. The first is in the lower left corner. This means that the following spectra should be added vertically above the last one, moving to the right each time a column is filled. The default.

horizontal_order The opposite of vertical order. Plots are added to the right until a row is filled.

energy range

energy_range [min] [max] This command specifies the range of energies that you wish to plot by giving the minimum and maximum values. If this command is not given then the program will attempt to choose a minimum that is slighty smaller than the lowest energy line in the spectrum, and a maximum that is just above the highest energy line.

broadenings

lorentzian [real] [real] [range (min) (max)] This command sets the line shape used to represent lifetime broadenings. The first number gives the width. Since it really uses a fano line shape the second number is also required. If this number is very large then the shape is effectively a true lorentzian. If the optional command range is given, the minimum and maximum values are used as the energy range to which this particular line shape applies. If no range is given then it applies to all energies. You should make sure that there is a lorentzian given for all lines that will appear in your spectrum or problems may occur.

reset_lorentz This is the proper way to remove the previous lorentzian values, prior to specifying new ones.

gaussian This specifies the gaussian to be used to convolute the spectrum. A value must be set before a spectrum can be made.

input files

old_racah [filename] [add] This command tells the program to read spectral line information from the specified file. The information is in the format produced by the crystal field program using the 1984 version of Racah. Unless the command add is also given this will erase the lines read from the previous file. It does not erase any lines currently selected for plotting.

rcg9 [filename] [add] This command reads spectral line information produced by rcg9. The rest of the information is the same as for the command old_racah.

band [filename] [add] This command reads spectral line information produced by bander. Again the command description is the same as for old_racah.

title

title [string] This command skips the blanks following the command and uses all the rest of the characters on the line as the title string. This string is used for the main title on the page. The string may contain LaTeX like formatting for sub/super scripts except that they do not need to be embedded in mathmode.

frame_title [string] This behaves in the same way as title. It specifies a string to use as a title on the current frame. If there is only one frame on the page then this command does nothing

image_title [string] This behaves in much the same way as frame_title except that it specifies a label for the plot within the frame, when images_per_frame is in use.

spectrum commands

spectrum [various options] This command is used to create a spectrum once the input and output files are set and lorentzians and guassians have been given. If no options are given then {\it plotter} adds all lines from the lowest energy state to the plot list and then produces a spectrum from the plot list. Any or all of these options may be specified: temp, istate, fstate, energy, shift, scale, operator. They are described below.

addlines [various options] This behaves in the same manner as spectrum, except that is only adds the lines it finds to the plot list, it does not produce a spectrum.

create [various options] This behaves like spectrum but it creates a spectrum an stores it using the current label. The spectrum can the be plotted separately using plot.

options for spectrum:

istate The lines selected must have come from initial states with the specified label. The lines will also be selected on energy.
fstate The lines selected must go to final states with the specified label.
operator The lines must belong to the transition operator with the specified label. This is usually used to select out components with different polarizations. In conjunction with racah input files it is possible to use the name of the operator instead of its symmetry label.
shift The energy values of the lines being selected should be shifted by the given value.
scale The intensities of the lines being selected should be scaled by the specified value.
energy The lines should be selected from initial states with the specified energy value.
temp Selects all lines based on any other options given and scales their intensities for a Boltzmann distribution at the temperature specified in Kelvin.