PIDF Editor v1.0

[picture of PIDF editor]


written by Joey Mukherjee -
joey@swri.edu

Table of contents

  1. Overview
  2. Getting Started
  3. Limitations
  4. File Button...
    1. New
    2. Open
    3. Save
    4. Save As
    5. Export to XML
    6. Delete
    7. Quit
  5. Edit... or Add...
    1. Header
    2. Groups
    3. Miscellaneous
    4. Bins
    5. Units
    6. Sensors
    7. Scan
    8. Calibration
    9. Mode
    10. Quality
    11. Pitch Angle
    12. Spin Angle
    13. Spacecraft Potential
    14. Background
    15. Moments
    16. Coordinate System
  6. Wizards

Overview

The PIDF editor enables you to easily create Plot Interface Definition Files (PIDF) for use with the IDFS software. It is assumed that the user is already familiar with the IDFS format and software available and knows what information is needed in the PIDF file. This program/help file is primarily a document on how to use the editor. If you wish to learn more about the PIDF itself, read the PIDF documentation. If you are a programmer and wish to know how to get information from the PIDF into your program, check out the ReadPidf documentation.


Getting Started

First, load up the PIDF editor. You can do this one of two ways. From the SDDAS Control Panel, select "Editors" and then select "PIDF Editor". Alternatively, you can type "pidfedit" from the command line. The editor will start up with the blank view window. From here, you can either load a file using the "Open" option from the File menu or start from scratch creating a PIDF file. If you start from scratch, it is recommended that you start at the beginning and go from there. Doing things ad hoc *MAY* cause problems... In other words, I think I got all the bugs out if you do things out of order, but I don't know for sure... :-) Therefore, if you are starting from scratch, I recommend using the "Create A New PIDF Wizard" from the "Wizards" menu and answering all the questions as best you can.

Limitations

Current limitations:


The File Button

Basic file handling routines.

New

New will reset all dialogs to nothing. Do this when you wish to start over.

Open

Open will load a new file for editing. Any current file in memory will be reset.

Save

Save will save the file with the current filename.

Save As

Save will allow you to save the file with another filename.

Export to XML

Export to XML will allow you to save the file in XML format.

Delete

Delete will let you delete a PIDF file from disk.

Quit

Quit - exit the program.

Edit... or Add...

For the most part, the Edit... and Add... do the same thing. The difference is that when you do an add, you are adding a new item in the PIDF file. If you do an edit, you will be asked which item you wish to edit. If only one item exists, you will edit that item. Also, the Add... only lists items which have multiple entries. The "Browse" button exists on several entries and attempts to make it easier to specify units and sensor numbers. If you click on the browse button, you can then click on each of the items to add them to the list. Click on OK and continue from there.

Header

The Header option lets you edit the general information on the PIDF. Namely the institution, project name, mission name, experiment (or satellite) name, instrument name, and finally virtual instrument name.

Groups

The Groups option will allow you to type all the group names for this PIDF one per line. Take care not to have any extraneous blank lines or else they will become blank group names.

Miscellaneous

There are four areas to the miscellaneous section. They are flow direction, plot availability, averaging dependencies, and limits.

  1. Flow Into

    This check box describes the relationship between the sensor look direction and the plasma flow direction. In most cases, sensors detect plasma flowing into the sensor, so the sensor look direction is opposite to the plasma flow direction. Some IDFS data sets have sensor definitions parallel to the plasma flow direction. Therefore, it is necessary to define which of the 2 possibilities are defined for the virtual instrument in question.

  2. Plot Availability

    Each check box lets you define which plot types are available for the data.

    You must have the ability to plot scalar plots. Data at higher dimensions can usually be reduced to scalar data.

    Scanning with no angular information should be enabled if the data is spectrogram capable. You must also have a scan dependency defined.

    If the data has angular information defined (theta or azimuthal), check the "Scanning w/ang." option. You must also have a scan dependency and a spin rate or sensors have a theta constant defined in the VIDF.

    If they data has a set of longitudes or latitudes defined, you can enable imaging.

  3. Averaging dependencies

    These variables indicate on what the sensor data depends. There are three methods on which dependencies may exist. The first is through the scan variable, the second is through the presence of an instrument spin rate, and the last is through a dependency on one or more variables which change as a function of sensor (e.g. mass, charge, theta)

  4. Limits

    If a dependency exists, one must define the limits. If phi is defined and is cyclic, the limits are automatically set to 0.0 and 360.0.

Bins

The method is the method used to bin the data. It can be either fixed sweep or variable sweep.

The minimum and maximum are the center values of the defined binning array.

The scaling is used in computing the bin widths. It can be either linear or log. If the scaling is log, the min and max must be greater than zero.

The number of bins is the number of contiguous bins in the binning array. This number must not be zero.

Units

The unit id is used to catagorize the unit definition. A unit id of zero indicates a universal field - one that can be plotted without restriction. Other unit ids are defined elsewhere.

The limits are a minimum and maximum range when using this unit definition.

The scaling to be used is either linear or log when plotting the data.

The label is the dimensional specification of the unit in abbreviated format. Use "dimensionless" or "unitless" if the measurement is dimensionless.

