Use a subset of pixels when creating a margin cache.

[delucchi-cmu]

Change Description

Closes #312

Adds an argument to explicitly limit the margin generation with a subset of pixels in the primary catalog. Since this is primarily useful when debugging, the argument name reflects that.

NB: This requires changes to provenance info JSON serialization that will be included in https://github.com/astronomy-commons/hipscat/pull/279.

Code Quality

• [x] I have read the Contribution Guide and LINCC Frameworks Code of Conduct
• [x] My code follows the code style of this project
• [x] My code builds (or compiles) cleanly without any errors or warnings
• [x] My code contains relevant comments and necessary documentation

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 99.56%. Comparing base (53b4b0f) to head (1258181).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #323 +/- ## ======================================= Coverage 99.56% 99.56% ======================================= Files 26 26 Lines 1372 1379 +7 ======================================= + Hits 1366 1373 +7 Misses 6 6 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.