takefits 0.2.0__tar.gz

takefits-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shunya Takekawa
+
+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.

takefits-0.2.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: takefits
+Version: 0.2.0
+Summary: GUI-based astronomical FITS viewer and analysis tool
+Author: Shunya Takekawa
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/s-takekawa/takefits
+Project-URL: Repository, https://github.com/s-takekawa/takefits
+Project-URL: Issues, https://github.com/s-takekawa/takefits/issues
+Project-URL: Documentation, https://github.com/s-takekawa/takefits#readme
+Keywords: astronomy,fits,radio astronomy,visualization,gui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6==6.10.2
+Requires-Dist: numpy==2.1.3
+Requires-Dist: scipy==1.14.1
+Requires-Dist: matplotlib==3.8.4
+Requires-Dist: astropy==6.1.0
+Requires-Dist: reproject==0.17.0
+Requires-Dist: PyYAML==6.0.2
+Requires-Dist: astrodendro==0.3.1
+Requires-Dist: scikit-image==0.26.0
+Provides-Extra: publish
+Requires-Dist: build>=1.2.2; extra == "publish"
+Requires-Dist: twine>=6.1.0; extra == "publish"
+Dynamic: license-file
+
+# Takefits
+
+Takefits is a GUI-based astronomical FITS viewer and analysis tool developed by Shunya Takekawa. [ORCID: 0000-0001-8147-6817](https://orcid.org/0000-0001-8147-6817)
+
+## Requirements
+
+- Python 3.12 or later
+
+## Setup
+
+From PyPI:
+
+```bash
+pip install takefits
+```
+
+For a local checkout:
+
+```bash
+python -m venv venv
+source venv/bin/activate    # On Windows: venv\Scripts\activate
+pip install .
+```
+
+## Usage
+
+```bash
+takefits [path/to/fitsfile]
+```
+
+You can also launch it with:
+
+```bash
+python -m takefits [path/to/fitsfile]
+```
+
+Takefits can also save your current work using workspace files, so you can resume it anytime.
+To restore a saved workspace, launch Takefits with the workspace file path.
+
+```bash
+takefits /path/to/yourfile.workspace.json
+```
+
+## Features
+
+Takefits provides a comprehensive set of tools for radio astronomy data analysis.
+
+### 1. Multi-View Cube Visualization
+
+Visualize 3D FITS data cubes with synchronized XY, XZ, and ZY planes.
+
+![Main Window](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/main_window.png)
+
+### 2. Moment Maps & Channel Maps
+
+Calculate moment maps (Integrated Intensity, Velocity Field, Velocity Dispersion) and create tiled channel maps.
+
+![Channel Map](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/channel_map.png)
+
+### 3. Interactive P-V Diagram
+
+Interactively draw slice lines on the map to generate Position-Velocity (P-V) diagrams instantly.
+
+![PV Diagram](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/pv_diagram.png)
+
+### 4. Spectrum Analysis
+
+Extract spectra from a single pixel or calculate the average spectrum within selected regions (Circle, Rectangle, Ellipse, Cube).
+
+![Spectrum](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/spectrum.png)
+
+### 5. Publication-Quality Figures
+
+Generate publication-quality figures directly from the GUI.
+
+- **Contours**: Overlay customizable contours with adjustable levels.
+- **Markers**: Annotate images with symbols, lines, and text.
+- **Beam Size**: Visualize the HPBW ellipse.
+- **Vector Export**: Save plots in PDF, EPS, or SVG formats.
+
+![Contour Plot](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/contour_example.png)
+
+### Other Tools
+
+- **Regridding**: Resample data to a new grid, different coordinate system, or a FITS template.
+- **Smoothing**: Apply Gaussian/Boxcar spatial smoothing and Hanning smoothing along the velocity axis.
+- **Masking**: Apply threshold-based or external masks to data.
+- **Cutout**: Crop data cubes based on regions or coordinate ranges.
+- **Image Arithmetic**: Perform mathematical operations between FITS cubes or with constants using numpy-like expressions.
+- **Unit Conversion**: Convert spectral or intensity units for analysis.
+- **Baseline Subtraction**: Fit and subtract spectral baselines from data cubes.
+- **Clump Finding**: Identify structures using ClumpFind, FellWalker, and Dendrogram algorithms.
+
+## Research use
+
+If you use this software in scientific publications, please cite the Zenodo DOI:
+
+https://doi.org/10.5281/zenodo.18328843
+
+For a specific release, cite the version DOI listed on Zenodo.
+
+## Algorithm Citations
+
+The tools below implement established analysis algorithms. If you use them for your analysis, please cite the original papers:
+
+### Clump Finding
+
+- Williams, J. P., de Geus, E. J., & Blitz, L. (1994). Determining structure in molecular clouds. *The Astrophysical Journal*, 428, 693-712. [doi:10.1086/174279](https://doi.org/10.1086/174279)
+- Berry, D. S. (2015). FellWalker-A clump identification algorithm. *Astronomy and Computing*, 10, 22-31. [doi:10.1016/j.ascom.2014.11.004](https://doi.org/10.1016/j.ascom.2014.11.004)
+- Rosolowsky, E. W., Pineda, J. E., Kauffmann, J., & Goodman, A. A. (2008). Structural Analysis of Molecular Clouds: Dendrograms. *The Astrophysical Journal*, 679(2), 1338-1351. [doi:10.1086/587685](https://doi.org/10.1086/587685)
+
+### Masking / Moment Analysis
+
+- Rosolowsky, E., & Leroy, A. (2006). Bias-free Measurement of Giant Molecular Cloud Properties. *Publications of the Astronomical Society of the Pacific*, 118(842), 590-610. [doi:10.1086/502982](https://doi.org/10.1086/502982)
+- Dame, T. M. (2011). The Technique of Velocity-Resolved Moment Masking. *arXiv e-prints*, arXiv:1101.1499. [arXiv:1101.1499](https://arxiv.org/abs/1101.1499)
+
+## Contact
+
+shunya_at_kanagawa-u.ac.jp

takefits-0.2.0/README.md

@@ -0,0 +1,119 @@
+# Takefits
+
+Takefits is a GUI-based astronomical FITS viewer and analysis tool developed by Shunya Takekawa. [ORCID: 0000-0001-8147-6817](https://orcid.org/0000-0001-8147-6817)
+
+## Requirements
+
+- Python 3.12 or later
+
+## Setup
+
+From PyPI:
+
+```bash
+pip install takefits
+```
+
+For a local checkout:
+
+```bash
+python -m venv venv
+source venv/bin/activate    # On Windows: venv\Scripts\activate
+pip install .
+```
+
+## Usage
+
+```bash
+takefits [path/to/fitsfile]
+```
+
+You can also launch it with:
+
+```bash
+python -m takefits [path/to/fitsfile]
+```
+
+Takefits can also save your current work using workspace files, so you can resume it anytime.
+To restore a saved workspace, launch Takefits with the workspace file path.
+
+```bash
+takefits /path/to/yourfile.workspace.json
+```
+
+## Features
+
+Takefits provides a comprehensive set of tools for radio astronomy data analysis.
+
+### 1. Multi-View Cube Visualization
+
+Visualize 3D FITS data cubes with synchronized XY, XZ, and ZY planes.
+
+![Main Window](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/main_window.png)
+
+### 2. Moment Maps & Channel Maps
+
+Calculate moment maps (Integrated Intensity, Velocity Field, Velocity Dispersion) and create tiled channel maps.
+
+![Channel Map](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/channel_map.png)
+
+### 3. Interactive P-V Diagram
+
+Interactively draw slice lines on the map to generate Position-Velocity (P-V) diagrams instantly.
+
+![PV Diagram](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/pv_diagram.png)
+
+### 4. Spectrum Analysis
+
+Extract spectra from a single pixel or calculate the average spectrum within selected regions (Circle, Rectangle, Ellipse, Cube).
+
+![Spectrum](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/spectrum.png)
+
+### 5. Publication-Quality Figures
+
+Generate publication-quality figures directly from the GUI.
+
+- **Contours**: Overlay customizable contours with adjustable levels.
+- **Markers**: Annotate images with symbols, lines, and text.
+- **Beam Size**: Visualize the HPBW ellipse.
+- **Vector Export**: Save plots in PDF, EPS, or SVG formats.
+
+![Contour Plot](https://raw.githubusercontent.com/s-takekawa/takefits/main/docs/images/contour_example.png)
+
+### Other Tools
+
+- **Regridding**: Resample data to a new grid, different coordinate system, or a FITS template.
+- **Smoothing**: Apply Gaussian/Boxcar spatial smoothing and Hanning smoothing along the velocity axis.
+- **Masking**: Apply threshold-based or external masks to data.
+- **Cutout**: Crop data cubes based on regions or coordinate ranges.
+- **Image Arithmetic**: Perform mathematical operations between FITS cubes or with constants using numpy-like expressions.
+- **Unit Conversion**: Convert spectral or intensity units for analysis.
+- **Baseline Subtraction**: Fit and subtract spectral baselines from data cubes.
+- **Clump Finding**: Identify structures using ClumpFind, FellWalker, and Dendrogram algorithms.
+
+## Research use
+
+If you use this software in scientific publications, please cite the Zenodo DOI:
+
+https://doi.org/10.5281/zenodo.18328843
+
+For a specific release, cite the version DOI listed on Zenodo.
+
+## Algorithm Citations
+
+The tools below implement established analysis algorithms. If you use them for your analysis, please cite the original papers:
+
+### Clump Finding
+
+- Williams, J. P., de Geus, E. J., & Blitz, L. (1994). Determining structure in molecular clouds. *The Astrophysical Journal*, 428, 693-712. [doi:10.1086/174279](https://doi.org/10.1086/174279)
+- Berry, D. S. (2015). FellWalker-A clump identification algorithm. *Astronomy and Computing*, 10, 22-31. [doi:10.1016/j.ascom.2014.11.004](https://doi.org/10.1016/j.ascom.2014.11.004)
+- Rosolowsky, E. W., Pineda, J. E., Kauffmann, J., & Goodman, A. A. (2008). Structural Analysis of Molecular Clouds: Dendrograms. *The Astrophysical Journal*, 679(2), 1338-1351. [doi:10.1086/587685](https://doi.org/10.1086/587685)
+
+### Masking / Moment Analysis
+
+- Rosolowsky, E., & Leroy, A. (2006). Bias-free Measurement of Giant Molecular Cloud Properties. *Publications of the Astronomical Society of the Pacific*, 118(842), 590-610. [doi:10.1086/502982](https://doi.org/10.1086/502982)
+- Dame, T. M. (2011). The Technique of Velocity-Resolved Moment Masking. *arXiv e-prints*, arXiv:1101.1499. [arXiv:1101.1499](https://arxiv.org/abs/1101.1499)
+
+## Contact
+
+shunya_at_kanagawa-u.ac.jp

takefits-0.2.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "takefits"
+dynamic = ["version"]
+description = "GUI-based astronomical FITS viewer and analysis tool"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Shunya Takekawa" }]
+keywords = ["astronomy", "fits", "radio astronomy", "visualization", "gui"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Astronomy",
+  "Topic :: Scientific/Engineering :: Visualization",
+]
+dependencies = [
+  "PySide6==6.10.2",
+  "numpy==2.1.3",
+  "scipy==1.14.1",
+  "matplotlib==3.8.4",
+  "astropy==6.1.0",
+  "reproject==0.17.0",
+  "PyYAML==6.0.2",
+  "astrodendro==0.3.1",
+  "scikit-image==0.26.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/s-takekawa/takefits"
+Repository = "https://github.com/s-takekawa/takefits"
+Issues = "https://github.com/s-takekawa/takefits/issues"
+Documentation = "https://github.com/s-takekawa/takefits#readme"
+
+[project.optional-dependencies]
+publish = [
+  "build>=1.2.2",
+  "twine>=6.1.0",
+]
+
+[project.scripts]
+takefits = "takefits.main:main"
+
+[tool.setuptools.dynamic]
+version = { attr = "takefits.core.version.APP_VERSION" }
+
+[tool.setuptools.packages.find]
+include = ["takefits*"]

takefits-0.2.0/setup.cfg

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

takefits-0.2.0/takefits/__init__.py

@@ -0,0 +1,3 @@
+from .core.version import APP_VERSION as __version__
+
+__all__ = ["__version__"]

takefits-0.2.0/takefits/__main__.py

@@ -0,0 +1,4 @@
+from .main import main
+
+if __name__ == '__main__':
+    main()

takefits-0.2.0/takefits/app_paths.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from PySide6.QtCore import QStandardPaths
+
+FALLBACK_APP_DIR_NAME = 'takefits'
+
+def get_app_config_dir() -> Path:
+    path = QStandardPaths.writableLocation(QStandardPaths.StandardLocation.AppConfigLocation)
+    if path:
+        return Path(path)
+    return Path.home() / '.config' / FALLBACK_APP_DIR_NAME
+
+def ensure_app_config_dir() -> Path:
+    path = get_app_config_dir()
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+def app_config_path(filename: str) -> str:
+    return str(ensure_app_config_dir() / filename)