https://github.com/cta-observatory/pybkgmodel

Background Modelling of IACTs

https://github.com/cta-observatory/pybkgmodel

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.1%) to scientific vocabulary
Last synced: 9 months ago · JSON representation

Repository

Background Modelling of IACTs

Basic Info
  • Host: GitHub
  • Owner: cta-observatory
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: main
  • Size: 250 KB
Statistics
  • Stars: 5
  • Watchers: 23
  • Forks: 2
  • Open Issues: 18
  • Releases: 0
Created about 5 years ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.md

pybkgmodel

Description

Background model generation tool for Imaging Atmospheric Cherenkov Telescopes (IACTs). Constructs background from the available data excluding the region of interest from the process.

Supported background generation methods:

  • "wobble map" - assumes IACT observations were performed wobbling around the target position. For each telescope pointing, the background is generated from the IACT camera half, that does not include the source position;
  • "exclusion map" - excludes the specified sky region from consideration and generates the background model from the remaining data.

Supported background generation modes:

  • "run-wise": for each telescope "data run" (observation session unit) identifies other runs close to it in time and constructs the individual background model from them only;
  • "stacked": add the "run-wise" models together, resulting in an observation-averaged background model. The latter is in general less noisy than the individual "run-wise" models at the cost of loosing information on the potential background variation during the observations.

Installation

Clone and install with pip:

git clone https://github.com/cta-observatory/pybkgmodel.git pip install pybkgmodel

[!IMPORTANT] In case you are a developer you should install the package in editable mode enabling the test dependecies with
pip install -e 'pybkgmodel[tests]'.

Usage

The background model generation is controlled via a configuration file in the YAML format (an example may be found in the "examples" folder). It specifies the input data, output folder, background model generation method, maps binning and exclusion regions to apply.

Execute bkgmodel to run the code, specifying the corresponding configuration file, e.g.:

bkgmodel --config examples/config_example.yaml

Support

Please use issues to report problems or make suggestions.

Roadmap

Despite the initial focus on CTA/LST and MAGIC data, the project may be extended to any other IACTs (e.g. other CTA instruments).

Contributing

Contributions are welcome.

Authors and acknowledgment

Original developers are Marcel Strzys, Ievgen Vovk and Moritz Huetten.

Project status

Active development, so major changes are possible without a notice.

Owner

  • Name: Cherenkov Telescope Array Consortium
  • Login: cta-observatory
  • Kind: organization

open-source software for the CTA Consortium.

GitHub Events

Total
  • Issues event: 1
  • Delete event: 1
  • Issue comment event: 2
  • Push event: 1
  • Pull request review event: 8
  • Pull request review comment event: 8
  • Pull request event: 2
  • Create event: 2
Last Year
  • Issues event: 1
  • Delete event: 1
  • Issue comment event: 2
  • Push event: 1
  • Pull request review event: 8
  • Pull request review comment event: 8
  • Pull request event: 2
  • Create event: 2

Dependencies

.github/workflows/ci.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v1 composite
pyproject.toml pypi
  • PyYAML ==5.3.1
  • astropy ==5.0.2
  • matplotlib ==3.5.1
  • numpy ==1.21.5
  • pandas ==1.3.5
  • progressbar2 ==4.0.0
  • regions ==0.5
  • scipy ==1.8.0
  • uproot ==4.2.3
setup.py pypi