The long description is used to give an appropriate description of the units being defined.

The short description must describe the unit in five characters or less.

The tables are the VIDF tables numbers used in the algorithm which will convert the IDFS data into physical units. Tables are to be defined in the order which they are used.

The operations are all defined numerically. For each tables, you MUST have an associated operation.

Sensors

The name is the name of the sensor - keep it short!

If the sensor is included within a sensor group containing multiple sensors, this field is a component name used to distinguish it from the other members within the group. If there is no other members within the group, the field should be set to N/A.

The sensor source can be either from a VIDF or an SCF. If it is from an SCF, you must also enter an SCF filename.

The VIDF sensor number is the sensor number in the VIDF. These must correspond.

The group number is the group to which this sensor belongs. The number is determined by the position of the group within the group name list. Note that the groups are numbered starting at zero.

The display flag may or may not be utilized by various applications to prevent a sensor whose data is questionable from being selectable for display.

The scan block field need only be defined if scan has been defined in the PIDF Measures Available.

The units field are a list of units for which this sensor data is applicable. Separate each unit by a space and start the numbers at unit 0.

The bin indices field are a list of integer values that identifies which binning definition is to be used for the sensor in question. There should be one bin index specified for each scan unit definition pointed to in the scan block selected for this sensor. If there are no bin sets defined for the scan block selected, no bin index values should be specified. Separate each index by a space and start the numbers at 0.

Scan

Each scan unit can have multiple units defined within it.

There are several ways to define the individual scan units. If you have any units defined, click on a unit on the list on the right and its values will be shown. If you click on "Add", a new one will be made, thereby copying the old one. Click "Update" to update the old one. "Delete" will delete the currently selected unit.

The spacing can be either equal logarithmic, linear, or variable.

The "Index to Units" is a number corresponding to a Unit in the PIDF.

If you selected "Variable" spacing, you must specify the relation between the scan values returned and the scan bin. Pick "Upper edges" of the scan bins, "center" of the scan bin, or "Lower edges" of the scan bins.

The last index is another index to a unit number which specifies the widths of the bins.

Calibration

The calibation block needs a name, a short name, a vidf number, and a list of units.

The name is intended to be a longer name used in descriptions for the programs.

The short name is intended to be used for the plots.

The VIDF calibration number is to be the calibration set number as defined in the VIDF.

The units are units defined as valid for this data set. Enter each unit number seperated by a space.

If the calibration data modifies the sensor data, check "Sensor", otherwise check "Scan". If it does modify the sensor data, list each sensor seperated by a space. If it modifies all sensors, enter a -1.

Mode

Modes also need a name, short name, vidf number, and units.

The name is the long name used in a description.

The short name is used for the plots.

The number of the mode in the VIDF should be specified in the mode number.

The units are units defined as valid for this data set. Enter each unit number seperated by a space.

Data Quality

The Data Quality block also needs a name, short name, and units.

The name is the long name used in a description.

The short name is used for the plots.

The units are units defined as valid for this data set. Enter each unit number seperated by a space.

Pitch Angle

The Pitch Angle block also needs a name, short name, and units.

The name is the long name used in a description.

The short name is used for the plots.

The units are units defined as valid for this data set. Enter each unit number separated by a space.

Spin Angle

The Spin Angle block also needs a name, short name, and units.

The name is the long name used in a description.

The short name is used for the plots.

The units are units defined as valid for this data set. Enter each unit number separated by a space.

Spacecraft Potential

The Spacecraft Potential block also needs a name, short name, units and used in unit number specification.

The name is the long name used in a description.

The short name is used for the plots.

The units are units defined as valid for this data set. Enter each unit number separated by a space.

The used in unit number(s) specifies the unit numbers in which spacecraft potential data is utilized to convert Sensor or Scan data into scientific units.

Background

The Background block also needs a name, short name, and units.

The name is the long name used in a description.

The short name is used for the plots.

The units are units defined as valid for this data set. Enter each unit number separated by a space.

Moments

The Moments block also needs a mass, scan unit, sensor unit and charge.

The mass is the mass of the species, expressed in units of kilograms.

The scan unit is the unit number for the velocity scan unit.

The sensor unit is the unit number for the differential number flux unit.

The charge defines the amount of charge within the plasma.

Coordinate System

The Coordinate System block also needs a default coordinate system and the coordinate system(s) to which the data can be transformed into.

The default coordinate system is the coordinate system in which the data is stored.

The coordinate systems available for transformation define which coordinate systems the data can be transformed into.


Wizards


Currently, three wizards are available to automate certain repetitive tasks.

The first wizard allows for the creation of the PIDF itself. Basically, all this does is go through each of the menus in the "Edit" section and lets you fill in the right answers. It can save you time in that you do not have to click through each of the menus to edit the sections. The downside is you have to go in order. The "Cancel" button will only cancel the current window; all the information entered on previous windows will still be saved.

The second wizard available allows you to create/modify the PIDF based upon the contents of the VIDF file loaded.

The final wizard will make sure the PIDF is syntactially correct. It will also do basic error checking by making sure the PIDF has all the required fields. The checker is unable to know if the values entered in the PIDF make sense.