= SPC-OREx Naming Convention =

||Category B ||Version 3.0.1 ||

== Description ==

This provides more information about the naming conventions used in SPC-OREx.

 * INSTRUME keyword defines which camera system.  
 * MTR_POS defines either filter position (MapCam, SamCam) or focal distance (PolyCam).  

== More detail about FITS Keywords ==

=== Level 0 Images ===
==== Character Position 1 ====
1st character is based on Camera: 
  || MapCam || M ||
  || PolyCam || P ||
  || SamCam  || S ||
  || NavCam  || N ||
  || TAGCam  || T ||

==== Character Positions 2-10 ====
ET in seconds

==== Character Position 11 ====
Always 'F'

==== Character Position 12 ====
 * MapCam - based upon the filter wheel position (CAMERAID = 1)
  ||Filt Pos ||char ||
  ||0 ||0 ||
  ||720 ||0 ||
  ||630 ||1 ||
  ||540 ||2 ||
  ||450 ||3 ||
  ||360 ||4 ||
  ||270 ||5 ||
  ||180 ||6 ||
  ||90 ||7 ||
  ||30 ||7 ||


 * SamCam - based upon the filter wheel position (CAMERAID = 2)
  . /!\ Filter position is defined with variable NQ and stored in [[make_sumfiles.in]] 
  ||Filt Pos ||char ||
  ||0 ||0 ||
  ||720 ||0 ||
  ||600 ||1 ||
  ||480 ||2 ||
  ||360 ||3 ||
  ||240 ||4 ||
  ||120 ||5 ||



 * PolyCam - (CAMERAID = 3)
  What it really is:
  {{{
        Find the index (I) that is closest to motor position
        Then
           K=93-I

        IF(K.LT.0) K=93-K
        I=K/10

       Position 11 => CHAR(65+I)   # 65 is an upper case 'A'
       Position 12 =>  K - 10*I     # (goes from 0 to 9)
}}}
  . /!\ J4 and up are "super focus" positions. A0 to J2 are nominal positions.
  ||Index ||Motor Pos ||11&12 Char ||
  ||1 ||> 630 ||J2 ||
  ||... || || ||
  ||93 || > 17190  ||A0 ||
  ||94 || > 17371 ||J4 ||
  ||... || || ||
  ||116 || > 21510 ||L6 ||


   Here is the source from PROCESS_FITS.f:
  {{{
     IF(NC.EQ.3) THEN
        NQ=FLT
        K=0
        DO I=116,0,-1
          IF(NQ.LE.STEP(I+1)) K=93-I
        ENDDO
        IF(K.LT.0) K=93-K
        I=K/10
        K=K-10*I
        PICNM(11:11)=CHAR(65+I)
        FLT=K
      ENDIF
...
      WRITE(PICNM(12:12),FMT='(I1)') FLT
}}}
  * NavCam (CAMERAID = 4)
   . FLT = 0

  * NFTCam (CAMERAID =5)
   . FLT = 0

=== Level 1 Images ===
  Everything is the same except for Character Position 11

 * PolyCam
  . PICNM(11:11)=CHAR(ICHAR(PICNM(11:11))+13)
 * MapCam, NavCam, etc.
  . G
----------
CategoryThreeOhOne