ExposureSimulator

class ctapointing.exposure.ExposureSimulator(**kwargs: Any)

Bases: Component

Class that simulates images of the sky.

Attributes Summary

ambient_pressure

ambient pressure

ambient_temperature

ambient temperature

apply_moonlight

apply moonlight simulation

apply_noise

apply noise in simulation

max_magnitude

maximum magnitude of stars that are simulated

min_magnitude

minimum magnitude of stars that are simulated

name

name of ExposureSimulator

num_time_steps

number of time steps used in simulation

num_unsharp_rays_leds

number of light rays simulated per LED

num_unsharp_rays_stars

number of light rays simulated per star

unsharp_radius

radius defining un-sharpness of stars

unsharp_radius_lid

radius defining the un-sharpness of reflected stars on lid

uuid

UUID of ExposureSimulator

Methods Summary

from_config(**kwargs)

Read an ExposureSimulator configuration from either configuration file or database.

process(camera, telescope_pointing, ...[, ...])

Perform the sky simulation.

Attributes Documentation

ambient_pressure

ambient pressure

ambient_temperature

ambient temperature

apply_moonlight

apply moonlight simulation

apply_noise

apply noise in simulation

max_magnitude

maximum magnitude of stars that are simulated

min_magnitude

minimum magnitude of stars that are simulated

name

name of ExposureSimulator

num_time_steps

number of time steps used in simulation

num_unsharp_rays_leds

number of light rays simulated per LED

num_unsharp_rays_stars

number of light rays simulated per star

unsharp_radius

radius defining un-sharpness of stars

unsharp_radius_lid

radius defining the un-sharpness of reflected stars on lid

uuid

UUID of ExposureSimulator

Methods Documentation

classmethod from_config(**kwargs)

Read an ExposureSimulator configuration from either configuration file or database. Either the path of a configuration file (‘input_url’) or a database collection (‘collection’) must be provided.

Parameters:
  • input_url (str or Path) – path of the configuration file.

  • name (str) – name of the ExposureSimulator (as in ExposureSimulator.name). When loading the configuration from file, can be set to check that the configuration with the correct name is loaded. When loading from database, is used to identify the correct database record.

  • uuid (str) – UUID of the camera (as in ExposureSimulator.uuid). When loading the configuration from file, can be set to check that the configuration with the correct UUID is loaded. When loading from database, is used to identify the correct database record.

  • collection (str) – name of the database collection from which configuration is read

  • database (str) – name of the database in which the collection is stored

Returns:

extractor

Return type:

SpotExtractor object

process(camera, telescope_pointing, start_time, duration, science_camera=None)

Perform the sky simulation.

Parameters:
  • camera (ctapointing.camera.PointingCamera) – pointing camera object

  • telescope_pointing (astropy.SkyCoord) – pointing position of the image

  • start_time (astropy.Time) – start time of the simulated observation

  • duration (astropy.Quantity) – duration of the exposure

  • science_camera (ctapointing.camera.ScienceCamera) – science camera (for body and LED simulations, stars on lid)

Returns:

exposure – exposure object including simulated image

Return type:

ctapointing.exposure.Exposure

__init__(config=None, parent=None, **kwargs)
Parameters:
  • config (traitlets.loader.Config) – Configuration specified by config file or cmdline arguments. Used to set traitlet values.

  • parent (Tool or Component) – If a Component is created by another Component or Tool, you need to pass the creating Component as parent, e.g. parent=self. This makes sure the config is correctly handed down to the child components. Do not pass config in this case.

  • kwargs – Traitlets to be overridden. TraitError is raised if kwargs contains a key that does not correspond to a traitlet.

ambient_pressure

ambient pressure

ambient_temperature

ambient temperature

apply_moonlight

apply moonlight simulation

apply_noise

apply noise in simulation

classmethod from_config(**kwargs)

Read an ExposureSimulator configuration from either configuration file or database. Either the path of a configuration file (‘input_url’) or a database collection (‘collection’) must be provided.

Parameters:
  • input_url (str or Path) – path of the configuration file.

  • name (str) – name of the ExposureSimulator (as in ExposureSimulator.name). When loading the configuration from file, can be set to check that the configuration with the correct name is loaded. When loading from database, is used to identify the correct database record.

  • uuid (str) – UUID of the camera (as in ExposureSimulator.uuid). When loading the configuration from file, can be set to check that the configuration with the correct UUID is loaded. When loading from database, is used to identify the correct database record.

  • collection (str) – name of the database collection from which configuration is read

  • database (str) – name of the database in which the collection is stored

Returns:

extractor

Return type:

SpotExtractor object

max_magnitude

maximum magnitude of stars that are simulated

min_magnitude

minimum magnitude of stars that are simulated

name

name of ExposureSimulator

num_time_steps

number of time steps used in simulation

num_unsharp_rays_leds

number of light rays simulated per LED

num_unsharp_rays_stars

number of light rays simulated per star

process(camera, telescope_pointing, start_time, duration, science_camera=None)

Perform the sky simulation.

Parameters:
  • camera (ctapointing.camera.PointingCamera) – pointing camera object

  • telescope_pointing (astropy.SkyCoord) – pointing position of the image

  • start_time (astropy.Time) – start time of the simulated observation

  • duration (astropy.Quantity) – duration of the exposure

  • science_camera (ctapointing.camera.ScienceCamera) – science camera (for body and LED simulations, stars on lid)

Returns:

exposure – exposure object including simulated image

Return type:

ctapointing.exposure.Exposure

unsharp_radius

radius defining un-sharpness of stars

unsharp_radius_lid

radius defining the un-sharpness of reflected stars on lid

uuid

UUID of ExposureSimulator