vasca


Namevasca JSON
Version 1.0.16 PyPI version JSON
download
home_pageNone
SummaryUltraviolet Variability Analysis is an astronomy pipeline for time-variable sources.
upload_time2024-11-11 08:48:24
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseBSD 3-Clause License Copyright (c) 2023, Rolf Buehler Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. 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. 3. 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.
keywords astronomy ultraviolet pipeline
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
![VASCA icon](docs/images/VASCA_icon.png)
[![🧪 pytest](https://github.com/rbuehler/vasca/actions/workflows/ci.yml/badge.svg)](https://github.com/rbuehler/vasca/actions/workflows/ci.yml)
[![📚 docs](https://github.com/rbuehler/vasca/actions/workflows/docs.yml/badge.svg)](https://rbuehler.github.io/vasca/)
[![🚀 pypi](https://github.com/rbuehler/vasca/actions/workflows/pypi.yml/badge.svg)](https://pypi.org/project/vasca/)


# Variable Source Cluster Analysis (VASCA)

1. [Motivation](#motivation)
2. [Pipeline Overview](#pipeline-overview)
3. [Key Features](#key-features)
4. [Proof-of-Principle Study](#proof-of-principle-study)
5. [Documentation and Installation](#documentation-and-installation)
6. [Getting Started](docs/getting_started.md#getting-started)

## Motivation
VASCA (Italian for "bathtub" 🛁) is a high-performance software package developed to
address the challenges of time-domain astronomy, especially given the increasing volume
of data from large-scale surveys such as [ZTF](https://en.wikipedia.org/wiki/Zwicky_Transient_Facility),
[LSST](https://en.wikipedia.org/wiki/Vera_C._Rubin_Observatory), and [ULTRASAT](https://www.weizmann.ac.il/ultrasat/).
Designed to analyze time-variable cosmic sources like active galactic nuclei, stars, and
transient events, VASCA provides a modular, scalable solution for integrating data from
multiple instruments and conducting a cohesive analysis.

## Pipeline Overview

The VASCA analysis pipeline consists of three primary steps:
1. **Spatial Clustering**: Associate detections from repeated observations to unique
cosmic sources using [mean-shift](https://en.wikipedia.org/wiki/Mean_shift) clustering.
2. **Statistical Variability Detection**: Identify time-variable sources by testing flux
variations against a constant hypothesis at a 5-σ significance level.
3. **Source Classification**: Classify detected sources, including cross-matching with
external catalogs (e.g., SIMBAD, Gaia).

The main output of the pipeline is a catalog of time-variable cosmic
sources, including detailed classifications and cross-matches with existing astronomical
databases.

## Key Features

- **Simplicity and Modularity**: The software uses a hierarchical data model and modular
processing to ensure scalability and ease of use. It supports data from multiple
instruments seamlessly.
- **Proven Algorithms**: VASCA relies on established algorithms and statistical methods,
ensuring robustness and reducing the maintenance burden.
- **Focus on Specific Use Case**: Optimized for analyzing time-domain astronomical data,
VASCA keeps complexity low, simplifying auditing and debugging.
- **Standards Compliance**: Outputs are designed for publication readiness by adhering to
IAU and CDS standards, using widely-accepted, non-proprietary data formats. 
- **Customization and Extensibility**: VASCA allows flexible configuration, making it
adaptable to different datasets and instrument-specific requirements.

## Proof-of-Principle Study

VASCA was applied to a proof-of-principle study  using the Galaxy Evolution Explorer
(GALEX) archive (2003-2013). This study produced a catalog of over 4,000 UV-variable
sources, revealing UV variability across all classes of stars. Notably, a massive,
pulsating white dwarf exhibited unique long-term variability in the UV. The full article
including a description of VASCA's pipeline can be found here:
[The time-variable ultraviolet sky: Active galactic nuclei, stars, and white dwarfs](https://ui.adsabs.harvard.edu/abs/2024A%26A...687A.313B/abstract).

## Documentation and Installation

VASCA is distributed as an open-source package. Comprehensive documentation is available
[here](https://rbuehler.github.io/vasca/), including example notebooks and an API reference to help users get started.
For quick installation, VASCA can be installed via [PyPI](https://pypi.org/project/vasca/) using:
```shell
pip install vasca
```
For more info see the [installation guide](docs/getting_started.md#installation).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "vasca",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "astronomy, ultraviolet, pipeline",
    "author": null,
    "author_email": "Julian Schliwinski <julian.schliwinski@desy.de>, Rolf B\u00fchler <rolf.buehler@desy.de>",
    "download_url": "https://files.pythonhosted.org/packages/65/ff/fca99ce79b434066da83f89376de1d27fe39aa7276693695df17d487523b/vasca-1.0.16.tar.gz",
    "platform": null,
    "description": "\n![VASCA icon](docs/images/VASCA_icon.png)\n[![\ud83e\uddea pytest](https://github.com/rbuehler/vasca/actions/workflows/ci.yml/badge.svg)](https://github.com/rbuehler/vasca/actions/workflows/ci.yml)\n[![\ud83d\udcda docs](https://github.com/rbuehler/vasca/actions/workflows/docs.yml/badge.svg)](https://rbuehler.github.io/vasca/)\n[![\ud83d\ude80 pypi](https://github.com/rbuehler/vasca/actions/workflows/pypi.yml/badge.svg)](https://pypi.org/project/vasca/)\n\n\n# Variable Source Cluster Analysis (VASCA)\n\n1. [Motivation](#motivation)\n2. [Pipeline Overview](#pipeline-overview)\n3. [Key Features](#key-features)\n4. [Proof-of-Principle Study](#proof-of-principle-study)\n5. [Documentation and Installation](#documentation-and-installation)\n6. [Getting Started](docs/getting_started.md#getting-started)\n\n## Motivation\nVASCA (Italian for \"bathtub\" \ud83d\udec1) is a high-performance software package developed to\naddress the challenges of time-domain astronomy, especially given the increasing volume\nof data from large-scale surveys such as [ZTF](https://en.wikipedia.org/wiki/Zwicky_Transient_Facility),\n[LSST](https://en.wikipedia.org/wiki/Vera_C._Rubin_Observatory), and [ULTRASAT](https://www.weizmann.ac.il/ultrasat/).\nDesigned to analyze time-variable cosmic sources like active galactic nuclei, stars, and\ntransient events, VASCA provides a modular, scalable solution for integrating data from\nmultiple instruments and conducting a cohesive analysis.\n\n## Pipeline Overview\n\nThe VASCA analysis pipeline consists of three primary steps:\n1. **Spatial Clustering**: Associate detections from repeated observations to unique\ncosmic sources using [mean-shift](https://en.wikipedia.org/wiki/Mean_shift) clustering.\n2. **Statistical Variability Detection**: Identify time-variable sources by testing flux\nvariations against a constant hypothesis at a 5-\u03c3 significance level.\n3. **Source Classification**: Classify detected sources, including cross-matching with\nexternal catalogs (e.g., SIMBAD, Gaia).\n\nThe main output of the pipeline is a catalog of time-variable cosmic\nsources, including detailed classifications and cross-matches with existing astronomical\ndatabases.\n\n## Key Features\n\n- **Simplicity and Modularity**: The software uses a hierarchical data model and modular\nprocessing to ensure scalability and ease of use. It supports data from multiple\ninstruments seamlessly.\n- **Proven Algorithms**: VASCA relies on established algorithms and statistical methods,\nensuring robustness and reducing the maintenance burden.\n- **Focus on Specific Use Case**: Optimized for analyzing time-domain astronomical data,\nVASCA keeps complexity low, simplifying auditing and debugging.\n- **Standards Compliance**: Outputs are designed for publication readiness by adhering to\nIAU and CDS standards, using widely-accepted, non-proprietary data formats. \n- **Customization and Extensibility**: VASCA allows flexible configuration, making it\nadaptable to different datasets and instrument-specific requirements.\n\n## Proof-of-Principle Study\n\nVASCA was applied to a proof-of-principle study  using the Galaxy Evolution Explorer\n(GALEX) archive (2003-2013). This study produced a catalog of over 4,000 UV-variable\nsources, revealing UV variability across all classes of stars. Notably, a massive,\npulsating white dwarf exhibited unique long-term variability in the UV. The full article\nincluding a description of VASCA's pipeline\u00a0can be found here:\n[The time-variable ultraviolet sky: Active galactic nuclei, stars, and white dwarfs](https://ui.adsabs.harvard.edu/abs/2024A%26A...687A.313B/abstract).\n\n## Documentation and Installation\n\nVASCA is distributed as an open-source package. Comprehensive documentation is available\n[here](https://rbuehler.github.io/vasca/), including example notebooks and an API reference to help users get started.\nFor quick installation, VASCA can be installed via [PyPI](https://pypi.org/project/vasca/) using:\n```shell\npip install vasca\n```\nFor more info see the [installation guide](docs/getting_started.md#installation).\n",
    "bugtrack_url": null,
    "license": "BSD 3-Clause License  Copyright (c) 2023, Rolf Buehler  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  2. 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.  3. 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. ",
    "summary": "Ultraviolet Variability Analysis is an astronomy pipeline for time-variable sources.",
    "version": "1.0.16",
    "project_urls": {
        "changelog": "https://tbd.desy.de",
        "documentation": "https://schliwiju.github.io/vasca-mirror/",
        "homepage": "https://schliwiju.github.io/vasca-mirror/",
        "repository": "https://github.com/rbuehler/vasca"
    },
    "split_keywords": [
        "astronomy",
        " ultraviolet",
        " pipeline"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4c76be049946785d98a926eda9fa13841fae5075935c6448c27b57c15c23ee3b",
                "md5": "d2f667a96d6b0e1b71af2a98f86bb57e",
                "sha256": "96f4d6c31dffbaa3b1fadc7042b56c52dda05c7451c9403b7f6c35079328b785"
            },
            "downloads": -1,
            "filename": "vasca-1.0.16-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d2f667a96d6b0e1b71af2a98f86bb57e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 47623377,
            "upload_time": "2024-11-11T08:48:20",
            "upload_time_iso_8601": "2024-11-11T08:48:20.284485Z",
            "url": "https://files.pythonhosted.org/packages/4c/76/be049946785d98a926eda9fa13841fae5075935c6448c27b57c15c23ee3b/vasca-1.0.16-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "65fffca99ce79b434066da83f89376de1d27fe39aa7276693695df17d487523b",
                "md5": "4a341d88fffeeb136fa1be3db598d7d6",
                "sha256": "0b1e4203d799be4389782e9e25a0bf1bd7e83a42d206f5eaf21ff9a363c79c92"
            },
            "downloads": -1,
            "filename": "vasca-1.0.16.tar.gz",
            "has_sig": false,
            "md5_digest": "4a341d88fffeeb136fa1be3db598d7d6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 47472171,
            "upload_time": "2024-11-11T08:48:24",
            "upload_time_iso_8601": "2024-11-11T08:48:24.833697Z",
            "url": "https://files.pythonhosted.org/packages/65/ff/fca99ce79b434066da83f89376de1d27fe39aa7276693695df17d487523b/vasca-1.0.16.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-11 08:48:24",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "rbuehler",
    "github_project": "vasca",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "vasca"
}
        
Elapsed time: 0.60174s