Extract Pre-Existing statistics from the CameraStatistics Table Object in caminfo

[KrisBecker]

Description

The caminfo application computes a rather large amount of useful geometric and observational data for a given image when CAMSTATS=TRUE. Much of this data is redundant with data computed by the camstats application which adds the data to the cube in a Table object called CameraStatistics. We added an option to read the data from the CameraStatistics table rather than recompute each time in caminfo. This can save considerable time as loading shape models to required to compute this data can take a lot of time.

A new parameter called USECAMSTATSTBL=TRUE was added to select this option in caminfo. caminfo changed some of the names of the columns so they are preserved, however all the camstats data is written to the output data file.

A typo in the AspectRatioMinimum was fixed and "Angle" was removed from some of the keyword labels to remain compatible with established results.

This feature will break backward compatibility if order and content of the results are required.

Example

Here is an example using this option:

Object = Caminfo

 Object = Parameters
   Program     = caminfo
   From        = 20190328T182543S3900_pol_iofL2pan.cub
   Lines       = 1024
   Samples     = 1024
   Bands       = 1
 End_Object

 Object = Camstats
   MinimumLatitude                          = -89.252345
   MaximumLatitude                          = -1.039447
   MinimumLongitude                         = 57.422518
   MaximumLongitude                         = 339.012629
   MinimumResolution                        = 0.045611
   MaximumResolution                        = 0.050794
   MinimumPhase                             = 51.832420
   MaximumPhase                             = 52.950741
   MinimumEmission                          = 35.281018
   MaximumEmission                          = 137.845448
   MinimumIncidence                         = 77.315236
   MaximumIncidence                         = 147.598320
   LocalTimeMinimum                         = 8.165505
   LocalTimeMaximum                         = 21.661715
   LatitudeMinimum                          = -89.252345
   LatitudeMaximum                          = -1.039447
   LatitudeAverage                          = -79.697153
   LatitudeStandardDeviation                = 3.896915
   LongitudeMinimum                         = 57.422518
   LongitudeMaximum                         = 339.012629
   LongitudeAverage                         = 278.278843
   LongitudeStandardDeviation               = 24.130508
   SampleResolutionMinimum                  = 0.045611
   SampleResolutionMaximum                  = 0.050794
   SampleResolutionAverage                  = 0.045837
   SampleResolutionStandardDeviation        = 1.739509e-04
   LineResolutionMinimum                    = 0.045611
   LineResolutionMaximum                    = 0.050794
   LineResolutionAverage                    = 0.045837
   LineResolutionStandardDeviation          = 1.739509e-04
   ResolutionMinimum                        = 0.045611
   ResolutionMaximum                        = 0.050794
   ResolutionAverage                        = 0.045837
   ResolutionStandardDeviation              = 1.739509e-04
   ObliqueSampleResolutionMinimum           = 0.055875
   ObliqueSampleResolutionMaximum           = 0.072828
   ObliqueSampleResolutionAverage           = 0.062054
   ObliqueSampleResolutionStandardDeviation = 0.004073
   ObliqueLineResolutionMinimum             = 0.055875
   ObliqueLineResolutionMaximum             = 0.072828
   ObliqueLineResolutionAverage             = 0.062054
   ObliqueLineResolutionStandardDeviation   = 0.004073
   ObliqueResolutionMinimum                 = 0.055875
   ObliqueResolutionMaximum                 = 0.072828
   ObliqueResolutionAverage                 = 0.062054
   ObliqueResolutionStandardDeviation       = 0.004073
   AspectRatioMinimum                       = 1.0
   AspectRatioMaximum                       = 1.0
   AspectRatioAverage                       = 1.0
   AspectRatioStandardDeviation             = 0.0
   PhaseMinimum                             = 51.832420
   PhaseMaximum                             = 52.950741
   PhaseAverage                             = 52.395677
   PhaseStandardDeviation                   = 0.232526
   EmissionMinimum                          = 35.281018
   EmissionMaximum                          = 137.845448
   EmissionAverage                          = 42.023091
   EmissionStandardDeviation                = 4.273678
   IncidenceMinimum                         = 77.315236
   IncidenceMaximum                         = 147.598320
   IncidenceAverage                         = 84.876335
   IncidenceStandardDeviation               = 3.651786
   LocalSolarTimeMinimum                    = 8.165505
   LocalSolarTimeMaximum                    = 21.661715
   LocalSolarTimeAverage                    = 12.333387
   LocalSolarTimeStandardDeviation          = 1.593742
   LocalRadiusMinimum                       = 237.025506
   LocalRadiusMaximum                       = 251.915269
   LocalRadiusAverage                       = 241.741461
   LocalRadiusStandardDeviation             = 1.692599
   NorthAzimuthMinimum                      = 0.093394
   NorthAzimuthMaximum                      = 359.762841
   NorthAzimuthAverage                      = 132.052515
   NorthAzimuthStandardDeviation            = 81.114880
 End_Object
End_Object
End

[jessemapel]

Why this is important

When working with large DSK shape models, the largest cost in almost any process is the instantiation of the shape model. For this reason, regenerating all of the camstats is a very expensive operation when processing data from irregular bodies. By re-using previously generated statistics, caminfo can be much more efficiently.

[ascbot]

I am a bot that cleans up old issues that do not have activity.

This issue has not received feedback in the last six months. I am going to add the inactive label to
this issue. If this is still a pertinent issue, please add a comment or add an emoji to an existing comment.

I will post again in five months with another reminder and will close this issue on it's birthday unless it has
some activity.

[jessemapel]

This is still outstanding

[github-actions]

Thank you for your contribution!

Unfortunately, this issue hasn't received much attention lately, so it is labeled as 'stale.'

If no additional action is taken, this issue will be automatically closed in 180 days.