CTLearn 0.9.0__tar.gz

ctlearn-0.9.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,26 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1.
+2.
+3. 
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Supporting information**
+If applicable, add screenshots, logs, or a traceback to help illustrate the bug.
+
+**Additional context**
+Add any other context about the problem here.

ctlearn-0.9.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an new feature in CTLearn
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Please describe the use case that requires this feature.**
+A clear and concise description of why this feature is needed. [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

ctlearn-0.9.0/.github/conda/bld.bat

@@ -0,0 +1,2 @@
+#!/bin/bash
+$PYTHON setup.py install --single-version-externally-managed --record=record.txt

ctlearn-0.9.0/.github/conda/build.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+$PYTHON setup.py install --single-version-externally-managed --record=record.txt

ctlearn-0.9.0/.github/conda/conda_build_config.yaml

@@ -0,0 +1,4 @@
+python:
+  - 3.12
+  - 3.11
+  - 3.10

ctlearn-0.9.0/.github/conda/meta.yaml

@@ -0,0 +1,56 @@
+{% set data = load_setup_py_data() %}
+
+package:
+  name: ctlearn
+  version: {{ data.get('version') }}
+source:
+  path: ../..
+
+build:
+  #noarch: generic
+  number: 0
+  
+requirements:
+  build:
+    - python #==3.12
+    - numpy >=1.20
+    - setuptools
+    - astropy
+    - scipy
+    - jupyter
+    - ctapipe ==0.20.0
+    - pytables >=3.8
+    - pandas
+  host:
+    - python #==3.12
+    - numpy >=1.20
+    - astropy
+    - setuptools
+    - scipy
+    - jupyter
+    - ctapipe ==0.20.0
+    - pytables >=3.8
+    - pandas
+  run:
+    - python #==3.12
+    - numpy >=1.20
+    - jupyter
+    - setuptools
+    - astropy
+    - scipy
+    - ctapipe ==0.20.0
+    - pytables >=3.8
+    - pandas
+
+  test:
+    imports:
+      - ctlearn
+about:
+  home: https://github.com/ctlearn-project/ctlearn/
+  license: BSD3-Clause
+  license_file: LICENSE
+  summary: Deep Learning for IACT Event Reconstruction.
+extra:
+  recipe-maintainers:
+    - TjarkMiener
+    - nietootein

ctlearn-0.9.0/.github/versionBackup.txt

@@ -0,0 +1 @@
+0.9.0

ctlearn-0.9.0/.github/workflows/check_codemeta.yml

@@ -0,0 +1,16 @@
+name: validate codemeta
+
+on:
+  push:
+    paths:
+      - codemeta.json
+  
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    container:
+      image: gitlab-registry.in2p3.fr/escape2020/wp3/eossr:v1.0
+    steps:
+      - uses: actions/checkout@v2
+      - name: validate codemeta
+        run: eossr-metadata-validator codemeta.json

ctlearn-0.9.0/.github/workflows/python-package-conda.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on: [push]
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        os: [ubuntu-22.04]
+        pyv: [3.9, '3.10', 3.11, 3.12]
+      max-parallel: 5
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.pyv }}
+      run: |
+        conda install -y python=${{ matrix.pyv }}
+    - name: Add conda to system path
+      run: |
+        # $CONDA is an environment variable pointing to the root of the miniconda directory
+        echo $CONDA/bin >> $GITHUB_PATH
+    - name: Install dependencies
+      run: |
+        conda env update --file environment.yml --name base
+    - name: Lint with flake8
+      run: |
+        conda install flake8
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Install with pip
+      run: |
+        pip install -e .
+    - name: Test with pytest
+      run: |
+        conda install pytest
+        pytest
+
+

ctlearn-0.9.0/.github/workflows/release.yml

