Package: lstchain
cta-lstchainRepository for the high level analysis of the LST.
The analysis is heavily based onctapipe, adding custom code for mono reconstruction.Source code:https://github.com/cta-observatory/cta-lstchainDocumentation:https://cta-observatory.github.io/cta-lstchain/Note that notebooks are currently not tested and not guaranteed to be up-to-date.In doubt, refer to tested code and scripts: basic functions of lstchain (reduction steps R0-->DL1 and DL1-->DL2)
are unit tested and should be working as long as the build status is passing.InstallYou will need to installmicromamba/mamba(recommended),minicondaoranacondafirst.As userYou can create an environment and installlstchainfrom conda-forge as:mamba create -c conda-forge -n lstchain-v0.10.3 python=3.11 lstchain=0.10.3Alternatively, you can also installlstchainfrom PyPi withpip:LSTCHAIN_VER=0.10.3  (or the version you want to install - usually the latest release)
wget https://raw.githubusercontent.com/cta-observatory/cta-lstchain/v$LSTCHAIN_VER/environment.yml
conda env create -n lst -f environment.yml
conda activate lst
pip install lstchain==$LSTCHAIN_VER
rm environment.ymlAs developerCreate and activate the conda environment:git clone https://github.com/cta-observatory/cta-lstchain.git
cd cta-lstchain
conda env create -f environment.yml
conda activate lst-devNote: To prevent packages you installed withpip install --userfrom taking precedence over the conda environment, run:conda env config vars set PYTHONNOUSERSITE=1 -n <environment_name>To update the environment (e.g. when dependencies got updated), use:conda env update -n lst-dev -f environment.ymlInstall lstchain in developer mode:pip install -e .To run some of the tests, some non-public test data files are needed.
These tests will not be run locally if the test data is not available,
but are always run in the CI.To download the test files locally, run./download_test_data.sh.
It will ask for username and password and requireswgetto be installed.
Ask one of the project maintainers for the credentials. If
you are a member of the LST collaboration you can also obtain them here:https://ctaoobservatory.sharepoint.com/:i:/r/sites/ctan-onsite-it/Shared%20Documents/General/information_2.jpg?csf=1&web=1&e=suUkV6To run the tests that need those private data file, add-m private_datato the pytest call, e.g.:pytest -m private_data -v lstchainTo run all tests, runpytest -m 'private_data or not private_data' -v lstchainContributingAll contribution are welcomed.Guidelines are the same asctapipe's ones. Seeherefor the general guidelines on how to make a pull request to contribute to the repository. Since the addition of the private data, the CI tests for Pull Requests from forks are not working, therefore we would like to ask to push your modified branches directly to the main cta-lstchain repo. If you do not have writing permissions in the repo, please contact one of the main developers.Report issue / Ask a questionUseGitHub Issues.CiteIf you use lstchain in a publication, please cite the exact version you used from ZenodoCite as, seehttps://doi.org/10.5281/zenodo.6344673Please also cite the following proceedings by adding the bibtex entry:@inproceedings{lst_performance_icrc2021,
  author = {López-Coto, R. and Moralejo, A. and Artero, M. and Baquero, A. and Bernardos, M. and Contreras, J. L. and Di Pierro, F. and García, E. and Kerszberg, D. and López-Moya, M. and MasAguilar, A. and Morcuende, D. and Noethe, M. and Nozaki, S. and Ohtani, Y. and Priyadarshi, C. and Suda, Y. and Vuillaume, T. and others},
  usera = "{for the CTA LST Project}",
  title = "{Physics Performance of the Large Size Telescope prototype of the Cherenkov Telescope Array}",
  doi = "10.22323/1.395.0806",
  booktitle = "Proceedings, 37th International Cosmic Ray Conference",
  location = "Berlin, Germany",
  year = 2021,
  volume = "395",
  pages = "806"
}and the macro to your main.texfile to correctly add the "CTA LST Project":% we use the user a field as "dedication", i.e. for the CTA-LST Consortium
\renewbibmacro*{author}{%
  \iffieldundef{usera}{\printnames{author}}{\printnames{author} \printfield{usera}}%
}%