add setup_sim_to_match_data function

[mperrin]

Another simple PR adding a single-purpose utility function that I wrote a while ago.

The function setup_sim_to_match_data takes the filename of some observed JWST data, and sets up a simulated instrument instance to match it. The match includes choice of instrument, detector and detector position based on APERNAME, filter, any image or pupil masks relevant, and the closest available WFS.

This is all straightforward, it just provides convenience to have a function that automates this setup.

Example usage:

[codecov]

Codecov Report

Patch coverage: 18.42% and project coverage change: -0.23% ⚠️

Comparison is base (081584d) 55.94% compared to head (d5d9ec5) 55.72%.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #706      +/-   ##
===========================================
- Coverage    55.94%   55.72%   -0.23%     
===========================================
  Files           15       16       +1     
  Lines         6281     6319      +38     
===========================================
+ Hits          3514     3521       +7     
- Misses        2767     2798      +31     

Files Changed	Coverage Δ
webbpsf/match_data.py	16.21% <16.21%> (ø)
webbpsf/__init__.py	96.77% <100.00%> (+0.10%)	⬆️

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[obi-wan76]

Looks good, and very useful. I tried it with a NIRCam LW observation.

Setting up sim to match jw02787001001_03101_00001_nrcblong_cal.fits
iterating query, tdelta=3.0

MAST OPD query around UTC: 2023-03-23T01:16:55.666
                        MJD: 60026.053422060184

OPD immediately preceding the given datetime:
	URI:	 mast:JWST/product/R2023032202-NRCA3_FP1-1.fits
	Date (MJD):	 60025.1392
	Delta time:	 -0.9142 days

OPD immediately following the given datetime:
	URI:	 mast:JWST/product/R2023032504-NRCA3_FP1-1.fits
	Date (MJD):	 60027.8043
	Delta time:	 1.7508 days
User requested choosing OPD time closest in time to 2023-03-23T01:16:55.666, which is R2023032202-NRCA3_FP1-1.fits, delta time -0.914 days
Downloading URL https://mast.stsci.edu/api/v0.1/Download/file?uri=mast:JWST/product/R2023032202-NRCA3_FP1-1.fits to /Users/melendez/WFSC_Flight/webbpsf-data-1_2_0/MAST_JWST_WSS_OPDs/R2023032202-NRCA3_FP1-1.fits ... [Done]
Importing and format-converting OPD from /Users/melendez/WFSC_Flight/webbpsf-data-1_2_0/MAST_JWST_WSS_OPDs/R2023032202-NRCA3_FP1-1.fits
Backing out SI WFE and OTE field dependence at the WF sensing field point

Configured simulation instrument for:
    Instrument: NIRCam
    Filter: F277W
    Detector: NRCB5
    Apername: NRCB5_FULL
    Det. Pos.: (1024, 1024) 
    Image plane mask: None
    Pupil plane mask: None

[obi-wan76]

Looks good. NIRCam LW test in the comments.

[obi-wan76]

@BradleySappington Let's try to get this into the next release.