xsnap 0.2.0__tar.gz

xsnap-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ferdinand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xsnap-0.2.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: xsnap
+Version: 0.2.0
+Summary: A Python-based pipeline module to easily handle data calibration from Chandra, Swift-XRT, XMM-Newton, and NuSTAR data. Additionally, spectral fitting and analysis are available with the help of XSPEC
+Author-email: Ferdinand <ferdinand.1238073@gmail.com>
+Maintainer-email: Ferdinand <ferdinand.1238073@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Ferdinand
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/fercananything/XSNAP/
+Project-URL: Repository, https://github.com/fercananything/XSNAP/
+Project-URL: Issues, https://github.com/fercananything/XSNAP/issues
+Project-URL: Changelog, https://github.com/fercananything/XSNAP/blob/main/CHANGELOG.md
+Keywords: astronomy,xray,spectroscopy,pipeline,supernova
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: astropy>=7.0.0
+Requires-Dist: corner>=2.2.2
+Requires-Dist: emcee>=3.1.6
+Requires-Dist: matplotlib>=3.10.3
+Requires-Dist: numpy<2.0.0
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: scipy>=1.15.1
+Dynamic: license-file
+
+<p align="center">
+  <picture>
+    <img src="https://raw.githubusercontent.com/fercananything/xsnap/main/docs/_static/logo/xsnap_logo_icon_crop.jpeg" alt="My Project logo" width="200px" />
+  </picture>
+</p>
+
+# XSNAP: X-ray Supernova Analysis Pipeline
+
+XSNAP (X-ray Supernova Analysis Pipeline) is a Python-based pipeline module that automates every step of X-ray supernova data reduction and analysis, from raw event processing and region selection to spectral fitting. XSNAP provides dedicated standard data calibration and spectral extraction scripts for Chandra X-ray Observatory (CXO), Swift-XRT, XMM-Newton, and NuSTAR data.
+
+XSNAP, with the help of PyXspec, is able to model and fit spectra using a wide range of astrophysical models (e.g., Thermal-Bremsstrahlung and Powerlaw). Additionally, XSNAP can generate photometric data through the fitted spectra. 
+
+A follow-up analysis using the Thermal-Bremsstrahlung model can be made, specifically for Type II Supernova. From luminosity fitting to estimating Circumstellar Medium (CSM) densities and mass-loss rates of the supernova progenitors, XSNAP streamines the workflow so you can spend less time on rewriting each analysis manually.
+
+More analysis functions can be made upon requests :)
+
+## Contents
+
+1. [Introduction](#xsnap-x-ray-supernova-analysis-pipeline)  
+2. [Installation](#installing-xsnap)  
+3. [Dependencies](#required-dependencies)  
+4. [Usage and Example](#how-to-use-the-module)  
+   - [CLI Scripts](#command-line-scripts)  
+   - [Python API](#built-in-module--python-api)  
+5. [Problems and Questions](#problems-and-questions) 
+
+## Installing XSNAP
+
+We strongly recommend that you make use of Python virtual environments, or (even better) Conda virtual environments when installing XSNAP. 
+
+Currently, XSNAP is in its development phase. It is available for download at the Testing Python Package Index (TestPyPI) in [here](https://test.pypi.org/project/xsnap/).
+```shell script
+pip install -i https://test.pypi.org/simple/ xsnap
+```
+
+Additionally, XSNAP should be able to be downloaded by cloning this Github repository and run:
+```shell script
+git clone https://github.com/fercananything/XSNAP/
+cd XNAP
+python -m pip install .
+```
+
+<!-- 
+XSNAP is available on the popular Python Package Index (PyPI), and can be installed like this:
+```shell script
+pip install xsnap
+```
+-->
+
+## Dependencies
+### Required Dependencies
+
+XSNAP analysis depends heavily on two non-Python softwares:
+* [HEASOFT](https://heasarc.gsfc.nasa.gov/docs/software/lheasoft/download.html) - Version 6.35. Other recent versions should be compatible even if I have yet to test it.
+* [HEASOFT's PyXspec](https://heasarc.gsfc.nasa.gov/docs/xanadu/xspec/python/html/buildinstall.html) - Version 2.1.4 (or XSPEC - Version 12.15.0). Other recent versions should be compatible even if I have yet to test it. Additionally, PyXspec should be automatically installed when you install HEASOFT.
+
+### Recommended Dependencies
+
+While it's not necessarily required, it is strongly recommended to download these non-Python softwares:
+
+* [Chandra Interactive Analysis of Observations (CIAO)](https://cxc.harvard.edu/ciao/download/index.html) - Version 4.17. CIAO is needed if you want to do the spectral extraction from CXO data. It is recommended to install CIAO using the `conda create` command, i.e. install on a different Python/Conda virtual environment. This is to seperate HEASOFT (and XSPEC) with CIAO and avoid clashes between modules. 
+* [XMM Science Analysis System (SAS)](https://www.cosmos.esa.int/web/xmm-newton/sas-download) - Version 22.1. However, other recent versions should still be compatible. SAS is needed if you want to do data calibration and spectral extraction for XMM-Newton. A few extra steps for SAS installation can be found [here](https://www.cosmos.esa.int/web/xmm-newton/sas-thread-startup#).
+* [HEASARC Calibration Database (CALDB)](https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/install.html) - Version 2009 Aug 04. The HEASARC CALDB is needed if you want to do data calibration and spectral extraction for Swift-XRT and NuSTAR.
+* [CALDB Files for Swift-XRT and NuSTAR](https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/caldb_supported_missions.html). In addition to the CALDB, the CALDB files are needed to be downloaded too. These files are needed if you want to do data calibration and spectral extraction for Swift-XRT and NuSTAR.
+
+_Keep in mind, without these softwares, you are only able to import the spectra fitting and analysis modules. These softwares help with the scripts dealing for data calibration and spectral extraction._
+
+### Optional Dependencies
+
+This software is completely optional and has minimal impact on the user experience.
+* [DS9](https://sites.google.com/cfa.harvard.edu/saoimageds9) - Version 4.1 and above. DS9 is needed to help user's interactivity in making region files.
+
+## How to use the module
+
+XSNAP is organized into two main parts: command-line scripts (where users can invoke on the shell or jupyter notebook) and a built-in module or Python API (where you can import functions and classes).
+
+There are six scripts available for users to run:
+| Script             | Description                                              |
+|--------------------|----------------------------------------------------------|
+| `extract-chandra`  | Calibrate & extract spectrum from Chandra observations. |
+| `extract-swift`    | Calibrate & extract spectrum from Swift-XRT (PC/WT mode available).     |
+| `swift-stack-pc`   | Bin & stack Swift-XRT PC-mode data (default 1-day bins). |
+| `extract-xmm`      | Calibrate & extract spectrum from XMM-Newton.           |
+| `extract-nustar`      | Calibrate & extract spectrum from NuSTAR.           |
+| `make-region`      | Generate ICRS source/background region files. (Physical region files will also be made if user has DS9)       |
+
+A short tutorial on how to use XSNAP is available in jupyter notebooks [here](https://github.com/fercananything/XSNAP/tree/main/notebook)
+
+## Problems and Questions
+If you encounter a bug, or would like to make a feature request, please use the GitHub
+[issues](https://github.com/fercananything/XSNAP/issues) page.
+
+In addition, if you have further questions, feel free to send me an email at ferdinand.1238073@gmail.com or ff10@illinois.edu

xsnap-0.2.0/README.md

@@ -0,0 +1,93 @@
+<p align="center">
+  <picture>
+    <img src="https://raw.githubusercontent.com/fercananything/xsnap/main/docs/_static/logo/xsnap_logo_icon_crop.jpeg" alt="My Project logo" width="200px" />
+  </picture>
+</p>
+
+# XSNAP: X-ray Supernova Analysis Pipeline
+
+XSNAP (X-ray Supernova Analysis Pipeline) is a Python-based pipeline module that automates every step of X-ray supernova data reduction and analysis, from raw event processing and region selection to spectral fitting. XSNAP provides dedicated standard data calibration and spectral extraction scripts for Chandra X-ray Observatory (CXO), Swift-XRT, XMM-Newton, and NuSTAR data.
+
+XSNAP, with the help of PyXspec, is able to model and fit spectra using a wide range of astrophysical models (e.g., Thermal-Bremsstrahlung and Powerlaw). Additionally, XSNAP can generate photometric data through the fitted spectra. 
+
+A follow-up analysis using the Thermal-Bremsstrahlung model can be made, specifically for Type II Supernova. From luminosity fitting to estimating Circumstellar Medium (CSM) densities and mass-loss rates of the supernova progenitors, XSNAP streamines the workflow so you can spend less time on rewriting each analysis manually.
+
+More analysis functions can be made upon requests :)
+
+## Contents
+
+1. [Introduction](#xsnap-x-ray-supernova-analysis-pipeline)  
+2. [Installation](#installing-xsnap)  
+3. [Dependencies](#required-dependencies)  
+4. [Usage and Example](#how-to-use-the-module)  
+   - [CLI Scripts](#command-line-scripts)  
+   - [Python API](#built-in-module--python-api)  
+5. [Problems and Questions](#problems-and-questions) 
+
+## Installing XSNAP
+
+We strongly recommend that you make use of Python virtual environments, or (even better) Conda virtual environments when installing XSNAP. 
+
+Currently, XSNAP is in its development phase. It is available for download at the Testing Python Package Index (TestPyPI) in [here](https://test.pypi.org/project/xsnap/).
+```shell script
+pip install -i https://test.pypi.org/simple/ xsnap
+```
+
+Additionally, XSNAP should be able to be downloaded by cloning this Github repository and run:
+```shell script
+git clone https://github.com/fercananything/XSNAP/
+cd XNAP
+python -m pip install .
+```
+
+<!-- 
+XSNAP is available on the popular Python Package Index (PyPI), and can be installed like this:
+```shell script
+pip install xsnap
+```
+-->
+
+## Dependencies
+### Required Dependencies
+
+XSNAP analysis depends heavily on two non-Python softwares:
+* [HEASOFT](https://heasarc.gsfc.nasa.gov/docs/software/lheasoft/download.html) - Version 6.35. Other recent versions should be compatible even if I have yet to test it.
+* [HEASOFT's PyXspec](https://heasarc.gsfc.nasa.gov/docs/xanadu/xspec/python/html/buildinstall.html) - Version 2.1.4 (or XSPEC - Version 12.15.0). Other recent versions should be compatible even if I have yet to test it. Additionally, PyXspec should be automatically installed when you install HEASOFT.
+
+### Recommended Dependencies
+
+While it's not necessarily required, it is strongly recommended to download these non-Python softwares:
+
+* [Chandra Interactive Analysis of Observations (CIAO)](https://cxc.harvard.edu/ciao/download/index.html) - Version 4.17. CIAO is needed if you want to do the spectral extraction from CXO data. It is recommended to install CIAO using the `conda create` command, i.e. install on a different Python/Conda virtual environment. This is to seperate HEASOFT (and XSPEC) with CIAO and avoid clashes between modules. 
+* [XMM Science Analysis System (SAS)](https://www.cosmos.esa.int/web/xmm-newton/sas-download) - Version 22.1. However, other recent versions should still be compatible. SAS is needed if you want to do data calibration and spectral extraction for XMM-Newton. A few extra steps for SAS installation can be found [here](https://www.cosmos.esa.int/web/xmm-newton/sas-thread-startup#).
+* [HEASARC Calibration Database (CALDB)](https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/install.html) - Version 2009 Aug 04. The HEASARC CALDB is needed if you want to do data calibration and spectral extraction for Swift-XRT and NuSTAR.
+* [CALDB Files for Swift-XRT and NuSTAR](https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/caldb_supported_missions.html). In addition to the CALDB, the CALDB files are needed to be downloaded too. These files are needed if you want to do data calibration and spectral extraction for Swift-XRT and NuSTAR.
+
+_Keep in mind, without these softwares, you are only able to import the spectra fitting and analysis modules. These softwares help with the scripts dealing for data calibration and spectral extraction._
+
+### Optional Dependencies
+
+This software is completely optional and has minimal impact on the user experience.
+* [DS9](https://sites.google.com/cfa.harvard.edu/saoimageds9) - Version 4.1 and above. DS9 is needed to help user's interactivity in making region files.
+
+## How to use the module
+
+XSNAP is organized into two main parts: command-line scripts (where users can invoke on the shell or jupyter notebook) and a built-in module or Python API (where you can import functions and classes).
+
+There are six scripts available for users to run:
+| Script             | Description                                              |
+|--------------------|----------------------------------------------------------|
+| `extract-chandra`  | Calibrate & extract spectrum from Chandra observations. |
+| `extract-swift`    | Calibrate & extract spectrum from Swift-XRT (PC/WT mode available).     |
+| `swift-stack-pc`   | Bin & stack Swift-XRT PC-mode data (default 1-day bins). |
+| `extract-xmm`      | Calibrate & extract spectrum from XMM-Newton.           |
+| `extract-nustar`      | Calibrate & extract spectrum from NuSTAR.           |
+| `make-region`      | Generate ICRS source/background region files. (Physical region files will also be made if user has DS9)       |
+
+A short tutorial on how to use XSNAP is available in jupyter notebooks [here](https://github.com/fercananything/XSNAP/tree/main/notebook)
+
+## Problems and Questions
+If you encounter a bug, or would like to make a feature request, please use the GitHub
+[issues](https://github.com/fercananything/XSNAP/issues) page.
+
+In addition, if you have further questions, feel free to send me an email at ferdinand.1238073@gmail.com or ff10@illinois.edu

xsnap-0.2.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xsnap"   
+version = "0.2.0"
+description = "A Python-based pipeline module to easily handle data calibration from Chandra, Swift-XRT, XMM-Newton, and NuSTAR data. Additionally, spectral fitting and analysis are available with the help of XSPEC"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {file = "LICENSE"}
+authors = [{name = "Ferdinand", email = "ferdinand.1238073@gmail.com"}]
+maintainers = [{name = "Ferdinand", email = "ferdinand.1238073@gmail.com"}]
+keywords = ["astronomy", "xray", "spectroscopy", "pipeline", "supernova"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Astronomy",
+  "Topic :: Scientific/Engineering :: Physics"
+]
+
+# ---- runtime dependencies ----
+dependencies = [
+    "astropy>=7.0.0",
+    "corner>=2.2.2",
+    "emcee>=3.1.6",
+    "matplotlib>=3.10.3",
+    "numpy < 2.0.0",
+    "pandas>=2.2.3",
+    "scipy>=1.15.1",                 
+]
+
+[project.urls]
+Homepage = "https://github.com/fercananything/XSNAP/"
+Repository = "https://github.com/fercananything/XSNAP/"
+Issues = "https://github.com/fercananything/XSNAP/issues"
+Changelog = "https://github.com/fercananything/XSNAP/blob/main/CHANGELOG.md"
+
+# ---- CLI entry-points ----
+[project.scripts]
+extract-chandra = "xsnap.chandra.extract:cli"
+swift-stack-pc     = "xsnap.swiftxrt.stack_pc:cli"
+extract-swift = "xsnap.swiftxrt.extract:cli"
+extract-xmm     = "xsnap.xmm.extract:cli"
+extract-nustar     = "xsnap.nustar.extract:cli"
+make-region     = "xsnap.make_region:cli"
+
+# ---- tell setuptools where to find the code ----
+[tool.setuptools.packages.find]
+where = ["src"]

xsnap-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xsnap-0.2.0/src/xsnap/__init__.py

@@ -0,0 +1,9 @@
+"""
+xray_pipeline
+=============
+
+Modular pipeline for extracting, stacking and fitting X-ray spectra
+from Chandra, Swift-XRT and XMM-Newton.
+"""
+__all__ = ["chandra", "swiftxrt", "xmm", "nustar"]
+__version__ = "0.2.0"