toa-sp 0.1.0__tar.gz

toa_sp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Songbo Zhang, Xuan Yang
+
+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.

toa_sp-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: toa_sp
+Version: 0.1.0
+Summary: Multi-strategy single-pulse TOA extraction from PSRFITS search-mode data
+Author-email: Songbo Zhang <sbzhang@pmo.ac.cn>, Xuan Yang <yangxuan@pmo.ac.cn>
+License: MIT
+Project-URL: Homepage, https://github.com/songqiii/toa_sp
+Project-URL: Repository, https://github.com/songqiii/toa_sp
+Project-URL: Issues, https://github.com/songqiii/toa_sp/issues
+Keywords: pulsar,timing,TOA,single-pulse,radio-astronomy,PSRFITS,FRB,RRAT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.21
+Requires-Dist: scipy>=1.7
+Requires-Dist: astropy>=5.0
+Requires-Dist: matplotlib>=3.5
+Provides-Extra: mcmc
+Requires-Dist: emcee>=3.0; extra == "mcmc"
+Provides-Extra: corner
+Requires-Dist: corner>=2.0; extra == "corner"
+Provides-Extra: all
+Requires-Dist: emcee>=3.0; extra == "all"
+Requires-Dist: corner>=2.0; extra == "all"
+Dynamic: license-file
+
+# toa_sp — Multi-Strategy Single-Pulse TOA Extraction
+
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.XXXXXXX-blue)](https://doi.org/10.5281/zenodo.XXXXXXX)
+
+**toa_sp** extracts times of arrival (TOAs) directly from PSRFITS search-mode data, bypassing the folding step required by conventional pulsar timing pipelines. It implements nine complementary TOA estimation strategies — parametric (Gaussian, EMG, Voigt) and non-parametric (leading edge, centre of mass, peak, shapelet) — together with MCMC uncertainty estimation, automatic time-resolution optimisation, and sub-band cross-validation.
+
+Designed for highly variable radio sources (RRATs, FRBs, mode-changing pulsars) where the integrated profile assumption breaks down.
+
+## Installation
+
+```bash
+pip install toa_sp
+```
+
+For MCMC support (optional):
+
+```bash
+pip install toa_sp[all]
+```
+
+## Quick Start
+
+```bash
+toa_sp -f FRB20220529_tracking-M01_0158.fits \
+    -dm 255.0 -s 1.1 -w 0.06 -bs 8 -bf 16 \
+    --auto_res --compare --tim --tim_strategy best \
+    -o timing_result
+```
+
+Or run as a script:
+
+```bash
+python toa_sp.py -f data.fits -dm 175.25 -s 2.5 -w 0.05 -bs 4 -bf 16
+```
+
+## TOA Strategies
+
+| Strategy | Type | Description |
+|---|---|---|
+| `single` | Parametric | Single-component fit; TOA = μ₁ |
+| `highest` | Parametric | Brightest fitted component |
+| `error_weighted` | Parametric | Inverse-variance weighted average |
+| `first_peak` | Parametric | Earliest significant (S/N > 5) component |
+| `weighted` | Parametric | Amplitude-weighted average *(deprecated)* |
+| `leading_edge` | Non-parametric | Half-max crossing + rise-time correction |
+| `center_of_mass` | Non-parametric | Flux-weighted centroid (S > 3σ_off) |
+| `peak` | Non-parametric | Profile maximum, quadratic sub-bin interpolation |
+| `shapelet` | Non-parametric | Hermite–Gaussian decomposition, AICc order selection |
+
+## Profile Models
+
+- **Gaussian** (default) — symmetric, N-component
+- **EMG** — exponentially modified Gaussian for scattering tails
+- **Voigt** — combined Gaussian + Lorentzian broadening
+- **Shapelet** — flexible basis expansion, automatically regularised
+
+## Key Features
+
+- **Auto resolution optimisation** (`--auto_res`) — maximises peak S/N via dyadic rebinning
+- **Sub-band cross-validation** (`--sub_band_fit`) — tests TOA consistency across frequency
+- **AICc model selection** (`--auto_n`) — data-driven choice of component number
+- **MCMC uncertainty** (`--mcmc`) — robust posterior sampling via `emcee`
+- **TEMPO2 output** (`--tim`) — writes `.tim` files for downstream timing analysis
+- **Convergence diagnostic** — Δ_conv metric identifies unstable decompositions
+
+## Requirements
+
+- Python ≥ 3.9
+- numpy, scipy, astropy, matplotlib
+- Optional: emcee, corner
+
+## Citation
+
+If you use toa_sp in your research, please cite:
+
+> Zhang S., Yang X. (2025). TOA_SP: A Multi-Strategy Framework for Single-Pulse Timing. *ApJ*, submitted.
+
+```bibtex
+@article{zhang2025toa_sp,
+  title={TOA\_SP: A Multi-Strategy Framework for Single-Pulse Timing},
+  author={Zhang, Songbo and Yang, Xuan},
+  journal={ApJ},
+  year={2025},
+  note={submitted}
+}
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Repository Structure
+
+```
+toa_sp/
+├── toa_sp.py          # Main pipeline
+├── pyproject.toml      # Package metadata
+├── tools/
+│   ├── plot_pipeline.py       # Pipeline schematic
+│   └── plot_rrat_residuals.py # Residual plot generation
+└── README.md
+```

toa_sp-0.1.0/README.md

@@ -0,0 +1,104 @@
+# toa_sp — Multi-Strategy Single-Pulse TOA Extraction
+
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.XXXXXXX-blue)](https://doi.org/10.5281/zenodo.XXXXXXX)
+
+**toa_sp** extracts times of arrival (TOAs) directly from PSRFITS search-mode data, bypassing the folding step required by conventional pulsar timing pipelines. It implements nine complementary TOA estimation strategies — parametric (Gaussian, EMG, Voigt) and non-parametric (leading edge, centre of mass, peak, shapelet) — together with MCMC uncertainty estimation, automatic time-resolution optimisation, and sub-band cross-validation.
+
+Designed for highly variable radio sources (RRATs, FRBs, mode-changing pulsars) where the integrated profile assumption breaks down.
+
+## Installation
+
+```bash
+pip install toa_sp
+```
+
+For MCMC support (optional):
+
+```bash
+pip install toa_sp[all]
+```
+
+## Quick Start
+
+```bash
+toa_sp -f FRB20220529_tracking-M01_0158.fits \
+    -dm 255.0 -s 1.1 -w 0.06 -bs 8 -bf 16 \
+    --auto_res --compare --tim --tim_strategy best \
+    -o timing_result
+```
+
+Or run as a script:
+
+```bash
+python toa_sp.py -f data.fits -dm 175.25 -s 2.5 -w 0.05 -bs 4 -bf 16
+```
+
+## TOA Strategies
+
+| Strategy | Type | Description |
+|---|---|---|
+| `single` | Parametric | Single-component fit; TOA = μ₁ |
+| `highest` | Parametric | Brightest fitted component |
+| `error_weighted` | Parametric | Inverse-variance weighted average |
+| `first_peak` | Parametric | Earliest significant (S/N > 5) component |
+| `weighted` | Parametric | Amplitude-weighted average *(deprecated)* |
+| `leading_edge` | Non-parametric | Half-max crossing + rise-time correction |
+| `center_of_mass` | Non-parametric | Flux-weighted centroid (S > 3σ_off) |
+| `peak` | Non-parametric | Profile maximum, quadratic sub-bin interpolation |
+| `shapelet` | Non-parametric | Hermite–Gaussian decomposition, AICc order selection |
+
+## Profile Models
+
+- **Gaussian** (default) — symmetric, N-component
+- **EMG** — exponentially modified Gaussian for scattering tails
+- **Voigt** — combined Gaussian + Lorentzian broadening
+- **Shapelet** — flexible basis expansion, automatically regularised
+
+## Key Features
+
+- **Auto resolution optimisation** (`--auto_res`) — maximises peak S/N via dyadic rebinning
+- **Sub-band cross-validation** (`--sub_band_fit`) — tests TOA consistency across frequency
+- **AICc model selection** (`--auto_n`) — data-driven choice of component number
+- **MCMC uncertainty** (`--mcmc`) — robust posterior sampling via `emcee`
+- **TEMPO2 output** (`--tim`) — writes `.tim` files for downstream timing analysis
+- **Convergence diagnostic** — Δ_conv metric identifies unstable decompositions
+
+## Requirements
+
+- Python ≥ 3.9
+- numpy, scipy, astropy, matplotlib
+- Optional: emcee, corner
+
+## Citation
+
+If you use toa_sp in your research, please cite:
+
+> Zhang S., Yang X. (2025). TOA_SP: A Multi-Strategy Framework for Single-Pulse Timing. *ApJ*, submitted.
+
+```bibtex
+@article{zhang2025toa_sp,
+  title={TOA\_SP: A Multi-Strategy Framework for Single-Pulse Timing},
+  author={Zhang, Songbo and Yang, Xuan},
+  journal={ApJ},
+  year={2025},
+  note={submitted}
+}
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Repository Structure
+
+```
+toa_sp/
+├── toa_sp.py          # Main pipeline
+├── pyproject.toml      # Package metadata
+├── tools/
+│   ├── plot_pipeline.py       # Pipeline schematic
+│   └── plot_rrat_residuals.py # Residual plot generation
+└── README.md
+```

toa_sp-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "toa_sp"
+version = "0.1.0"
+description = "Multi-strategy single-pulse TOA extraction from PSRFITS search-mode data"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Songbo Zhang", email = "sbzhang@pmo.ac.cn"},
+    {name = "Xuan Yang", email = "yangxuan@pmo.ac.cn"},
+]
+keywords = [
+    "pulsar", "timing", "TOA", "single-pulse", "radio-astronomy",
+    "PSRFITS", "FRB", "RRAT",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "numpy>=1.21",
+    "scipy>=1.7",
+    "astropy>=5.0",
+    "matplotlib>=3.5",
+]
+
+[project.optional-dependencies]
+mcmc = ["emcee>=3.0"]
+corner = ["corner>=2.0"]
+all = ["emcee>=3.0", "corner>=2.0"]
+
+[project.urls]
+Homepage = "https://github.com/songqiii/toa_sp"
+Repository = "https://github.com/songqiii/toa_sp"
+Issues = "https://github.com/songqiii/toa_sp/issues"
+
+[project.scripts]
+toa_sp = "toa_sp:main"
+
+[tool.setuptools]
+py-modules = ["toa_sp"]

