ecpi.process.imag.core.main_imag module

Section author: ECLAIRs GP team

IMAG implementation, no file access, only memory Imaging and Source detection

This component shall perform the following tasks:

  • Reconstruct sky images from the ECLAIRs

    uniformity-background-earth corrected detector images over the entire FOV of the ECLAIRs telescope. Each of them shall include intensity, variance, signal to noise, exposure and source model images.

  • Detect, locate and identify from a master catalog

    the point sources contributing to the sky image.

  • Clean the coding noise of each detected source

    from the reconstructed sky image in order to search for weaker objects.

  • The set of parameters derived in this process for

    the detected (or searched) sources shall be given in output.

Parameters shall include at least:

  • the identifier of the source,

  • the name of the possible identification,

  • the fluxes with associated errors and signal to noise in given energy bands,

  • the position in image and celestial coordinates with associated errors,

  • other TBD parameters.

  • Detection of a new, unknown source shall generate a clear alert message in output.

Summary

Functions:

build_source_model

simulation, deconvolution and fit of the source alone, and normalize its flux

imag

IMAG module

update_catalog_output

update the catalog of identified sources with the new found source

Reference

build_source_model(find_max_source, src_model, snr_ths, source_id)[source]

simulation, deconvolution and fit of the source alone, and normalize its flux

Parameters

  • find_max_source (SrcFind.MaxSourceFinder) – position of the source in the sky image

  • src_model (ImProcess.ImagingMiniPipeline) – last source model to be updated

  • snr_ths (float) – minimum snr for a source to be detected

  • source_id (string) – id of the source = proc_id + ‘_’ + str(source_indice)

Returns

simu and deconv of the model of the new source,

normalization factor of the source model :rtype: ImProcess.ImagingMiniPipeline, float

imag(df_data, dict_pars)[source]

IMAG module

Imaging and Source detection main process

error_code =

  • ‘OK’ if everything was fine

  • ‘ImagError’ if an error occur

Parameters

dict_pars (dict) – dictionnary with all necessary parameters to _ecpi_processing BUBE pipeline. Contains keys enery_ranges, bkg_correction_mode, events and pvtatt.

Returns

list found sources catalog, sky_images, new_source_flag by energy band

Return type

CatalogIdentifiedSources, SkyImages, bool

update_catalog_output(catalog_output, src_model, sky_images, find_max_source, normalisation_factor, source_id, debug=False)[source]

update the catalog of identified sources with the new found source

Parameters

  • catalog_output (CatalogIdentifiedSources) – catalog of identified sources

  • src_model (ImProcess.ImagingMiniPipeline) – simu and deconv of the model of the new source

  • sky_images (ImProcess.SkyImages) – last updated sky images

  • find_max_source (SrcFind.MaxSourceFinder) – position of the source in the sky image

  • normalisation_factor (float) – normalisation factor of the source model

  • source_id (string) – id of the source = proc_id + ‘_’ + str(source_indice)

  • debug (bool) – whether or not to display debug quantities

Returns

updated catalog of identified sources

Return type

CatalogIdentifiedSources