THEMIS Science Software Training1July 2007 The THEMIS Graphical User Interface J. McTiernan 23-Jul

THEMIS Science Software Training2July 2007 IDL> thm_gui Called from IDL command line. Gives the ability to load and plot data, and also some data processing tasks. Calls various TPLOT routines IDL functions are available from command line when widget is up. Find this document:

THEMIS Science Software Training3July 2007 Main Widget:

THEMIS Science Software Training4July 2007 Choose Data to Load: Click here for FGM data

THEMIS Science Software Training5July 2007 Data choice window: Nothing will happen until you click here

THEMIS Science Software Training6July 2007 Choices show up in History Window: Click here to clear choices.

THEMIS Science Software Training7July 2007 Load Data: Click here to load.

THEMIS Science Software Training8July 2007 Oops, Nothing happens unless you choose a time range Click Here to choose times.

THEMIS Science Software Training9July 2007 Time Range Window: You can type here. Initially times are set to /00:00:00 Times show up in history as you type. Click here for a time selection widget

THEMIS Science Software Training10July 2007 Time selection widget:

THEMIS Science Software Training11July 2007 Selection shows up in the History: Now you can load data.

THEMIS Science Software Training12July 2007 After loading, All data is “active”. State data has been loaded automatically for FGM.

THEMIS Science Software Training13July 2007 Setting Active Data: Type a string, or click to set data to “active”

THEMIS Science Software Training14July 2007 What next? Coordinate transform Data Processing Data Processing Plotting.

THEMIS Science Software Training15July 2007 Coordinate Transform: Click one of these to choose output coordinates. Shows current transform Click here to do the deed. Message window: this will show warnings, errors, and progress.

THEMIS Science Software Training16July 2007 Clicked on GEI, and Transform Button:

THEMIS Science Software Training17July 2007 Back on the main widget: New “active” data. Remember – only active data is processed.

THEMIS Science Software Training18July 2007 Plot Widget: If there is active data, plot pops up first.

THEMIS Science Software Training19July 2007 Plot Widget: Setting “PNG” Click here File shows up in working dir. Remember to click on SCREEN to return to screen plots

THEMIS Science Software Training20July 2007 Check History: These are the IDL commands used.

THEMIS Science Software Training21July 2007 Data Processing (dproc) widget:

THEMIS Science Software Training22July 2007 Data Processing (dproc) widget: Deletes Active Data.

THEMIS Science Software Training23July 2007 After dpwrspec button: (and time limits button) *For some time ranges, this crashes in the IDL POLY_FIT routine, due to a singular matrix detected.

THEMIS Science Software Training24July 2007 Note new “active” data: These processes reset the “active” data.

THEMIS Science Software Training25July 2007 Other Stuff: Click here for an overview plot:

THEMIS Science Software Training26July 2007 Sample Overview Plot:

THEMIS Science Software Training27July 2007 Other Stuff: Click here to save history. Here to clear history

THEMIS Science Software Training28July 2007 HELP Widget: This has descriptions of all of the buttons and windows in the widgets.

THEMIS Science Software Training29July 2007 Error Widget: This should pop up automatically if there is a crash. Also you can get this by clicking the ERROR button on the main widget. You can edit this form, and please save this and it to: l.berkeley.edu l.berkeley.edu l.berkeley.edu Also a saved history file and any other pertinent information that can be cut and pasted from the IDL window.

THEMIS Science Software Training30July 2007 Configuration Widget: Allows configuration to be changed, saved. Saves in a file. Input into every session Resets to initial state. Resets to default state in distribution, deletes any saved files. Messages: You need to be able to write to this directory if you download data.

THEMIS Science Software Training31July 2007 Exit Button: Click here to exit GUI. Popups are dismissed, except for Help, Error or Config. Loaded data is not deleted – will show up in Loaded Data window on restart (but not in Active Data).

THEMIS Science Software Training32July 2007 THM_GUI Tips: Remember to save and your history file if you have a bug. Also feel free to include any other output messages that show up in the IDL command line. Always choose a time range before loading data. Don't load more than a couple of days at a time, or a couple of hours if you are loading full resolution all-sky imager (asf) data. The choice of "probe" in the data loading widgets is global, that is, all of the selected data will be loaded for the probe(s) chosen most recently. If, for example, you want to load EFI data from probe "A" and FGM data from probe "B", you will need to load these separately. When choosing multiple probes, data types, or whatever, hold the "control" key, and click more than one. Also, you can click on an option, then hold "shift" and the left mouse button, and drag the cursor over the others. The data names are kind of cryptic, there is a table in the User's Guide and also at the end of the text in the help widget for guidance.

THEMIS Science Software Training33July 2007 THM_GUI Tips: Once you've chosen data, hit the "Clear Load Queue" to clear it out if you don't want to load it. If a load fails (for a reason other than "the data isn't there"), then the data are still waiting to be loaded. Clear the load queue. Remember that all loaded data are set to "active" immediately upon loading. If you don't want all of that data to be active, then click on what you want in the Loaded Data window. If you want to delete all data, type "*" window below the Loaded Data window, click "Set Active Data to String", call up the Data Processing widget, and click "Delete". For coordinate transforms, data that have "Unknown" for a coordinate system will not be transformed. Multiple data sets with different input coordinates *can* be transformed. Data Processing and Plotting tasks are only possible when there is "active" data.

THEMIS Science Software Training34July 2007 THM_GUI Tips: When typing in strings for numerical input -- be careful. Strings that aren't numbers are interpreted as 0 by IDL, but strings that aren't numbers, but start with a number are set to the number, e.g., 'a14' is set to 0, but '1a4' is set to 1. When in doubt, look in the History. Sometimes data is inappropriate for a given operation (especially wavelet transforms, and power spectra). We have tried to catch as many of these situations as we can, but there probably will be more as more types of data are imported. If something looks weird, save your history, and us. Some processes can take a while (e.g., calibrating SCM data, wavelet transforms of whole days). Currently there is no good way to stop a process except for the standard IDL "control-C" on the IDL window. This doesn't always work... For some time ranges, the "dpwrspec" button crashes in the IDL POLY_FIT routine. We have no clue why this happens. Try changing the input time range.

THEMIS Science Software Training35July 2007 THM_GUI Tips: The Plot Data button first issues a "tplot" call when the widget pops up. If you create a "PNG" plot, remember to reset to "SCREEN" for screen plotting. Don't try to plot more than about 10 quantities at a time, if there is spectrogram data, there will be a crash. There will undoubtedly be more of these…