@@ -0,0 +1,73 @@
+name: Release CD
+
+on: [push]
+
+jobs:
+  pypi-publish:
+    name: Publish release to PyPI
+    environment:
+      name: pypi 
+      url: https://pypi.org/project/ctlearn/
+    permissions:
+      id-token: write
+      contents: write
+      deployments: write
+      statuses: write
+      actions: write
+      checks: read
+    strategy:
+      matrix:
+        os: [ubuntu-22.04]
+        pyv: ['3.10']
+      max-parallel: 5
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.pyv }}
+      run: |
+        conda install -y python=${{ matrix.pyv }}
+        
+    - name: Add conda to system path
+      run: |
+        #$CONDA is an environment variable pointing to the root of the miniconda directory
+        echo $CONDA/bin >> $GITHUB_PATH 
+        
+    - name: Install dependencies
+      run: |
+        conda env update --file environment.yml --name base 
+        
+    - name: Get version
+      run: |
+        output=$(python ctlearn/versionScript.py)
+        echo "version=$output" >> $GITHUB_OUTPUT
+      id: step1  
+      
+    - name: Write
+      uses: 1arp/create-a-file-action@0.4.5
+      with:
+        path: '.'
+        isAbsolutePath: true
+        file: '.github/versionBackup.txt'
+        content: |
+          ${{ steps.step1.outputs.version }}
+          
+    - name: Push changes    
+      run: |
+        git config --global user.email "rcervino@ucm.es"
+        git config --global user.name "rcervinoucm"
+        git status
+        git add .
+        git commit -m "version update" --allow-empty
+        git push
+        
+    - name: Build package
+      run: |
+        python setup.py sdist bdist_wheel  # Could also be python -m build
+    - name: Publish package distributions to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+        
+    - name: publish-to-conda
+      uses: fcakyon/conda-publish-action@v1.3
+      with:
+        subdir: '.github/conda'
+        anacondatoken: ${{ secrets.ANACONDA_TOKEN }}

ctlearn-0.9.0/.gitignore

@@ -0,0 +1,22 @@
+*.swp
+*.swo
+*.gemini
+*.index
+*.meta
+*.out
+*.ckpt
+*.tar.gz
+*.pbtxt
+*.png
+*.csv
+*~
+
+# Compiled Python files
+__pycache__/
+*.py[cod]
+.DS_Store
+ctlearn/.DS_Store
+ctlearn.egg-info/
+
+# Sphinx documentation
+docs/build/

ctlearn-0.9.0/.readthedocs.yaml

@@ -0,0 +1,8 @@
+
+version: 2
+
+python:
+  install:
+    - requirements: docs/requirements.txt
+    - method: pip
+      path: .

ctlearn-0.9.0/.zenodo.json

@@ -0,0 +1,66 @@
+{
+    "access_right": "open",
+    "communities": [
+        {
+            "identifier": "escape2020"
+        }
+    ],
+    "contributors": [
+        {
+            "affiliation": "Facultad de Ingenier\u00eda Inform\u00e1tica, Universidad Complutense de Madrid, Madrid, Spain",
+            "name": "Sevilla, Jaime",
+            "type": "Researcher"
+        }
+    ],
+    "creators": [
+        {
+            "name": "Brill, Ari",
+            "orcid": " 0000-0002-6208-5244"
+        },
+        {
+            "affiliation": "University of California Los Angeles, Division of Astronomy and Astrophysics, Los Angeles, CA, USA",
+            "name": "Kim, Bryan"
+        },
+        {
+            "affiliation": "Instituto de F\u00edsica de Part\u00edculas y del Cosmos, Departamento de EMFTEL, Universidad Complutense de Madrid, Madrid, Spain ",
+            "name": "Nieto, Daniel",
+            "orcid": "0000-0003-3343-0755"
+        },
+        {
+            "affiliation": "Instituto de F\u00edsica de Part\u00edculas y del Cosmos, Departamento de EMFTEL, Universidad Complutense de Madrid, Madrid, Spain ",
+            "name": "Miener, Tjark",
+            "orcid": "0000-0003-1821-7964"
+        },
+        {
+            "affiliation": "Barnard College, Columbia University, New York, NY, USA",
+            "name": "Feng, Qi",
+            "orcid": " 0000-0001-6674-4238"
+        }
+    ],
+    "description": "CTLearn is a high-level Python package providing a backend for training deep learning models for the reconstruction of imaging atmospheric Cherenkov telescope events using TensorFlow.",
+    "grants": [
+        {
+            "id": "10.13039/501100000780::824064"
+        }
+    ],
+    "keywords": [
+        "Imaging atmospheric Cherenkov telescopes",
+        "Deep learning",
+        "High energy physics",
+        "Event reconstruction"
+    ],
+    "language": "eng",
+    "license": "BSD-3-Clause",
+    "publication_date": "2023-05-08",
+    "related_identifiers": [
+        {
+            "identifier": "https://github.com/ctlearn-project/ctlearn",
+            "relation": "isDerivedFrom",
+            "resource_type": "software",
+            "scheme": "url"
+        }
+    ],
+    "title": "CTLearn: Deep learning for imaging atmospheric Cherenkov telescopes event reconstruction",
+    "upload_type": "software",
+    "version": "0.8.0"
+}

