Search the tnames array for the instring, returning the index in tnames if it is present, or -1 if it is not. TJK this function is in a separate file called TAGindex.pro since its called from many different routines in this system. FUNCTION TAGindex, instring, tnames instring = STRUPCASE(instring) ; tagnames are always uppercase a = where(tnames eq instring,count) if count eq 0 then return, -1 $ else return, a(0) end +------------------------------------------------------------------------ NAME: AMI_ISTPPTR PURPOSE: Return true(1) or false(0) depending on whether or not the given attribute name qualifies as an ISTP pointer-class attribute. CALLING SEQUENCE: out = amI_ISTPptr(attribute_name) INPUTS: attribute_name = name of a CDF attribute as a string KEYWORD PARAMETERS: OUTPUTS: True(1) or False(0) AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY:

NAME: AMI_VAR PURPOSE: Return true(1) or false(0) depending on whether or not the given attribute name's value is assigned to a real CDF variable name. CALLING SEQUENCE: out = amI_VAR(attribute_name) INPUTS: attribute_name = name of a CDF attribute as a string KEYWORD PARAMETERS: OUTPUTS: True(1) or False(0) AUTHOR: Tami Kovalick March 6, 2000 MODIFICATION HISTORY:

NAME: PARSE_DISPLAY_TYPE PURPOSE: Parse and examine the input string. It should be the value of the CDF attribute 'DISPLAY_TYPE'. Return an array of variable names that it 'points' to. CALLING SEQUENCE: out = parse_display_type(instring) INPUTS: instring = string, value of a CDF attribute called 'DISPLAY_TYPE' KEYWORD PARAMETERS: OUTPUTS: out = string array, names of other variables required for display NOTES: This routine expects to find 'DISPLAY_TYPE' values looking like: PLOT_TYPE>x=vname,y=vname ... PLOT_TYPE>y=vname,z=vname(*,1),z=vname(*,2) ... AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY: TJK modified 01/27/98 to not parse orbit display type here - the items specified for the orbit plot type aren't additional variables. TJK modified 09/25/2001 to not parse the "symsize" keyword because its value isn't a variable.

NAME: follow_myDEPENDS PURPOSE: Search the metadata anonymous structure for ISTP 'DEPEND' attributes. If and when found, add the variable name that it points to to the vnames array if it is not already present, and increase the size of the dhids and mhids arrays. CALLING SEQUENCE: follow_myDEPENDS, metadata, vnames, dhids, mhids INPUTS: metadata = anonymous structure holding attribute values vnames = string array of the names of variables already processed vvarys = string array of the record variance for each variable dhids = array of data handle id's mhids = array of metadata handle id's KEYWORD PARAMETERS: OUTPUTS: dhids = array of data handle id's mhids = array of metadata handle id's AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY:

NAME: APPEND_MYDATA PURPOSE: Append the 'new' data to the 'old' data using array concatenation. CALLING SEQUENCE: out = append_mydata(new,old) INPUTS: new = data to be appended to the old data old = older data that new data is to be appended to KEYWORD PARAMETERS: OUTPUTS: out = product of concatenating the old and new data arrays NOTES: Special case check: if old data was from either a skeleton CDF or from a CDF with only a single record, then the last dimension was dropped during the process of saving/retrieving the data from a handle. Must compare the dimensionality of the new and old data to determine if this drop has occured, and if so, reform the old data to include the extra dimension so that the data can be appended. AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY:

NAME: add_myDEPENDS PURPOSE: Search the metadata anonymous structure for ISTP 'DEPEND' attributes and add the variable name that it points to to the vnames array if it is not already present. If the DEPEND variable is not present in the list, change the data_type so it won't be plotted. CALLING SEQUENCE: add_myDEPENDS, metadata, vnames INPUTS: metadata = anonymous structure holding attribute values vnames = string array of virtual variables found OUTPUTS: vnames = modified variable name that includes component variable names NOTES - this is similar to follow_myDEPENDS, except it does less. AUTHOR: Tami Kovalick, QSS, 11/29/2006

