Modify noproj/cam2cam to Project OffBody Pixels

[KrisBecker]

Description

Enhance noproj and cam2cam to essentially project all pixels in the focal plane - on and/or off the target body - to the output image. This has been extremely useful in detecting and tracking ejected particles from Bennu's surface.

Two program parameters were added - OFFBODY and OFFBODYTRIM.

OFFBODY=TRUE will project both target body and background pixels according to the distortion model. The NAVCAM camera has a rather prominent fisheye/barrel distortion. Applying noproj to these images computes the undistorted images preserving the entire image.

OFFBODYTRIM=TRUE will result in only the background pixel data to be projected into the output cube. The shape model is used to determine if the pixel is on or off the body. All pixels on the body are set to NULL in the output image so just the background data is preserved. This was a useful option since many of the NAVCAM images had to be overexposed. Projecting only the background pixels simplified detecting and processing the particles.

Default behavior is preserved with both parameters set to FALSE - the default.

Example

Here is the interface options of the two programs with the options.

[10]: noproj -h
FROM = Null
MATCH = Null
SPECS = Null
TO = Null
SOURCE = (*FROMMATCH, FROMINPUT, FROMUSER)
SUMMINGMODE = Null
INTERP = (NEARESTNEIGHBOR, BILINEAR, *CUBICCONVOLUTION)
SAMPEXP = 0.0
LINEEXP = 0.0
OFFBODY = FALSE
OFFBODYTRIM = FALSE

[11]: cam2cam -h
FROM = Null
MATCH = Null
TO = Null
REFBAND = Null
INTERP = (NEARESTNEIGHBOR, BILINEAR, *CUBICCONVOLUTION)
OFFBODY = FALSE
OFFBODYTRIM = FALSE

[jessemapel]

Why this is important

Particle events and plumes are of scientific interest on various small bodies. On Bennu, particles have been found off the surface of the body and this modification was required to produce high quality data. On CG-67P, there are several surface plumes captured in imagery. This enhancement would help scientists study these plumes. I do not doubt that we will see further examples of "off-body" material in future missions to small and irregular bodies.

@rbeyer Would this also help with #3371?

[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.

[artmathgirl]

Please reopen.

[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.

If you want to participate in our support prioritization meetings or be notified when support sprints are happening, you can sign up the support sprint notification emails here.

Read more about our support processs here

[artmathgirl]

Please keep this issue active. Related PR #5704 for cam2cam is in review. Upcoming PR for noproj is in work. Thank you! Sarah On Jan 30, 2025, at 8:04 AM, github-actions[bot] ***@***.***> wrote: External Email

…

________________________________ 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. If you want to participate in our support prioritization meetings or be notified when support sprints are happening, you can sign up the support sprint notification emails here<https://public.govdelivery.com/accounts/USDOIGS/signup/39118>. Read more about our support processs here<https://astrogeology.usgs.gov/docs/how-to-guides/software-management/software-support/> — Reply to this email directly, view it on GitHub<#3602 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/ADSF7MUDLBQQHOYU7IW4GAT2NI5RJAVCNFSM6AAAAABL26X5T6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDMMRUG42DMNBYGM>. You are receiving this because you commented.Message ID: ***@***.***> Sarah S. Sutton, PhD ------------------------------------------- Photogrammetry Program<https://www.lpl.arizona.edu/research/photogrammetry> Lead R&D Engineer/Scientist Lunar and Planetary Laboratory University of Arizona Charles P. Sonett Space Sciences 1541 E. University Blvd. Tucson, AZ 85721