This introduction will outline how to make the plots we have used as examples. We hope that the instructions given here will make the system useful while the user picks up additional information through experience, improvisation, and word-of-mouth.
In order to use PAPCO, you must have the IDL computing language installed. Start IDL and type @papco_start at the prompt. You should get the opening screen . Note the buttons across the top of the screen and the place where the date and time range is to be typed in. To the right is an open area where the selected plots are listed as they are created.
Type in a date and time range in the format shown. N. B. - Much frustration can be avoided if you remember to click in the time range input boxes and hit return. In general, follow this procedure anytime data are entered as text in an input box.
Now you are ready to use the buttons at the top of the page to retrieve Hydra data. For our purposes, the only button of interest is that labeled PO-HYDRA. For access to data in spectrogram format, hit PO-HYDRA. On the resulting menu, one item is of interest: SPECT. Hitting this button gives access to a graphical user interface to various solid-angle-integrated flux quantities, differential by energy.
The four differential energy flux spectrograms in the linked sample were created using this window. To duplicate them, make sure that the buttons for electrons and diff energy flux are selected. Hit, at the bottom, Add_hydra_spec_and_continue. On the opening page, a description of your plot will be inserted at the top of the white space on the right, and the spectrogram interface window will return. Now hit field_aligned and Add_hydra_spec_and_continue. Repeat with perpendicular. Then hit field opposed and Add_hydra_spec_and_close. This will return you to the opening window and the spectrogram interface window will disappear. At this point, you can hit the Draw button at the bottom of the page to inspect what you have made. You should see, in order from the top, the omnidirectional, field-aligned, perpendicular, and anti-field-aligned spectrograms of differential energy flux. The energy scales and colorbars are slightly different from those in the linked sample. We shall now adjust these parameters.
Begin by double-clicking on the description of a plot in the white space on the papco opening page. A window should now appear that is similar to the graphic interface window that was used to create the original plot. (The same effect can be accomplished by single-clicking in the plot window just to the left of the panel you desire to modify.) This window can now be used to modify the original plot. As an example, in the area labeled "Y-scaling," select Manual and Logarithmic. You can now enter customized values for the energy scale of your spectrogram. To duplicate the sample, enter "10" and "1e4," remembering to click in the entry box and hit return. Do the same for z-scaling, entering "1e5" and 1e8." Now at the bottom of the page hit Update hydra_spec. This will return you to the papco opening window. To duplicate the sample, repeat these steps for the second, third, and fourth panels. After hitting Update hydra_spec and returning to the papco opening window, you can hit DRAW to view your results.