ctlearn-0.9.0/CONTRIBUTING.rst

@@ -0,0 +1,29 @@
+
+Contributing to CTLearn
+=======================
+
+CTLearn is open source and welcomes contributions from the community!
+
+Contributing guidelines
+-----------------------
+
+In CTLearn we follow the "fork-and-pull" Git workflow:
+
+
+* Fork the repository on GitHub
+* Clone the project to your own machine
+* Commit your changes to your own branch
+* Push your work back up to your fork on GitHub
+* Submit a Pull Request so the core developer team can review your changes
+
+Issues
+------
+
+Feel free to submit issues and enhancement requests through our `issues page on GitHub <https://github.com/ctlearn-project/ctlearn/issues>`_.
+
+Copyright and License
+---------------------
+
+CTLearn is licensed under the `BSD 3-Clause License <https://opensource.org/licenses/BSD-3-Clause>`_.
+
+CTLearn does require that you make your contributions available under the BSD 3-Clause License in order for it be included in the main repository.

ctlearn-0.9.0/CTLearn.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.1
+Name: CTLearn
+Version: 0.9.0
+Summary: CTLearn is a package under active development to run deep learning models to analyze data from all major current and future arrays of imaging atmospheric Cherenkov telescopes (IACTs).
+Home-page: https://github.com/ctlearn-project/ctlearn
+Author: Ari Brill, Bryan Kim, Tjark Miener, Daniel Nieto
+Author-email: d.nieto@ucm.es
+License: BSD-3-Clause
+Project-URL: repository, https://github.com/ctlearn-project/ctlearn
+Project-URL: documentation, https://ctlearn.readthedocs.io/en/latest/
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dl1_data_handler>=0.12.0
+Requires-Dist: astropy
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: pip
+Requires-Dist: pyyaml
+Requires-Dist: scikit-learn
+Requires-Dist: ctaplot
+Requires-Dist: numba<0.57,>=0.56.2
+Requires-Dist: tensorflow<2.16,>=2.15
+Requires-Dist: pydot
+Requires-Dist: pyirf

ctlearn-0.9.0/CTLearn.egg-info/SOURCES.txt

