Differences between revisions 4 and 15 (spanning 11 versions)
⇤ ← Revision 4 as of 2016-05-12 13:20:25 →
Size: 1748
Editor: DianeLambert
Comment:
← Revision 15 as of 2022-11-29 11:17:17 → ⇥
Size: 2825
Editor: DalyTerik
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:

||Category ?||Version 3.0||
Line 5: Line 7:
Updates the landmark center location (VLM), and map frame (UX, UY, and UZ) in the .LMK files. Update the .MAP files. Updates the spacecraft position (SCOBJ), camera unit vectors (CX, CY, and CZ), and Sun unit vector (SZ) in the SUMFILES and NOMINALS. This program solves for a user input old and new right ascension (RA), declination (DEC), prime meridian (PM), and rotation rate (OMEGA), and updates the landmark center locations and map frames, and the spacecraft position, camera unit vectors and Sun unit vectors in all relevant files.
Line 9: Line 11:
 * [[INIT_LITHOS.TXT]] - Initialization file which contains the parameter PCK, which defines the planetary constants for a variety of objects (such as Bennu or the Sun). This is required for SPICE function calls.
 * [[DATA]]/ - Directory containing SPICE kernels.		  * [[DATA]]/ - directory containing SPICE kernels.
 * [[INIT_LITHOS.TXT]] - initialization file which contains the parameter PCK, which defines the planetary constants for a variety of objects (such as Bennu or the Sun). This is required for SPICE function calls.
 * [[LMKFILES]]/ - directory containing .LMK files.
Line 12: Line 15:
 * [[MAPFILES]]/ - directory containing MAPFILES.
 * [[NOMINALS]]/ - directory containing the NOMINALS.
Line 13: Line 18:
 * [[SUMFILES]]/ - Directory containing picture .SUM files.  * [[SUMFILES]]/ - directory containing the SUMFILES.
Line 15: Line 20:
'''''' /!\ [[INIT_LITHOS.TXT]], [[DATA]]/, and [[LMRKLIST.TXT]] must be in the working directory. '''''' /!\ The required directories and files must be in the working directory.
Line 17: Line 22:
'''''' /!\ unlike [[pole]], new_pole does not require POLE.TXT. Instead the user inputs the pole RA, Dec, PM, OEMGA, via standard input. '''''' /!\ Unlike [[pole]], new_pole does not require POLE.TXT. Instead, you input the pole RA, Dec, PM, OEMGA, via standard input.

'''''' /!\ NEW_POLE does not correctly account for overlaps, according to Bob (October 2022). To avoid NaNs when running geometry or iterating the LMKs in lithos after running NEW_POLE, you should remove all overlaps from all landmarks before running either program.
Line 22: Line 29:
 1. Input the old right ascension (deg), declination (deg), prime meridian (deg), and rate of rotation (deg/day). === 1. Input the old right ascension (deg), declination (deg), prime meridian (deg), and rate of rotation (deg/day). ===
Line 26: Line 33:
86 -65 89.00000000 2010.48945 86   -65   89.00000000   2010.48945
Line 29: Line 36:
 1.#2 Input the new right ascension (deg), declination (deg), prime meridian (deg), and rate of rotation (deg/day). === 2. Input the new right ascension (deg), declination (deg), prime meridian (deg), and rate of rotation (deg/day). ===
Line 33: Line 40:
86.60062 -65.00002 90.42707 2009.99979311
Line 36: Line 43:
 1.#2 Input a time in UTC. === 3. Input a time in UTC. ===
Line 45: Line 52:
new_pole:
 * Updates the landmark center location (VLM), and map frame (UX, UY, and UZ) in the LMK files;
 * Updates the .MAP files;
 * Updates the spacecraft position (SCOBJ), camera unit vectors (CX, CY, and CZ), and Sun unit vector (SZ) in the SUMFILES;
 * Updates the spacecraft position (SCOBJ), camera unit vectors (CX, CY, and CZ), and Sun unit vector (SZ) in the NOMINALS.
 * Outputs the commands required to run [[GEOMETRY]].

Here is a sample output [[GEOMTERY]] commands:

{{{
 GEOMETRY
 10
 1
 n
 n
}}}
Line 47: Line 71:
'''Example POLE.TXT:" Here is a sample POLE.TXT:

new_pole

Category ?

Version 3.0

Description

This program solves for a user input old and new right ascension (RA), declination (DEC), prime meridian (PM), and rotation rate (OMEGA), and updates the landmark center locations and map frames, and the spacecraft position, camera unit vectors and Sun unit vectors in all relevant files.

Input Files

  • DATA/ - directory containing SPICE kernels.

  • INIT_LITHOS.TXT - initialization file which contains the parameter PCK, which defines the planetary constants for a variety of objects (such as Bennu or the Sun). This is required for SPICE function calls.

  • LMKFILES/ - directory containing .LMK files.

  • LMRKLIST.TXT - list of landmarks.

  • MAPFILES/ - directory containing MAPFILES.

  • NOMINALS/ - directory containing the NOMINALS.

  • PICTLIST.TXT - list of pictures.

  • SUMFILES/ - directory containing the SUMFILES.

/!\ The required directories and files must be in the working directory.

/!\ Unlike pole, new_pole does not require POLE.TXT. Instead, you input the pole RA, Dec, PM, OEMGA, via standard input.

/!\ NEW_POLE does not correctly account for overlaps, according to Bob (October 2022). To avoid NaNs when running geometry or iterating the LMKs in lithos after running NEW_POLE, you should remove all overlaps from all landmarks before running either program.

Using new_pole

1. Input the old right ascension (deg), declination (deg), prime meridian (deg), and rate of rotation (deg/day).

 enter old RA, DEC, PM, OMEGA
86   -65   89.00000000   2010.48945

2. Input the new right ascension (deg), declination (deg), prime meridian (deg), and rate of rotation (deg/day).

 enter new RA, DEC, PM, OMEGA
86.60062   -65.00002    90.42707  2009.99979311

3. Input a time in UTC.

  • /!\ Make sure the time is within the span supported by the kernels. 

 Input epoch UTC0
2018 NOV 16 13:09:54.824

new_pole:

  • Updates the landmark center location (VLM), and map frame (UX, UY, and UZ) in the LMK files;
  • Updates the .MAP files;
  • Updates the spacecraft position (SCOBJ), camera unit vectors (CX, CY, and CZ), and Sun unit vector (SZ) in the SUMFILES;
  • Updates the spacecraft position (SCOBJ), camera unit vectors (CX, CY, and CZ), and Sun unit vector (SZ) in the NOMINALS.

  • Outputs the commands required to run GEOMETRY.

Here is a sample output GEOMTERY commands: 

 GEOMETRY
 10
 1
 n
 n

new_pole generates a POLE.TXT file in which it records the new RA, DEC, PM, and OMEGA.

Here is a sample POLE.TXT: 

    86.60062   -65.00002    90.42707  2009.99979311

(Compiled by DL)

CategoryPrograms

new_pole (last edited 2022-11-29 11:17:17 by DalyTerik)