nisp

NISP-specific tools, including a ZemaxPositions handler.

ZemaxPositions(simulations[, colname]) Zemax simulated positions, in spectroscopic or photometric mode.
spectrogrism.nisp.NISP_R = OptConfig([('name', 'NISP-R'), ('wave_ref', 1.5e-06), ('wave_range', [1.25e-06, 1.85e-06]), ('telescope_flength', 24.5), ('grism_dispersion', 9.8), ('grism_prism_material', 'FS'), ('grism_grating_material', 'FS'), ('grism_prism_angle', 0.036267941856442165), ('grism_grating_rho', 13.09), ('grism_grating_blaze', 0.04537856055185257), ('detector_pxsize', 1.8e-05), ('collimator_flength', 1.924), ('collimator_gdist_x0', -0.00031), ('collimator_gdist_y0', 0.0546), ('collimator_gdist_K1', 0.447), ('grism_prism_tiltx', -0.10530153153699122), ('grism_prism_tilty', 0.006574073515845309), ('grism_prism_tiltz', 0.002207841503772827), ('camera_flength', 0.9755), ('camera_gdist_x0', 0.0018), ('camera_gdist_y0', 0.2185), ('camera_gdist_K1', -0.0625), ('detector_dx', 0.000656), ('detector_dy', 0.00088)])

NISP effective optical configuration, R-grism

Note

The detector plane is tiled with 4×4 detectors of 2k×2k pixels of 18 µm; the spectrograph has a mean magnification (NISPPlateScale) of 0.5 approximately. Hence a focal plane of approximately 29×29 cm².

class spectrogrism.nisp.ZemaxPositions(simulations, colname='psfcmm')[source]

Zemax simulated positions, in spectroscopic or photometric mode.

Zemax configuration modes (‘confNB’):

  • 1: B-grism (NISP-S)
  • 2, 3, 4: R-grisms (NISP-S)
  • 5, 6, 7: Y, J, H (NISP-P)

Initialize from simulations = {mode: filename}.

colnames = ['confNb', 'wave', 'xindeg', 'yindeg', 'ximgmm', 'yimgmm', 'pxsize', 'nxpup', 'nypup', 'nximg', 'nyimg', 'ximgcpx', 'yimgcpx', 'ximgcmm', 'yimgcmm', 'xpsfcmm', 'ypsfcmm', 'ee50mm', 'ee80mm', 'ee90mm', 'ellpsf', 'papsfdeg']

Input column names

orders

Dispersion orders (int modes).

bands

Undispersed photometric bands (string modes).

classmethod read_simulation(filename, colname='psfcmm')[source]

Read single-mode simulation.

Parameters:
  • filename (str) – input simulation filename
  • colname (str) – column name suffix to be used as output positions (in mm)
Returns:

(wavelength, input coordinates) dataframe
Return type:

pandas.DataFrame

Warning

this function relies on pandas.DataFrame.pivot(). Because of Pandas issue #12666 and related Numpy issue 7535, this requires Numpy >= v1.11.

get_simcfg()[source]

Generate a spectrogrism.spectrogrism.SimConfig corresponding to current simulation.

plot_input(ax=None, **kwargs)[source]

Plot input coordinates [deg].

plot_output(ax=None, modes=None, subsampling=0, **kwargs)[source]

Plot output (detector-level) positions [mm].

plot_offsets(other, ax=None, mode=1, nwaves=3)[source]

Plot output (detector-level) coordinate offsets [px].