Differences between revisions 6 and 24 (spanning 18 versions)

make_sumfiles.in

Category B

Version 3.0.1

Description

This text file is a list of the image files needed by make_sumfiles to create SUMFILES and NOMINALS. It is created by process_fits an becomes an input for make_sumfiles.

make_sumfiles.in contains these 6 columns:

image name loaded into process_fits
spacecraft time of each image
camera number that took the image
spacecraft number for mission
bin
UTC time of each image

The vectors in the sumfiles and nominals are calculated directly from the kernels in make_sumfiles.txt by using the time for each image obtained from make_sumfiles.in.

The following sample make_sumfiles.in is from OSIRIS_REx.

$/!\$ This sample is in the format necessary for the OSIRIS-OREx mission. Spacecraft time is needed to use CK kernels while epoch time is needed for spk kernels. Spacecraft, UTC, and epoch time can be transformed into one another pretty easily using spice, which SPC uses.

P596924821J3    3/0596924726.30615          3    1    1    -25.50       270     20181201T082552S75100Z_pol_L0_V002.fits
P601296494J3    1/0601296429.38732          3    1    1    -25.50       270     2019-01-20T22-47-05.541_PCAM_L0b_V004.fits
...

Column Definitions

PICNM	CLK	NC	NS	SCL	TC	NQ	FITSNM
SPC-OREx Naming	UTC or ET	Camera 1-5	Spacecraft Number	Binning (none)	Temperature in C	Filter/Focal	Source filename

Camera Number [NC]
1. SamCam
2. MapCam
3. PolyCam
4. NavCam
5. NFTCam

Filter Number -- MapCam has filters based upon its position -- in degrees

Position	Filter Number
0	0
720	0
630	1
540	2
450	3
360	4
270	5
180	6
90	7
30	7

Filter Number --SamCam has filters based upon its position -- in degrees

Position	Filter Number
0	0
720	0
600	1
480	2
360	3
240	4
120	5

Focal Position -- PolyCam NQ=FLT

The motor position, 0 to 17,400

where:

d is the distance the camera is focused at in m

For practical reasons the infinity setting we use in the lab is actually
~4.3 km (PolyCam step 17,400) not actual infinity. At that setting we
measured the effective focal length 627.8mm. Based on the formula above
it means our CBE for finf is 628.9mm so until we get a better number from
post launch calibration images we should use

f(d) = 628.9 - 2684 * d ^ -0.9376

(Compiled by EP)

old - make_sumfiles.in-3.0A2

CategoryThreeOhOne

-  ⇤ ← Revision 6 as of 2016-01-14 10:27:52 → 
  Size: 2190
  Editor: KristoferDrozd
  Comment:
+   ← Revision 24 as of 2017-12-26 13:56:21 → ⇥
  Size: 2693
  Editor: EricPalmer
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 2:
+||Category B ||Version 3.0.1 ||
-Line 3:
+Line 4:
-This text file, make_sumfiles.in, is an input for the make_sumfiles executable and an output (created by) from [[process_img]].  The text file contains 5 columns which are the image name loaded into [[process_img]], spacecraft time of each image, camera number that took the image, spacecraft number for mission, bin (not sure what this means), and UTC time of each image.  Essentially, make_sumfiles.in is a list of the images files needed for [[make_sumfiles]] to create [[SUMFILES]] and [[NOMINALS]]. The vectors in the sumfiles and nominals are calculated directly from the kernels in [[make_sumfiles.txt]] by using the time for each image obtained from make_sumfiles.in.
 Line 5:
-The user should be aware that the example about to be shown is in the format necessary for the OSIRIS-ORex mission. UTC time may not be needed for other missions and the spacecraft time might be in another format.
+== Description ==
This text file is a list of the image files needed by [[make_sumfiles]] to create [[SUMFILES]] and [[NOMINALS]]. It is created by [[process_fits]] an becomes an input for [[make_sumfiles]].
-Line 7:
+Line 8:
-Just as a side note, spacecraft time is needed to use CK kernels while epoch time is needed for spk kernels. Spacecraft, UTC, and epoch time can be transformed into one another pretty easily using spice, which SPC uses, so it is unclear why two types of time are included in the OSIRIS-REx make_sumfiles.in. However, Bob Gaskell probably knows why.
== Example From OSIRIS_Rex ==
+'''make_sumfiles.in''' contains these 6 columns:

 * image name loaded into [[process_fits]]
 * spacecraft time of each image
 * camera number that took the image
 * spacecraft number for mission
 * bin
 * UTC time of each image

The vectors in the [[sumfiles]] and [[nominals]] are calculated directly from the kernels in [[make_sumfiles.txt]] by using the time for each image obtained from '''make_sumfiles.in'''.

The following sample '''make_sumfiles.in''' is from OSIRIS_REx.

 . /!\ This sample is in the format necessary for the OSIRIS-OREx mission.
 (!) Spacecraft time is needed to use CK kernels while epoch time is needed for spk kernels. Spacecraft, UTC, and epoch time can be transformed into one another pretty easily using spice, which SPC uses.
-Line 11:
+Line 25:
-P595650043F2    1/0595649979.53969          3    1    1    2018-11-16T14:19:35.816_
P595650073F2    1/0595650009.53969          3    1    1    2018-11-16T14:20:05.816_
P595650103F2    1/0595650039.53969          3    1    1    2018-11-16T14:20:35.816_
P595650136F2    1/0595650072.53969          3    1    1    2018-11-16T14:21:08.816_
+P596924821J3    3/0596924726.30615          3    1    1    -25.50       270     20181201T082552S75100Z_pol_L0_V002.fits
P601296494J3    1/0601296429.38732          3    1    1    -25.50       270     2019-01-20T22-47-05.541_PCAM_L0b_V004.fits
...
-Line 16:
+Line 29:
+Column Definitions
||PICNM ||CLK ||NC ||NS ||SCL ||TC ||NQ ||FITSNM ||
||SPC-OREx Naming ||UTC or ET ||Camera 1-5 ||Spacecraft Number ||Binning (none) ||Temperature in C ||Filter/Focal ||Source filename ||
-Line 17:
+Line 33:
-== Example From Other Mission ==
+ * Camera Number [NC]
  1. SamCam
  1. MapCam
  1. PolyCam
  1. NavCam
  1. NFTCam

Filter Number -- MapCam has filters based upon its position -- in degrees
||Position ||Filter Number ||
||0 ||0 ||
||720 ||0 ||
||630 ||1 ||
||540 ||2 ||
||450 ||3 ||
||360 ||4 ||
||270 ||5 ||
||180 ||6 ||
||90 ||7 ||
||30 ||7 ||




Filter Number --SamCam has filters based upon its position -- in degrees
||Position ||Filter Number ||
||0 ||0 ||
||720 ||0 ||
||600 ||1 ||
||480 ||2 ||
||360 ||3 ||
||240 ||4 ||
||120 ||5 ||




Focal Position -- PolyCam NQ=FLT

 * The motor position, 0 to 17,400
-Line 19:
+Line 77:
-FC21A0014662    377642737:125    2    1    1                                                         
FC21A0014663    377642812:125    2    1    1                                                         
FC21A0014664    377642887:126    2    1    1                                                         
FC21A0016638    379008279:125    2    1    1   
...
+where:

d is the distance the camera is focused at in m

For practical reasons the infinity setting we use in the lab is actually
~4.3 km (PolyCam step 17,400) not actual infinity. At that setting we
measured the effective focal length 627.8mm. Based on the formula above
it means our CBE for finf is 628.9mm so until we get a better number from
post launch calibration images we should use

f(d) = 628.9 - 2684 * d ^ -0.9376
-Line 25:
+Line 89:
+----------
''(Compiled by EP)''
-Line 26:
+Line 92:
-== Another Example ==
{{attachment:make_sumfiles.in.jpg||width=600}}
+old - [[make_sumfiles.in-3.0A2]]
----
CategoryThreeOhOne