NAME: add_myCOMPONENTS PURPOSE: Search the metadata anonymous structure for ISTP 'COMPONENT' attributes and add the variable name that it points to to the vnames array if it is not already present. If the component variable is not present in the list, change the data_type so it won't be plotted. CALLING SEQUENCE: add_myCOMPONENTS, metadata, vnames INPUTS: metadata = anonymous structure holding attribute values vnames = string array of virtual variables found OUTPUTS: vnames = modified variable name that includes component variable names AUTHOR: Carrie Gallap, Raytheon STX, 1/5/98

NAME: READ_MYVARIABLE PURPOSE: Return the data for the requested variable. CALLING SEQUENCE: out = read_myvariable(vname, CDFid, vary, dtype, recs) INPUTS: vname = string, name of variable to be read from the CDF CDFid = integer, id or already opened CDF file. KEYWORD PARAMETERS: START_REC = first record to read. REC_COUNT = number of records to read. OUTPUTS: out = all data from the CDF for the variable being read vary = True(1) or False(0) is variable record-varying dtype= string, CDF data type recs = integer, number of data records AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY: 96/04/11 : R.Burley :zVar handling when MAXRECS = -1 changed to read REC_COUNT of MAXRECS + 2 & return,DAT 96/12/20 ; T. Kovalick modified to take START_REC and REC_COUNT keywords (see above). If they aren't set you will get all of the records in a cdf.

NAME: READ_MYATTRIBUTE PURPOSE: Return the value of the requested attribute for the requested variable. CALLING SEQUENCE: out = read_myattribute(vname,anum,CDFid) INPUTS: vname = string, name of variable whose attribute is being read anum = integer, number of attribute being read CDFid = integer, id of already opened CDF file. KEYWORD PARAMETERS: OUTPUTS: out = anonymous structure holding both the name of the attribute and the value of the attribute AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY: RCJ 11/2003 Added keyword isglobal

NAME: READ_MYMETADATA PURPOSE: To read all of the attribute values for the requested variable, and to return this information as an anonymous structure. CALLING SEQUENCE: metadata = read_mymetadata(vname,CDFid) INPUTS: vname = string, name of variable whose metadata is being read CDFid = integer, id of already opened CDF file KEYWORD PARAMETERS: OUTPUTS: metadata = anonymous structure whose tags are the attribute names and whose fields are the corresponding attribute values. AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY:

NAME: Getvar_attribute_names CDFid PURPOSE: To return all of the attribute names for the requested variable, as an array. CALLING SEQUENCE: att_array = getvar_attribute_names(vname,CDFid, ALL=ALL) INPUTS: CDFid = integer, id of already opened CDF file KEYWORD PARAMETERS: ALL - all attributes are returned default is that just variable scoped attributes are returned OUTPUTS: att_array = string array of attribute names AUTHOR: Tami Kovalick tami.kovalick@gsfc.nasa.gov (301)286-9422 MODIFICATION HISTORY:

NAME: GET_NUMALLVARS PURPOSE: To return the total number of variables in the cdf. CALLING SEQUENCE: num_vars = get_numallvars(CNAME=CNAME) INPUTS: KEYWORD PARAMETERS: CNAME = string, name of a CDF file to be opened and read CDFid = integer, id of an already opened CDF file OUTPUTS: num_vars = number of variables in the CDF AUTHOR: Tami Kovalick, RITSS, October 27, 2000 MODIFICATION HISTORY:

NAME: GET_ALLVARNAMES PURPOSE: To return a string array containing the names of all of the variables in the given CDF file. CALLING SEQUENCE: vnames = get_allvarnames() INPUTS: KEYWORD PARAMETERS: CNAME = string, name of a CDF file to be opened and read CDFid = integer, id of an already opened CDF file VAR_TYPE = string, only return the names for variables who have an attribute called 'VAR_TYPE' and whose value matches the value given by this keyword. (ex. VAR_TYPE='data') OUTPUTS: vnames = string array of variable names AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 13, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY: 4/9/1998 - TJK modified to include all variable when the "var_type" keyword isn't used. The original code only included variables that vary by record so some important "support_data" variables were being thrown out.