= make_sumfiles.txt = == Description == This configure file contains basic camera distortion data and a list of available SPICE kernels. It is used by [[make_sumfiles]] as a configuration file when generating [[SUMFILES]] and [[NOMINALS]]. At this time, '''make_sumfiles.txt''' is created by hand. == Creating make_sumfiles.txt == Here is a sample '''make_sumfiles.txt" file'''. Annotations on the right indicate what the data elements are. {{{ 4 NCAM 'ORX_OCAMS_MAPCAM' 1024 1024 NPXB, NLNB 125.0 512.5 512.5 MMFLB, PX0B, LN0B 117.647, 0, 0, 0, 117.647, 0 KMATB -1, -2, 3 PROJECT CAMERA AXES 5, 16383 T1,T2 'ORX_OCAMS_SAMCAM' 1024 1024 NPXC, NLNC 24.0 512.5 512.5 MMFLC, PX0C, LN0C 117.647, 0, 0, 0, 117.647, 0 KMATC 1, 2, 3 PROJECT CAMERA AXES 5, 16383 T1,T2 'ORX_OCAMS_POLYCAM' 1024 1024 NPXA, NLNA 611.0 512.5 512.5 MMFLA, PX0A, LN0A 117.647, 0, 0, 0, 117.647, 0 KMATA -1, -2, 3 PROJECT CAMERA AXES 5, 16383 T1,T2 'ORX_NAVCAM' 2592 1944 NPXC, NLNC 7.6 1296.5 972.5 MMFLC, PX0C, LN0C 454.54, 0, 0, 0, 454.54, 0 KMATC 1, 2, 3 PROJECT CAMERA AXES 5, 4096 T1,T2 1 NSC -64 ORX 1.d0 1.d0 1.d0 sigV0 1.d-3 1.d-3 1.d-3 sigPT 2101955 BENNU 'IAU_BENNU' BFRAME 'NONE' ABCORR '../ORex/DATA/' PREFIX KERNELS sb-101955-76.bsp bennu_v10.tpc de421.bsp naif0011.tls orex_ocams_v02.ti orx_aux_v01.ti orx_v03.tf pck00010.tpc ApproachPrelim_Perturbed.bsp DetailedSurvey_Perturbed.bsp OrbitalB_Perturbed.bsp ORX_SCLKSCET.00000.example.tsc F3A_AllObs_20181109T000000_20181118T000000_Perturbed.bc F3A_BD_AllObs_20190113T000000_20190122T120000_p.bc F3A_ES_Obs1_20190127T094200_20190127T161200_p.bc F3A_ES_Obs2_20190203T094300_20190203T161300_p.bc F3A_ES_Obs3_20190210T100500_20190210T163500_p.bc ... END_KRNLS }}} ==== Description of codes ==== || NCAM || Number of cameras in the file || || NPXV, NLNB or NPXC, NLNC, or NPXA, NLNA || Number of pixels and lines for the camera image || || MMFLB, PX0B, LN0B || focal length and center pixel/line of the camera || || PROJECT CAMERA AXIS || The axis of the camera mounted onto the spacecraft. This is the same thing that is described in all the frame kernels|| || T1, T2 || The min and maximum value of "accepted" values for the image's DN. Below and above this threshold, it denotes no data || || ORX || NAIF base code for the spacecraft || || sigV0 || The default value for the spacecraft object uncertainty, in km. Can be overwritten by DYNAMICS || || sigPT || The default value for the camera pointing uncertainty, in Rad. Can be overwritten by DYNAMICS || || BENNU || Asteroid number for the object. Used for SPICE Calls || || BFRAME || Object that defines the body fixed frame to be used in SPC || || ABCORR || Correction needed for adjustment for light speed (Aberration correction indicates the aberration corrections to be applied to the state of the target body to account for one-way light time and stellar aberration.) || || KERNELS || Here one lists all of the kernels that are needed to properly project spacecraft camera pointing onto the body-fixed surface || The '''make_sumfiles.txt''' file consists of three sections: === Camera Data Definitions === Enter the number of cameras that the file maintains (NCAM). List the following for each camera: * Camera Name * Pixels (sample and rows) * Focal length, center pixel (x/y) * K Matrix - distortion matrix * Min and max expected DN for this data type Enter sigV0 - The uncertainty of the spacecraft position [km] Enter sigPt - The uncertainty of the camera pointing [Rad] === Target Information === Enter the follow three rows: * the names of the ID of the target body * body fixed frame in the kernels * aberration correction desired === Kernel List === If the SPICE kernels are not in your working directory, give the path to the kernels (PREFIX). Start the SPICE kernels list with these two rows: {{{ KERNELS # }}} List each kernel on a separate row. /!\ When in doubt, list all the available kernels. Here is a list of kernels that are known to make [[make_sumfiles]] work: * '''SPK kernels (.bsp)''' - for spacecraft and target object - ephemeris * '''CK kernels (.bc)''' - orientation/attitude of spacecraft and other structures (like camera) * '''SCLK kernels (.tsc)''' - spacecraft clock coefficients * '''IK kernels (.ti)''' - instrument geometry for camera taking pictures * '''LSK kernels (.tls)''' - leap seconds * '''FK kernels (.tf)''' - reference frame specifications * '''PCK kernels (.tpc)''' - text form of planetary/asteroidal constants End the kernels list with this row: {{{ END_KRNLS }}} When processing [[make_sumfiles]] . '''If you get the "NOFRAMECONNECT" error (display says, "At epoch...")''' - You likely need a CK Kernel (.bc). . '''If you get the "SPKINSUFFDATA" error (display says, "Insufficient...")''' - You likely need a SPK Kernel (.bsp). == Additional Reference == Here is the same '''make_sumfiles.txt''' but with additional comments: {{attachment:make_sumfiles.txt.jpg||width=700}} ---------- ''(Compiled by KD)'' CategoryFiles CategoryInputFiles