Add IMAP_HRC frame to SpiceFrame enum and update science frames kernel to v1.2.0

[Copilot]

Adds the new IMAP_HRC (Heliospheric Ram Corotating) SPICE frame introduced in imap_science_120.tf to the SpiceFrame enum, updates all kernel references from v1.0.0 to v1.2.0, and makes the new frame available to L2 ENA maps.

Changes

• New kernel imap_science_120.tf (v1.2.0): replaces imap_science_100.tf in both tests/spice/test_data/ and ultra/l1c/sim_spice_kernels/. Adds the IMAP_HRC frame at ID -43930 — a TWO-VECTOR parameterized frame with X aligned to the heliospheric ram direction and Z to the solar rotation axis (IAU_SUN), making it distinct from IMAP_HRE which uses the ecliptic normal for Z.

• SpiceFrame enum (spice/geometry.py): added IMAP_HRC = -43930 after IMAP_GCS.

• All kernel references updated from imap_science_100.tf → imap_science_120.tf across 15 files.

• ena_maps/utils/naming.py: refactored get_map_coord_frame to dynamically look up SpiceFrame[f"IMAP_{frame_str.upper()}"] in a try/except block instead of a hardcoded if/elif chain. Any KeyError (unrecognized frame) is re-raised as NotImplementedError, preserving existing error behavior. "hrc" added to _coord_frame_str_types.

class SpiceFrame(IntEnum):
    ...
    IMAP_GCS = -43929
    IMAP_HRC = -43930  # new: Heliospheric Ram Corotating

# Before: hardcoded if/elif per frame
# After: dynamic lookup — works for any current or future IMAP_* frame
try:
    return SpiceFrame[f"IMAP_{frame_str.upper()}"]
except KeyError:
    raise NotImplementedError(f"Coordinate frame {frame_str} is not yet implemented.")

Test Coverage

• The existing test_spice_frame_enum iterates over all SpiceFrame members and asserts each maps to a valid frame ID in the loaded kernel — this automatically covers IMAP_HRC.
• test_get_map_frame updated to assert "hrc" → SpiceFrame.IMAP_HRC.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>SPICE - Add IMAP_HRC frame to SpiceFrame</issue_title>
<issue_description>### Algorithm Description:

Nick has added the frame to the imap science frames kernel. This ticket is for adding that frame to the SpiceFrame enum.

1. Add the new imap_science_120.tf to the repo in the tests/spice/test_data directory, replacing imap_science_100.tf
2. Replace all references to imap_science_100.tf with the new imap_science_120.tf
3. Add the new IMAP_HRC frame defined in the new imap science frame kernel to the SpiceFrame enum in spice/geometry.py
4. Check test coverage of the SpiceFrame. There may be tests that iterate over SpiceFrame members that provide needed test coverage. If not, add test coverage exercising some geometry calculation using the new IMAP_HRC frame.
   </issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes SPICE - Add IMAP_HRC frame to SpiceFrame #2767

---

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

[subagonsouth]

@copilot, please remove the old science frames kernel: imap_science_100.tf from the spice test_data directory.

[Copilot]

@copilot, please remove the old science frames kernel: imap_science_100.tf from the spice test_data directory.

Done — removed imap_science_100.tf and added imap_science_120.tf to tests/spice/test_data/ in commits b068493 and 5a17e8c. (The file required force-adding since test_data/ is in .gitignore.)

[subagonsouth]

LGTM

[lacoak21]

LGTM! Im not really sure what that new frame is but its not a blocker and ill ask at the next tagup.

[subagonsouth]

@copilot,
I noticed that the new frame needs to be made available to L2 maps. See the function here: https://github.com/IMAP-Science-Operations-Center/imap_processing/blob/dev/imap_processing/ena_maps/utils/naming.py#L393

I suggest modifying that function to try instantiating the SpiceFrame using `f"IMAP_{frame.upper()}" or similar in a try/except block so that the frames don't need to be explicitly mapped in that function.

[Copilot]

@copilot,
I noticed that the new frame needs to be made available to L2 maps. See the function here: https://github.com/IMAP-Science-Operations-Center/imap_processing/blob/dev/imap_...

Done in commit 174a0fa. get_map_coord_frame now uses SpiceFrame[f"IMAP_{frame_str.upper()}"] in a try/except block, so IMAP_HRC (and any future IMAP_* frames) are automatically available. I also added "hrc" to _coord_frame_str_types and a corresponding test assertion.

[jtniehof]

LGTM! Im not really sure what that new frame is but its not a blocker and ill ask at the next tagup.

It's a frame that's oriented to the center of the IBEX ribbon which we suspect has something to do with an axis of symmetry in the interstellar medium (hand-wavey).

[tech3371]

LGTM

[lacoak21]

LGTM! Im not really sure what that new frame is but its not a blocker and ill ask at the next tagup.

It's a frame that's oriented to the center of the IBEX ribbon which we suspect has something to do with an axis of symmetry in the interstellar medium (hand-wavey).

Got it thanks!