@@ -0,0 +1,81 @@
+.gitignore
+.readthedocs.yaml
+.zenodo.json
+CONTRIBUTING.rst
+LICENSE
+MANIFEST.in
+README.rst
+codemeta.json
+environment-cluster.yml
+environment.yml
+pyproject.toml
+setup.py
+.github/versionBackup.txt
+.github/ISSUE_TEMPLATE/bug_report.md
+.github/ISSUE_TEMPLATE/feature_request.md
+.github/conda/bld.bat
+.github/conda/build.sh
+.github/conda/conda_build_config.yaml
+.github/conda/meta.yaml
+.github/workflows/check_codemeta.yml
+.github/workflows/python-package-conda.yml
+.github/workflows/release.yml
+CTLearn.egg-info/PKG-INFO
+CTLearn.egg-info/SOURCES.txt
+CTLearn.egg-info/dependency_links.txt
+CTLearn.egg-info/entry_points.txt
+CTLearn.egg-info/requires.txt
+CTLearn.egg-info/top_level.txt
+CTLearn.egg-info/zip-safe
+config/example_config.yml
+ctlearn/__init__.py
+ctlearn/build_irf.py
+ctlearn/data_loader.py
+ctlearn/output_handler.py
+ctlearn/run_model.py
+ctlearn/utils.py
+ctlearn/version.py
+ctlearn/versionScript.py
+ctlearn/default_config_files/CNNRNN.yml
+ctlearn/default_config_files/SingleCNN.yml
+ctlearn/default_config_files/TRN.yml
+ctlearn/default_config_files/calwaveSingleCNN.yml
+ctlearn/default_config_files/calwaveTRN.yml
+ctlearn/default_config_files/rawwaveSingleCNN.yml
+ctlearn/default_config_files/rawwaveTRN.yml
+ctlearn/default_config_files/stackedTRN.yml
+ctlearn/default_config_files/triggerSingleCNN.yml
+ctlearn/default_config_files/triggerTRN.yml
+ctlearn/default_models/attention.py
+ctlearn/default_models/basic.py
+ctlearn/default_models/cnn_rnn.py
+ctlearn/default_models/head.py
+ctlearn/default_models/resnet.py
+ctlearn/default_models/single_cnn.py
+ctlearn/default_models/variable_input_model.py
+docs/Makefile
+docs/requirements.txt
+docs/source/conf.py
+docs/source/ctlearn.rst
+docs/source/index.rst
+docs/source/installation.rst
+docs/source/modules.rst
+docs/source/suplementary.rst
+docs/source/usage.rst
+images/CTLearnTextCTinBox_WhiteBkgd.png
+images/TRN-single-tel.drawio
+images/TRN-single-tel.svg
+images/cnn_rnn_accuracy_legend.png
+images/cnn_rnn_auc_legend.png
+images/ctlearn_uml.drawio
+images/ctlearn_uml.drawio.pdf
+images/single_tel_accuracy_legend.png
+images/single_tel_auc_legend.png
+notebooks/lstmono_ctlearn.ipynb
+scripts/auto_configuration.py
+scripts/plot_classifier_values.py
+scripts/plot_roc_curves.py
+scripts/run_ctlearn_on_Wilkes3.sh
+scripts/run_multiple_configurations.py
+scripts/summarize_results.py
+tests/test_placeholder.py

ctlearn-0.9.0/CTLearn.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ctlearn-0.9.0/CTLearn.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+build_irf = ctlearn.build_irf:main
+ctlearn = ctlearn.run_model:main

ctlearn-0.9.0/CTLearn.egg-info/requires.txt

@@ -0,0 +1,13 @@
+dl1_data_handler>=0.12.0
+astropy
+matplotlib
+numpy
+pandas
+pip
+pyyaml
+scikit-learn
+ctaplot
+numba<0.57,>=0.56.2
+tensorflow<2.16,>=2.15
+pydot
+pyirf

ctlearn-0.9.0/CTLearn.egg-info/top_level.txt

@@ -0,0 +1 @@
+ctlearn

ctlearn-0.9.0/CTLearn.egg-info/zip-safe

@@ -0,0 +1 @@
+

ctlearn-0.9.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2018, CTLearn developers
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

ctlearn-0.9.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include ctlearn/default_models/*
+include ctlearn/default_config_files/*

ctlearn-0.9.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.1
+Name: CTLearn
+Version: 0.9.0
+Summary: CTLearn is a package under active development to run deep learning models to analyze data from all major current and future arrays of imaging atmospheric Cherenkov telescopes (IACTs).
+Home-page: https://github.com/ctlearn-project/ctlearn
+Author: Ari Brill, Bryan Kim, Tjark Miener, Daniel Nieto
+Author-email: d.nieto@ucm.es
+License: BSD-3-Clause
+Project-URL: repository, https://github.com/ctlearn-project/ctlearn
+Project-URL: documentation, https://ctlearn.readthedocs.io/en/latest/
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dl1_data_handler>=0.12.0
+Requires-Dist: astropy
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: pip
+Requires-Dist: pyyaml
+Requires-Dist: scikit-learn
+Requires-Dist: ctaplot
+Requires-Dist: numba<0.57,>=0.56.2
+Requires-Dist: tensorflow<2.16,>=2.15
+Requires-Dist: pydot
+Requires-Dist: pyirf