scopesim.effects.shifts module

class scopesim.effects.shifts.AtmosphericDispersion(**kwargs)

Bases: Shift3D

Used to generate the wavelength bins based on shifts due to the atmosphere.

Doesn’t contain an apply_to function, but provides information through the fov_grid function.

get_table(**kwargs)

Called by the fov_grid method of Shift3D.

Returns:

tblastropy.Table

A table with the columns - waves : [um] - dx, dy : [arcsec]

Notes

Success! Returns the same values as: http://gtc-phase2.gtc.iac.es/science/astroweb/atmosRefraction.php

required_keys = {'airmass', 'altitude', 'humidity', 'latitude', 'pixel_scale', 'pressure', 'pupil_angle', 'temperature'}

class scopesim.effects.shifts.AtmosphericDispersionCorrection(**kwargs)

Bases: Shift3D

Alters the position on the detector for a FOV object (WCS_prefix=”D”).

Only acts on FOVs during the main effects loop in OpticalTrain. For the sake of computational efficiency, the ADC can be instructed to counteract the atmospheric diffraction during the OpticalTrain setup phase, by passing the kwarg: quick_adc=True

Parameters:

kwargs

apply_to(fov, **kwargs)

See parent docstring.

fov_grid(which='shifts', **kwargs)

See parent docstring.

plot()

required_keys = {'airmass', 'altitude', 'humidity', 'latitude', 'pixel_scale', 'pressure', 'pupil_angle', 'temperature', 'wave_mid'}

class scopesim.effects.shifts.Shift3D(**kwargs)

Bases: Effect

apply_to(obj, **kwargs)

See parent docstring.

fov_grid(which='shifts', **kwargs)

See parent docstring.

get_table(**kwargs)

plot()

scopesim.effects.shifts.atmospheric_refraction(lam, z0=60, temp=0, rel_hum=60, pres=750, lat=-24.5, h=3064)

Compute atmospheric refraction.

The function computes the angular difference between the apparent position of a star seen from the ground and its true position.

Parameters:

lamfloat, np.ndarray

[um] wavelength bin centres

z0float, optional

[deg] zenith distance. Default is 60 deg from zenith

tempfloat, optional

[deg C] ground temperature. Default is 0 deg C

rel_humfloat, optional

[%] relative humidity. Default is 60%

presfloat, optional

[millibar] air pressure. Default is 750 mbar

latfloat, optional

[deg] latitude. Default set for Cerro Armazones: 24.5 deg South

hfloat, optional

[m] height above sea level. Default is 3064 m

Returns:

angfloat, np.ndarray

[arcsec] angle between real position and refracted position

References

See Stone 1996 and the review by S. Pedraz - http://www.caha.es/newsletter/news03b/pedraz/newslet.html

scopesim.effects.shifts.get_pixel_border_waves_from_atmo_disp(**kwargs)

TBA.

Parameters:

**kwargsTYPE

DESCRIPTION.

Returns:

wave_pixel_edgesTYPE

DESCRIPTION.

shifts_angle_edgesTYPE

DESCRIPTION.