= Test F3H - Latitude =

'''Goal:''' Physical characteristics of the object.  The maximum variation in sub-solar position is a function of the latitude of the TAG site.  The higher in latitude the TAG site is, the lower quality the variations in Sun vector.  Thus, we can get a better idea about how big this error is as we move to the polar regions.

== Test Set Up ==

'''Data:'''  Detailed Survey.

'''Start:'''  75cm Preliminary Survey Shape Model. 

'''Build:'''  Build TAG Site 1 for each Sub-Test, but using different images than standard.  Because the shape model has different topography, we would not be able to build a TAG Site at each latitude and compare results -- RMS is strongly effected by variations in topography.  As such, we will adjust the position of the Sun so that the images match the observing/illumination conditions that DS would have if TAG Site 1 was at different latitudes.  

=== Sub-Test F3H-1 to F3H-9 ===

For each Sub-Test, we start with the Preliminary Survey Shape Model.  We build the topography using the Detailed Survey Images that are available at each latitude.  Images will need to be generated with Bennu with the Sun position that cannot really exist.  Either Bennu can be inclined by the needed number of degrees with the pole and date matching the summer solstist, or the SPOC has tools to generate images and SUMFILES for specific illumination geometries.   The SPOC has conducted similar variations in illumination parameters so this is well understood.  For this test, the SPOC would use Imager_MG to generate the images, which generated almost all of the images needed for Test F2-Calibration.  The Test Engineer has compared the output of Freespace and Imager_MG and has determined that the variations between the two systems are not significant.  

'''Details for Sub-Test F3H-1 to F3H-9:'''
||Sub-Test||Latitude||Number of Images||Emission Range||Incidence Range||RMS w/ opt trans rot (cm)||RMS w/o opt trans rot (cm)||
||Preliminary Survey||NA||NA||NA||NA||19||59 ||
||F3H-1||0°||TBD||TBD||TBD||21||71||
||F3H-2||-8°||TBD||TBD||TBD||
||F3H-3||-20°||TBD||TBD||TBD||16||70||
||F3H-4||-30°||TBD||TBD||TBD||
||F3H-5||-40°||TBD||TBD||TBD||18||67||
||F3H-6||-50°||TBD||TBD||TBD||
||F3H-7||-60°||TBD||TBD||TBD||20||72||
||F3H-8||-70°||TBD||TBD||TBD||14||75||
||F3H-9||-80°||TBD||TBD||TBD||

'''Evaluate:'''
 * Relative Accuracy.  Create truth models for each of the latitude TAG sties.  Then compute the RMS deviation between the truth and the model.  

'''Examples:'''

{{attachment:F3H-ex1.png}}
{{attachment:F3H-ex2.png}}
{{attachment:F3H-ex3.png}}
{{attachment:F3H-ex4.png}}


= Directory Setup =
Run from the F3H-Lat directory

== 0. Start typescript ==
{{{
script
date
pwd
ls -l

}}}

== 1. Create Sub-Test directory ==
{{{
rsync --delete  -ha orig/ test/

}}}

== 2. Add Sub-Test images ==
 * '''/SPC_Test/F3H-Lat/base/IMAGEFILES/ should already have all the images. We will control the images used by SPC via PICTLIST.TXT'''
 * '''Should also set up a PICTLIST.TXT for each sub-test and put it in lsupport/'''

=== 2.1 User Input ===
{{{
testID=F3H-X
}}}
=== 2.2 Copy and/or link files ===
{{{
cp registered_images/$testID/NOMINALS/* test/NOMINALS/
ls -l test/NOMINALS
cp registered_images/$testID/SUMFILES/* test/SUMFILES/
ls -l test/SUMFILES
rm test/PICTLIST.TXT
cp lsupport/PICTLIST_$testID.TXT test/PICTLIST.TXT
cat test/PICTLIST.TXT
mkdir test/log
}}}

== 3. Tile at 20cm ==
Execute tile block with 20cm GSD.

[[F3H-Tile]]


== 4. Iterate ==
Execute iteration

[[F3H-Iterate]]

== 5. Tile at 10cm ==
Execute tile block with 10cm GSD.

[[F3H-Tile]]

== 6. Iterate ==
Execute iteration

[[F3H-Iterate]]

== 7. Clean landmarks ==
Execute [[Block 7B - Clean Bigmap]]

== 8. Geometry ==
[[Block 8 - Geometry/Residuals]]

Before running geometry, make sure there are no outliers. Run RESIDUALS with the following inputs...
{{{
5 .005 .0002
}}}

== 9. Iterate ==
Execute iteration

[[F3H-Iterate]]
== 10. Tile at 5cm ==
Execute tile block with 5cm GSD.

[[F3H-Tile]]

== 11. Iterate ==
Execute iteration

[[F3H-Iterate]]

== 12. Clean landmarks ==
Execute [[Block 7B - Clean Bigmap]]

Ensure the following states:

 * Tiled
 * Correlated
 * Imaged
 * Fitted
 * Geometry ( use 5 .0025 .0001 in RESIDUALS prior to running GEOMETRY)
 * Residualed ( use 5 .001 .00005)
 * Re-tiled

Do not ensure Sigma'ed since SIGMAS.TXT doesn't have enough significant figures for the ground sample distance this test requires.


== 13. Run Stats ==
[[F3H-Stats]]

== 14. Archive the test directory ==
{{{
mv test/ F3H-X_archive/ # X is the sub-test number
}}}