stella
Category DART |
Version 1.0 |
Description
Stella is a program that matches up stars in images with stars in a star catalog and records that information in a few types of output files. The output information includes information on the positions of the stars in the image, how well the stars correlate, and some rough information about the brightness of the stars. Those files are then used by a program called distortion to compute a K matrix and distortion model for a camera. The solved-for K matrix and distortion parameters can then be entered into make_sumfiles.txt and INIT_LITHOS.TXT, respectively, for use in SPC.
Input Files
- INIT_LITHOS.TXT
- make_sumfiles.txt
- make_sumfiles.in
- The star catalogs in the STARS2019 directory
- (optional) quaternions.txt
Output Files
- CORRPLOTS/corrplotXXXX.txt
- MAGFILES/IMAGENAME.MAG
- REGFILES/IMAGENAME.REF
Note: Stella writes one "REG" file and one "MAG" file for each image for which stella correlates stars in the image with stars in the star catalog. If stella finds no stars in the image, then it does not write out REG or MAG files.
Prerequisites
- You need to have compiled stella.f and distortion.f. These are included in the DART-Updates branch of the blessed code in Github.
- You need to have STARS2019 copied to /usr/local/spc/stars/
- You need an SPC directory with CORRPLOTS, MAGFILES, and REGFILES directories.
- You need an INIT_LITHOS.TXT
- You need a make_sumfiles.txt
- You need to have run PROCESS_FITS to make .DAT files. (You do not need to have run make_sumfiles.)
Using shape_coverage
1. Run shape_coverage.
shape_coverage SHAPEFILES/SHAPE.TXT smin smax tol minpic
where smin is the minimum maplet scale in km you wish to include, smax is the maximum maplet scale in km you wish to include, tol is a search range along surface normal (i.e., how far to search for a maplet; same idea as densify), and minpic in the minimum number of pictures. If set to 0, then all maplets will be considered.
2. Use COVERAGE.TXT as an input to shape2mapsA
shape2mapsA SHAPEFILES/COVERAGE.TXT
3. Use view_shapeA to visualize the coverage on the shape. Note that if you only run view_shape, you will not see the coverage.