toa_sp-0.1.0/setup.cfg

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

toa_sp-0.1.0/toa_sp.egg-info/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: toa_sp
+Version: 0.1.0
+Summary: Multi-strategy single-pulse TOA extraction from PSRFITS search-mode data
+Author-email: Songbo Zhang <sbzhang@pmo.ac.cn>, Xuan Yang <yangxuan@pmo.ac.cn>
+License: MIT
+Project-URL: Homepage, https://github.com/songqiii/toa_sp
+Project-URL: Repository, https://github.com/songqiii/toa_sp
+Project-URL: Issues, https://github.com/songqiii/toa_sp/issues
+Keywords: pulsar,timing,TOA,single-pulse,radio-astronomy,PSRFITS,FRB,RRAT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.21
+Requires-Dist: scipy>=1.7
+Requires-Dist: astropy>=5.0
+Requires-Dist: matplotlib>=3.5
+Provides-Extra: mcmc
+Requires-Dist: emcee>=3.0; extra == "mcmc"
+Provides-Extra: corner
+Requires-Dist: corner>=2.0; extra == "corner"
+Provides-Extra: all
+Requires-Dist: emcee>=3.0; extra == "all"
+Requires-Dist: corner>=2.0; extra == "all"
+Dynamic: license-file
+
+# toa_sp — Multi-Strategy Single-Pulse TOA Extraction
+
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.XXXXXXX-blue)](https://doi.org/10.5281/zenodo.XXXXXXX)
+
+**toa_sp** extracts times of arrival (TOAs) directly from PSRFITS search-mode data, bypassing the folding step required by conventional pulsar timing pipelines. It implements nine complementary TOA estimation strategies — parametric (Gaussian, EMG, Voigt) and non-parametric (leading edge, centre of mass, peak, shapelet) — together with MCMC uncertainty estimation, automatic time-resolution optimisation, and sub-band cross-validation.
+
+Designed for highly variable radio sources (RRATs, FRBs, mode-changing pulsars) where the integrated profile assumption breaks down.
+
+## Installation
+
+```bash
+pip install toa_sp
+```
+
+For MCMC support (optional):
+
+```bash
+pip install toa_sp[all]
+```
+
+## Quick Start
+
+```bash
+toa_sp -f FRB20220529_tracking-M01_0158.fits \
+    -dm 255.0 -s 1.1 -w 0.06 -bs 8 -bf 16 \
+    --auto_res --compare --tim --tim_strategy best \
+    -o timing_result
+```
+
+Or run as a script:
+
+```bash
+python toa_sp.py -f data.fits -dm 175.25 -s 2.5 -w 0.05 -bs 4 -bf 16
+```
+
+## TOA Strategies
+
+| Strategy | Type | Description |
+|---|---|---|
+| `single` | Parametric | Single-component fit; TOA = μ₁ |
+| `highest` | Parametric | Brightest fitted component |
+| `error_weighted` | Parametric | Inverse-variance weighted average |
+| `first_peak` | Parametric | Earliest significant (S/N > 5) component |
+| `weighted` | Parametric | Amplitude-weighted average *(deprecated)* |
+| `leading_edge` | Non-parametric | Half-max crossing + rise-time correction |
+| `center_of_mass` | Non-parametric | Flux-weighted centroid (S > 3σ_off) |
+| `peak` | Non-parametric | Profile maximum, quadratic sub-bin interpolation |
+| `shapelet` | Non-parametric | Hermite–Gaussian decomposition, AICc order selection |
+
+## Profile Models
+
+- **Gaussian** (default) — symmetric, N-component
+- **EMG** — exponentially modified Gaussian for scattering tails
+- **Voigt** — combined Gaussian + Lorentzian broadening
+- **Shapelet** — flexible basis expansion, automatically regularised
+
+## Key Features
+
+- **Auto resolution optimisation** (`--auto_res`) — maximises peak S/N via dyadic rebinning
+- **Sub-band cross-validation** (`--sub_band_fit`) — tests TOA consistency across frequency
+- **AICc model selection** (`--auto_n`) — data-driven choice of component number
+- **MCMC uncertainty** (`--mcmc`) — robust posterior sampling via `emcee`
+- **TEMPO2 output** (`--tim`) — writes `.tim` files for downstream timing analysis
+- **Convergence diagnostic** — Δ_conv metric identifies unstable decompositions
+
+## Requirements
+
+- Python ≥ 3.9
+- numpy, scipy, astropy, matplotlib
+- Optional: emcee, corner
+
+## Citation
+
+If you use toa_sp in your research, please cite:
+
+> Zhang S., Yang X. (2025). TOA_SP: A Multi-Strategy Framework for Single-Pulse Timing. *ApJ*, submitted.
+
+```bibtex
+@article{zhang2025toa_sp,
+  title={TOA\_SP: A Multi-Strategy Framework for Single-Pulse Timing},
+  author={Zhang, Songbo and Yang, Xuan},
+  journal={ApJ},
+  year={2025},
+  note={submitted}
+}
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Repository Structure
+
+```
+toa_sp/
+├── toa_sp.py          # Main pipeline
+├── pyproject.toml      # Package metadata
+├── tools/
+│   ├── plot_pipeline.py       # Pipeline schematic
+│   └── plot_rrat_residuals.py # Residual plot generation
+└── README.md
+```

toa_sp-0.1.0/toa_sp.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+toa_sp.py
+toa_sp.egg-info/PKG-INFO
+toa_sp.egg-info/SOURCES.txt
+toa_sp.egg-info/dependency_links.txt
+toa_sp.egg-info/entry_points.txt
+toa_sp.egg-info/requires.txt
+toa_sp.egg-info/top_level.txt

toa_sp-0.1.0/toa_sp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

toa_sp-0.1.0/toa_sp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+toa_sp = toa_sp:main

toa_sp-0.1.0/toa_sp.egg-info/requires.txt

@@ -0,0 +1,14 @@
+numpy>=1.21
+scipy>=1.7
+astropy>=5.0
+matplotlib>=3.5
+
+[all]
+emcee>=3.0
+corner>=2.0
+
+[corner]
+corner>=2.0
+
+[mcmc]
+emcee>=3.0

toa_sp-0.1.0/toa_sp.egg-info/top_level.txt

@@ -0,0 +1 @@
+toa_sp