Camera

camera_efficiency

Main functionality for the camera_efficiency module is to provide an interface to the testeff program provided by sim_telarray. A TelescopeModel and few more physical parameters (zenith angle, etc) are required inputs.

Camera efficiency simulations and analysis.

class camera.camera_efficiency.CameraEfficiency(config_data, label, db_config)

Camera efficiency simulations and analysis.

Parameters:

db_config: dict

Configuration for the database.

label: str

Instance label, optional.

config_data: dict.

Dict containing the configurable parameters.

analyze(export=True, force=False)

Analyze camera efficiency output file and store the results in _results.

Parameters:

export: bool

If True, results will be exported to a file automatically. Alternatively, export_results function can be used.

force: bool

If True, existing results files will be removed and analysis will be done again.

calc_camera_efficiency()

Calculate the camera nominal efficiency including gaps (as defined in B-TEL-1170).

Returns:

cam_efficiency: float

Wavelength-averaged camera efficiency

calc_nsb_rate(wavelength_range=(<Quantity 300. nm>, <Quantity 650. nm>))

Calculate the NSB rate.

CTAO reference wavelength range is 300-650 nm.

Parameters:

wavelength_range: tuple

Wavelength range used for the NSB rate calculation (default: (300 nm, 650 nm)).

Returns:

nsb_rate_provided_spectrum: float

NSB pixel rate in p.e./ns for the provided NSB spectrum

nsb_rate_ref_conditions: float

NSB pixel rate in p.e./ns for reference conditions (https://jama.cta-observatory.org/perspective.req#/items/26694?projectId=11)

calc_reflectivity()

Calculate the Cherenkov spectrum weighted reflectivity in the range 300-550 nm.

Returns:

Float

Cherenkov spectrum weighted reflectivity (300-550 nm)

calc_tel_efficiency()

Calculate the telescope total efficiency including gaps (as defined in A-PERF-2020).

Returns:

tel_efficiency: float

Telescope efficiency

calc_tot_efficiency(tel_efficiency)

Calculate the telescope total efficiency including gaps (as defined in A-PERF-2020).

Parameters:

tel_efficiency: float

The telescope efficiency as calculated by calc_tel_efficiency()

Returns:

Float

Telescope total efficiency including gaps

export_model_files()

Export model and config files to the output directory.

export_results()

Export results to a ecsv file.

get_nsb_pixel_rate(reference_conditions=False)

Return the expected NSB pixel rate for each camera pixel.

This is an approximation, as testeff calculates the expected NSB pixel rate for the on-axis pixel only.

Returns:

list

Expected NSB pixel rate in p.e./ns for the provided NSB spectrum.

plot_efficiency(efficiency_type, save_fig=False)

Plot efficiency vs wavelength.

Parameters:

efficiency_type: str

The type of efficiency to plot (Cherenkov ‘C’ or NSB ‘N’)

save_fig: bool

If True, the figure will be saved to a file.

Returns:

fig

The figure instance of pyplot

results_summary()

Print a summary of the results.

Include a header for the zenith/azimuth settings and the NSB spectrum file which was used. The summary includes the various CTAO requirements and the final expected NSB pixel rate.

simulate()

Simulate camera efficiency using testeff.

Single photon-electron spectral analysis

single_photon_electron_spectrum

Single photon electron spectral analysis.

class camera.single_photon_electron_spectrum.SinglePhotonElectronSpectrum(args_dict)

Single photon electron spectral analysis.

Parameters:

args_dict: dict

Dictionary with input arguments.

afterpulse_fit_function(fix_k)

Afterpulse fit function: exponential decay with linear term in the exponent.

Starting values and bounds are set for the other parameters using values typical for LSTN-design. Allows to fix the K parameter.

Parameters:

fix_Kfloat

Fixed value for K parameter.

Returns:

function

Exponential decay function with linear term in the exponent.

derive_single_pe_spectrum()

Derive single photon electron spectrum.

fit_afterpulse_spectrum()

Fit afterpulse spectrum with a exponential decay function.

Assume input to be in ecsv format with columns ‘amplitude’, ‘frequency (afterpulsing)’, and ‘frequency stdev (afterpulsing)’.

Returns:

astro.Table

Table with fitted afterpulse spectrum data.

write_single_pe_spectrum()

Write single photon electron spectrum plus metadata to disk.

Includes writing in simtel and simtools (ecsv) formats.