<?xml version="1.0" encoding="UTF-8"?>

<Spase xmlns="http://www.spase-group.org/data/schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.spase-group.org/data/schema http://cdpp.irap.omp.eu/AMDA-NG/public/schemas/spase-amda-1_2_0.xsd">

   <Version>2.2.6</Version>
   <NumericalData>
      <ResourceID>spase://CDPP/NumericalData/AMDA/MAVEN/SWIA/mav-swia-kp</ResourceID>
      <ResourceHeader>

         <ResourceName>ions : key parameters</ResourceName>
         <AlternateName>SWIA : ions considered as protons : key parameters</AlternateName>

         <ReleaseDate>2017-03-12T10:48:29Z</ReleaseDate>
         <Description>Data follow a 4-second cadence when MAVEN is at an altitude of less than 500 km, otherwise the time cadence is 8 seconds.     

          The in situ key parameters contain 235 parameters selected by the instrument leads and other MAVEN scientists. These data consist of values derived from L2 data provided by the in situ instruments.</Description>
         <Acknowledgement> Principal Investigator : Jasper Halekas, Univ. Iowa, Iowa City</Acknowledgement>

         <Contact>        
            <PersonID>spase://CDPP/Person/Jasper.S.Halekas</PersonID>
            <Role>PrincipalInvestigator</Role>
         </Contact>
         <Contact>        
            <PersonID>spase://CDPP/Person/P.Dunn</PersonID>

            <Role>DataProducer</Role>

         </Contact>
         <InformationURL>
            <Name>SWIA web page, Summary sheet </Name>
            <URL>http://lasp.colorado.edu/home/maven/science/instrument-package/swia/</URL>
           <Description>             
           </Description>
         </InformationURL>       
      </ResourceHeader>
      <AccessInformation>
         <RepositoryID>spase://SMWG/Repository/CDPP/AMDA</RepositoryID>
         <Availability>Online</Availability>
         <AccessRights>Open</AccessRights>
         <AccessURL>
            <Name>AMDA at CDPP</Name>
            <URL>http://amda.cdpp.eu</URL>
         </AccessURL>
         <Format>Text.ASCII</Format>
         <Acknowledgement> AMDA is a science analysis system provided by the Centre de Donnees de la 
            Physique des Plasmas (CDPP) supported by CNRS, CNES, Observatoire de Paris and 
            Universite Paul Sabatier, Toulouse            
         </Acknowledgement>
      </AccessInformation>
      <ProviderName>PDS</ProviderName> 

      <ProviderResourceName>/maven-insitu-calibrated</ProviderResourceName>

      <InstrumentID>spase://CDPP/Instrument/AMDA/MAVEN/SWIA</InstrumentID>
      <MeasurementType>ThermalPlasma</MeasurementType>
      <TemporalDescription>
         <TimeSpan>

             <StartDate>2014-10-06T00:00:00Z</StartDate>

             <StopDate>2018-05-14T23:59:52Z</StopDate>

         </TimeSpan>
       <Cadence_Min>PT4S</Cadence_Min>
       <Cadence_Max>PT8S</Cadence_Max>  
      </TemporalDescription>
      <ObservedRegion>Mars</ObservedRegion>
      <Caveats>Quality flag (0 = bad, 1 = good) indicats whether the distribution is well-measured and decommutation parameters are definite.                       
        All SWIA Key Parameters are derived from onboard-computed moments. These moments are computed under the assumption that all ions are protons, and that the entire distribution is within the field of view and the energy range of the instrument.
