
================================================================================

CONTENT OF THE SPICAM/SPICAV UV 1A DATA STRUCTURE:	

================================================================================

 
    - "Cleandata" field: Data cleaned from :
      - Missing packets (set to NaN value)
      - Erroneous data (only for SPICAM data, (set to NaN value))
      - Saturated pixels (saturation value is 4095 ADU, (set to NaN value))
      - Impacted by comisc ray pixels ((set to NaN value))
      - Electronic noise
      - Dark charge
      format is a 3 dimensions float array containing the formatted data. 
      For a general case 5-band observation, the dimensions of
      the array are (Nb_Pixel=408,Nb_Spectrum,Nb_Band=5). For an Alignment
      mode observation the dimensions are (Nb_PixelX=408,Nb_PixelY=289,
      Nb_Image). Window mode dimensions are (XWidth,YWidth,Nb_Record)

   - "Flags" field: a 3 dimensions integer array of the same dimension as 
     the data fields.
     Flags have the following meaning:
     0: OK
     1: Missing data
     2: Erroneous data (SPICAM)
     3: Saturated data
     4: Data damaged by comisc rays
     5: Data corrected from electronic noise
     
   - "ErrorData" field:
    
   - "Info" sub-structure containing information about the
     input files and general observation characteristics 
     (tag names in parenthesis are specific to alignment
     observations):
	o NAxis1[Int]         : Number of pixels of the X-axis of the CCD, 
				i.e. number of points of each spectrum = 408 
				except for window mode.
	o NAxis2[Int]         : Number of 5-band spectra recorded throughout 
				observation. For alignment observation this 
				field corresponds to the number of pixels of 
				the Y-axis of the CCD = 289.
				For Window modes, it is the vertical width.
	o NAxis3[Int]         : Number of bands of the CCD = 5. For alignment 
				observations this is equal to the number of 
				complete mapping of the CCD.
				For Window mode this is equal to the number 
				of records.
	o Instrument[String]  : Instrument name
	o Orbit[Int]          : Orbit index of the mission.
	o Sequence[Int]       : Sequence index of the orbit.
	o ObsType[Char]       : Type of observation. Cf SPICAM/V documentation
	o BeginTime[String]   : Observation first recording time, 
				format=YYYY-MM-DDTHH:MM:SS.mSmSmS
	o EndTime[String]     : Observation last recording time, 
				format=YYYY-MM-DDTHH:MM:SS.mSmSmS
	o DCProc [Boolean]    : Dark Charge treatment
	o ENProc [Boolean]    : Electronic Noise Treatment
	o COSProc [Boolean]   : Cosmic rays pixels Treatment
	o SATProc [Boolean]   : Saturated pixels Treatment
	o File0C [String]     : 0C file used to build this 1A level
	o OrbDCNU [Int]       : Number of the DCNU Model orbit
	o Data_status [String]: Status of the Data 
				(F "Final" or "P" Preliminary)
	o Geo_status [String] : Status of the Geometry 
				(F "Final" or "P" Preliminary)
	o Flag_status [String]: Status of the Flag 
				(F "Final" or "P" Preliminary)
	o DC_status [String]  : Status of the Dark Charge correction 
				(F "Final" or "P" Preliminary)
      
  - "Parameters" sub-structure containing functional parameters 
    of the instrument. For 5-bands observations the "All_Ti" and 
    "T_..." fields are 1d of length the number of spectra. For 
    alignment modes they are 2d with size [nb_PixelY=289,nb_Image]:
	o CodeOp[Int]     : Operational code of observation. Cf SPICAM/V 
		            documentation
	o Binning[Int]    : Number of lines binned together to form a band. In 
			    case of progressive binning, the field si set to
			    string 'VARIABLE'
	o HT[Int]         : Digital scale of the High Voltage used to amplify 
			    signal. Ranging from 0 to 255. See SPICAM/V docu-
			    mentation for corresponding voltage
	o Ti[Int]         : Exposure Time of the CCD, in second/100. Usually 
			    constant throughout observation. If not the field is 
			    set to string 'VARIABLE'
	o X0[Int]         : X-axis first pixel index
	o Y0[Int]         : Y-axis first pixel index. Field is set to 'VARIABLE'
			    for alignment observations
	o Slit[boolean]   : 1 if slit is on, 0 else
	o Peltier[boolean]: 1 if Peltier cooler is on, 0 else
	o UVSampling[Int] : Sample rate of the spectrometer
	o IROn[boolean]   : 1 if IR channel is on, 0 else.
	o SoirOn[boolean] : 1 if SPICAV SOIR channel is on, 0 else. 255 for 
			    SPICAM.
	o All_Ti[Int]     : vector of all the time exposure throughout obser-
			    vation.
	o T_Peltier[Int]  : Temperature vector of Peltier's hot side 
			    (all temperatures ar given in C)
	o T_CCD[Int]      : Temperature vector of the CCD
	o T_NumBoard[Int] : Temperature vector of the digital board
	o T_BTBoard[Int]  : Temperature vector of the low tension board
	o T_Shutter[Int]  : Temperature vector of the solar shutter
	o T_ServBoard[Int]: Temperature vector of the servitudes board
	o T_HVPS[Int]     : Temperature vector of the High Voltage Power
			    Supply
	o T_Structure[Int]: Temperature vector of the structure
      
  - "GeoInfo" sub-structure containing geometrical parameters 
    of the instrument which do not vary during observation:
	o Target[String]   : Pointing target of the instrument. Cf SPICAM/V 
			     documentation for the star catalog.
	o SunLat[Float]    : Sun latitude planet body-fixed frame, at 
			     first record (deg)
	o SunLong[Float]   : Sun longitude planet body-fixed frame, at
			     first record (deg)
	o SunDist[ULong]   : Distance between planet and sun, at first
			     record (ua)
	o SunLS[Float]     : Sun solar longitude in the planet body-fixed
			     frame, at first record (deg)
	o SunRa[Float]     : Sun Ra, at first record (deg)
	o SunDec[Float]    : Sun Dec, at first record (deg)
	o SlitCenter[Float]: Position vector of the slit center in SC axes 
			     (=offset, deg)
	o ShadowCone[Char] : Trajectory of the spacecraft relatively to the 
			     planet shadow cone

  - "Geo" sub-structure containing the time, and geometrical
    parameters which vary during observation. Parameters are
    grouped by the following nested structure. For 5-bands observations
    the array is 1d of length the number of spectra. For alignment modes
    the array is 2d with size [nb_PixelY=289,nb_Image].
    NOTA: Depending on the type and mode of observations, the 
    sub-structures vary. Common sub-structures are: {Record,
    Spacecraft,Band3,Coordinates,TransMatrix}. All 5-band obser-
    vations have the folllowing added sub-structures: {Band1,
    Band2,Band4,Band5}. Star occultations have another sub-struc-
    ture which is {LineOfSight}. 
    Alignment modes have the specific sub-structure {CCDLine}.
	
        o Record: 
        + Number[Int] : observation record number, beginning at 1.
        + Time[String]: Record time, format=YYYY-MM-DDTHH:MM:SS.mSmSmS
     
	o Spacecraft: 
	+ Lat[Float]            : Latitude of the SC (deg)
        + Long[Float]           : Longitude of the SC (deg)
        + Alt[Float]            : Altitude of the SC in (km)
        + SZA[Float]            : Solar zenith angle of the SC (deg)
        + ShadowConeRatio[Float]: Ratio giving position of SC towards 
				planet shadow cone. If >1 then SC is
				outside the shadow cone else it's inside

	o Band3: 
	+ Sza[Float]                : Solar zenith angle of the 3rd band/central 
				      line of the CCD portion (deg)
	+ DistToPlanetNP[Float]     : Distance to the planet nearest point (km)
	+ PixelSize[Float]          : Pixel size at planet nearest point (km)
	+ AngleLOSSun[Float]        : Angle between line of sight and sun (deg)
	+ PhaseLOSSun[Float]        : Phase between line of sight at planet 
				      nearest point and sun(deg)
	+ SolarIncidence[Float]     : Solar incidence between normal at planet 
				      nearest point and sun (deg)
	+ SolarLocalTime[Float]     : Solar local time at planet nearest point 
	                              (deg)
	+ AngleNormalObserver[Float]: Angle between Normal and Observer (deg).
	+ DistLOSPlanetCenter[Float]: Distance between line of sight and planet 
				      center (km)
       
	     For non alignment modes only:
		 + Lat[Float] : Latitude of the 3rd Band  (deg)             
		 + Long[Float]: Longitude of the 3rd Band (deg)              
		 + Alt[Float] : Altitude of the 3rd Band (km)               
		 + Ra[Float]  : Ra of the 3rd Band  (deg)   
		 + Dec[Float] : Dec of the 3rd Band (deg)

	o Band1: + Lat[Float] : Latitude of the 1st Band (deg)              
		 + Long[Float]: Longitude of the 1st Band (deg)              
		 + Alt[Float] : Altitude of the 1st Band (km)               
		 + Ra[Float]  : Ra of the 1st Band (deg)     
		 + Dec[Float] : Dec of the 1st Band (deg)

	o Band2,Band4 and Band5 have the same corresponding fields

	o CCDLine has the same corresponding fields for each line 
	  of the CCD. For alignment observations this structure replaces
	  the missing Band3 fields

	o LOSE: Same fields as Band3 common fields, but associated to 
		the line of sight emanating from the UV CCD center, but 
		defined by S/C position and Star direction

	o Coordinates: 
	+ Xsc_X[Float]: X coordinate of the SC X-axis in MARSIAU/IAU_VENUS
        + Xsc_Y[Float]: Y coordinate of the SC X-axis in MARSIAU/IAU_VENUS
        + Xsc_Z[Float]: Z coordinate of the SC X-axis in MARSIAU/IAU_VENUS
        + Ysc_X[Float]: X coordinate of the SC Y-axis in MARSIAU/IAU_VENUS
        + Ysc_Y[Float]: Y coordinate of the SC Y-axis in MARSIAU/IAU_VENUS
        + Ysc_Z[Float]: Z coordinate of the SC Y-axis in MARSIAU/IAU_VENUS
        + Zsc_X[Float]: X coordinate of the SC Z-axis in MARSIAU/IAU_VENUS
        + Zsc_Y[Float]: Y coordinate of the SC Z-axis in MARSIAU/IAU_VENUS
        + Zsc_Z[Float]: Z coordinate of the SC Z-axis in MARSIAU/IAU_VENUS
        + Angle_Xsc_LocalVert[Float]: Angle between Xsc and local verti-
				     cal at planet nearest point (deg).
        + Angle_Xsc_Proj[Float]     : Angle between Xsc and the projec-
				     tion plan (PP) U-axis (deg)
        + P1_u[Float]: U coordinate of the horizon point in the PP
        + P1_v[Float]: V coordinate of the horizon point in the PP
        + P2_u[Float]: U coordinate of the horizon point in the PP
        + P2_v[Float]: V coordinate of the horizon point in the PP
        + P3_u[Float]: U coordinate of the horizon point in the PP
        + P3_v[Float]: V coordinate of the horizon point in the PP
        + P4_u[Float]: U coordinate of the horizon point in the PP
        + P4_v[Float]: V coordinate of the horizon point in the PP
        + P5_u[Float]: U coordinate of the horizon point in the PP
        + P5_v[Float]: V coordinate of the horizon point in the PP

	o TransMatrix: 
	+ X_Ra [Float]: Ra of the MARSIAU/IAU_VENUS to EMEJ2000 trans-
		       formation matrix X vector (deg)
        + X_Dec[Float]: Dec of the MARSIAU/IAU_VENUS to EMEJ2000 trans-
		       formation matrix X vector (deg)
        + Y_Ra [Float]: Ra of the MARSIAU/IAU_VENUS to EMEJ2000 trans-
		       formation matrix Y vector (deg)
        + Y_Dec[Float]: Dec of the MARSIAU/IAU_VENUS to EMEJ2000 trans-
		       formation matrix Y vector (deg)
        + Z_Ra [Float]: Ra of the MARSIAU/IAU_VENUS to EMEJ2000 trans-
		       formation matrix Z vector (deg)
        + Z_Dec[Float]: Dec of the MARSIAU/IAU_VENUS to EMEJ2000 trans-
		       formation matrix Z vector (deg)
				       
================================================================================

--------------------------------------------------------------------------------
Nicolas Chapron
CNRS | LATMOS - Laboratoire Atmospheres, Milieux, Observations Spatiales.
11 boulevard d'Alembert
78280 Guyancourt
France
Tel. 33-(0) 1 80 28 50 57
Email. nicolas.chapron@latmos.ipsl.fr
--------------------------------------------------------------------------------