The quality flag in the KP files attempts to identify and flag those cases where a significant portion of the distribution is outside of SWIA's field of view and/or outside of the energy range of the instrument, but the computation of the quality flag is not infallible and there may still be cases where part of the distribution is missing. Meanwhile, there is no quality flag or correction for multi-ion issues.
Thus, SWIA key parameter data taken inside the induced magnetospheric boundary should typically not be used for quantitative purposes. Even in the solar wind, which is ~94-97% protons, there are some values which cannot be used quantitatively, since the moments are computed over a distribution which includes not only the protons, but also ~3-6% alpha particles with twice the energy per charge. This has only a few percent effect on the density and velocity moments, so these values can safely be relied on, but even a small alpha population leads to an artificially large temperature moment (particularly the component aligned with the flow, which is often 2x or more higher than the true value).
Thus, the SWIA temperature moments cannot typically be used for quantitative purposes [for qualitative purposes they may be okay in the solar wind and magnetosheath].
Those wishing to look quantitatively at solar wind temperature should use the SWIA Level 2 3-d Fine data and use appropriate routines to separately compute proton and alpha temperature.
      </Caveats>    
      <Parameter>
         <Name>density</Name>
         <ParameterKey>mav_swiakp_n</ParameterKey>
         <Description>Total ion density from SWIA onboard moment calculation, assuming 100% protons</Description>
         <Ucd>phys.density;phys.atmol.ionStage</Ucd>
         <Units>cm-3</Units>
         <UnitsConversion/>
         <Particle>
            <ParticleType>Ion</ParticleType>
            <ParticleQuantity>NumberDensity</ParticleQuantity>
         </Particle>

      </Parameter> 
      <Parameter>
         <Name>moments quality</Name>
         <ParameterKey>mav_swiakp_qual</ParameterKey>
         <Description>Quality flag (0 = bad, 1 = good) indicating whether the distribution is well-measured and decommutation parameters are definite</Description>
         <Ucd/>
         <Units/>
         <UnitsConversion/>
         <Support>
            <SupportQuantity>Other</SupportQuantity>
         </Support>

      </Parameter>
      <Parameter>
         <Name>v_mso</Name>
         <ParameterKey>mav_swiakp_vmso</ParameterKey>
         <Description>Bulk ion flow velocity from SWIA onboard moment calculation, assuming 100% protons</Description>
         <Ucd>phys.veloc;phys.atmol.ionStage</Ucd>
         <Units>km/s</Units>
         <UnitsConversion/>
         <Structure>
            <Size>3</Size>
            <Element>
               <Name>vx</Name>

               <Index>1</Index>
               <ParameterKey>mav_swiakp_vmso(0)</ParameterKey>
               <ValidMin/>
               <ValidMax/>
               <FillValue/>
            </Element>
            <Element>
               <Name>vy</Name>

               <Index>2</Index>
               <ParameterKey>mav_swiakp_vmso(1)</ParameterKey>
               <ValidMin/>
               <ValidMax/>
               <FillValue/>
            </Element>
            <Element><Name>vz</Name>

               <Index>3</Index>
               <ParameterKey>mav_swiakp_vmso(2)</ParameterKey>
               <ValidMin/>
               <ValidMax/>
               <FillValue/>
            </Element>
         </Structure>
         <Particle>
            <ParticleType>Ion</ParticleType>
            <ParticleQuantity>Velocity</ParticleQuantity>
         </Particle>
      </Parameter>
        <Parameter>
         <Name>|v|</Name>
         <ParameterKey>mav_swiakp_vtot</ParameterKey>
         <Description>Bulk ion flow velocity magnitude from SWIA onboard moment calculation, assuming 100% protons</Description>
         <Ucd>phys.veloc;phys.atmol.ionStage</Ucd>
         <Units>km/s</Units>
         <UnitsConversion/>         
         <Particle>
            <ParticleType>Ion</ParticleType>
            <ParticleQuantity>Velocity</ParticleQuantity>
         </Particle>
      </Parameter>
      <Parameter>
         <Name>temperature</Name>
         <ParameterKey>mav_swiakp_t</ParameterKey>
         <Description> Scalar ion temperature from SWIA onboard moment calculation, assuming 100% protons</Description>
         <Ucd>phys.temperature;phys.atmol.Ionstage</Ucd>
         <Units>eV</Units>
        <UnitsConversion/>              
         <Particle>
            <ParticleType>Ion</ParticleType>
            <ParticleQuantity>Temperature</ParticleQuantity>
         </Particle>          

      </Parameter>       

      <Parameter>
         <Name>dynamic pressure</Name>
         <ParameterKey>mav_swiakp_pdyn</ParameterKey>
         <Description>Ion dynamic pressure computed on the SWIA ground from density and velocity moments, assuming 100% protons</Description>
         <Ucd>phys.temperature;phys.atmol.Ionstage</Ucd>
         <Units>nPa</Units>
        <UnitsConversion/>              
         <Particle>
            <ParticleType>Ion</ParticleType>
            <ParticleQuantity>Pressure</ParticleQuantity>
         </Particle>          
      </Parameter>
   </NumericalData>
</Spase>