dran2

Name	dran2 JSON
Version	0.0.9 JSON
	download
home_page	None
Summary	Data reduction and analysis of HartRAO 26m telescope drift scans
upload_time	2024-09-03 18:24:14
maintainer	None
docs_url	None
author	None
requires_python	>=3.10
license	MIT License
keywords	dran single-dish hartrao sarao
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            DRAN README
===========

**DRAN** (**D**ata **R**eduction and **AN**alysis) is a recently developed software pipeline specifically designed to streamline the reduction and analysis of drift scan data acquired with [HartRAO's ](http://www.hartrao.ac.za) [26m telescope](http://www.hartrao.ac.za/hh26m_factsfile.html). DRAN supersedes the older **LINES** continuum data reduction and analysis program previously employed at HartRAO.

Originally conceived as part of Dr. Pfesesani Van Zyl's Ph.D. project, **DRAN** is currently maintained by the author, a postdoctoral researcher at [SARAO (the South African Radio AStronomy Observatory](http://www.sarao.ac.za/).

To get started with DRAN and read more on the full documentations of the program you can go to the DRAN [READTHEDOCS](https://dran2.readthedocs.io/en/latest/) page.

Acknowledging DRAN
-------------------
To acknowledge the **DRAN** software pipeline, please cite [van Zyl P. 2023](https://ui.adsabs.harvard.edu/abs/2023arXiv230600764V/abstract).  For a full citation, you can reference the following publication: arXiv:2306.00764 [[astro-ph.IM]](https://arxiv.org/abs/2306.00764).

Program structure 
------------------

**DRAN** offers two user interfaces for flexibility:

* **Command-Line Interface (CLI)**: Designed for automated and semi-automated processing of drift scan data. The CLI streamlines the reduction and analysis of large batches of drift scan files.

* **Graphical User Interface (GUI)**: Provides a user-friendly environment ideal for interactive exploration and analysis of individual files. The GUI allows for data inspection, fitting, and basic analysis of time series data produced by the CLI.



Requirements
-------------

The list of required Python packages can be found in the included requirements.txt file.


Installation 
-------------

DRAN is conveniently available for installation through the [PYPI package manager](https://pypi.org/project/dran2/) using the following command:

``` 
  $ pip install dran2
```

Data files
----------

### Input Data Format

DRAN requires data to be provided in the Flexible Image Transport System [FITS](https://fits.gsfc.nasa.gov/fits_documentation.html) format, a common standard for scientific data.



### File Reading Methods:
DRAN offers two ways to specify input data:

1. Explicit File Path: Users can provide the complete path to a single FITS file or a directory containing FITS files for batch processing.

```
Example: 
$ dran-auto -f /path/to/single_file.fits
```
```
Example (batch processing): 
$ dran-auto -f /path/to/data_directory/
```

2. Interactive Selection (GUI only):  The graphical user interface (GUI) allows users to interactively browse and select individual FITS files for processing.

### Output Data Format

DRAN stores the processed data in a SQLite database file. This file is automatically saved in the user's current working directory upon completion.


Getting Started with DRAN
----------
Once you've installed DRAN, you can start processing your data. Here's a quick guide to get you started:

1. Explore available options:

Run the following command to see a list of available options and what they do:

```
$ dran-auto -h or --help
```

2. Process your data:

Use the -f option followed by the path to your data to process a single file or an entire directory:

* To process a single file:
```
$ dran-auto -f /path/to/your/file.fits
```

* To process all FITS files in a directory (batch processing):

```
$ dran-auto -f /path/to/your/data/directory/
```

* To run the GUI
```
$ dran-gui 
```


3. Additional options:

For more advanced users, the -db, -delete_db, -conv, and -quickview options provide additional functionalities. Refer to the full help menu (dran-auto -h) for detailed explanations.

> `note:` If you have suggestions for new features, feel free to contact the author (details provided below).

Important Considerations:
-------

While DRAN strives to provide good quality fits to your data, it's important to be aware of the following:

* Automatic Fitting: DRAN performs automated fitting routines. However, it's crucial for users to visually inspect the results to ensure a satisfactory fit.

* Data Quality: DRAN attempts to fit all data points, including potentially problematic ones. Users should be mindful of potential outliers or noise in their data that might affect the final fit.

Recommendation:
-------
To ensure accurate analysis, we recommend that users review the generated plots located in the "plots" folder. These plots visually represent the fit and can help identify any potential issues with the data or the fitting process.


Get Help and Contribute
---------------

Having trouble with DRAN? Have questions about the software or features? We encourage you to:

* Report Issues: Encounter any bugs or unexpected behavior? Please [OPEN AN ISSUE](https://github.com/Pfesi/dran2/issues) on the GitHub repository.
* Share your thoughts: We value your feedback! Feel free to use the GitHub issue tracker to suggest improvements or request new features.


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "dran2",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "dran, single-dish, hartrao, sarao",
    "author": null,
    "author_email": "Pfesesani van Zyl <pfesi24@gmail.com>",
    "download_url": null,
    "platform": null,
    "description": "DRAN README\n===========\n\n**DRAN** (**D**ata **R**eduction and **AN**alysis) is a recently developed software pipeline specifically designed to streamline the reduction and analysis of drift scan data acquired with [HartRAO's ](http://www.hartrao.ac.za) [26m telescope](http://www.hartrao.ac.za/hh26m_factsfile.html). DRAN supersedes the older **LINES** continuum data reduction and analysis program previously employed at HartRAO.\n\nOriginally conceived as part of Dr. Pfesesani Van Zyl's Ph.D. project, **DRAN** is currently maintained by the author, a postdoctoral researcher at [SARAO (the South African Radio AStronomy Observatory](http://www.sarao.ac.za/).\n\nTo get started with DRAN and read more on the full documentations of the program you can go to the DRAN [READTHEDOCS](https://dran2.readthedocs.io/en/latest/) page.\n\nAcknowledging DRAN\n-------------------\nTo acknowledge the **DRAN** software pipeline, please cite [van Zyl P. 2023](https://ui.adsabs.harvard.edu/abs/2023arXiv230600764V/abstract).  For a full citation, you can reference the following publication: arXiv:2306.00764 [[astro-ph.IM]](https://arxiv.org/abs/2306.00764).\n\nProgram structure \n------------------\n\n**DRAN** offers two user interfaces for flexibility:\n\n* **Command-Line Interface (CLI)**: Designed for automated and semi-automated processing of drift scan data. The CLI streamlines the reduction and analysis of large batches of drift scan files.\n\n* **Graphical User Interface (GUI)**: Provides a user-friendly environment ideal for interactive exploration and analysis of individual files. The GUI allows for data inspection, fitting, and basic analysis of time series data produced by the CLI.\n\n\n\nRequirements\n-------------\n\nThe list of required Python packages can be found in the included requirements.txt file.\n\n\nInstallation \n-------------\n\nDRAN is conveniently available for installation through the [PYPI package manager](https://pypi.org/project/dran2/) using the following command:\n\n``` \n  $ pip install dran2\n```\n\nData files\n----------\n\n### Input Data Format\n\nDRAN requires data to be provided in the Flexible Image Transport System [FITS](https://fits.gsfc.nasa.gov/fits_documentation.html) format, a common standard for scientific data.\n\n\n\n### File Reading Methods:\nDRAN offers two ways to specify input data:\n\n1. Explicit File Path: Users can provide the complete path to a single FITS file or a directory containing FITS files for batch processing.\n\n```\nExample: \n$ dran-auto -f /path/to/single_file.fits\n```\n```\nExample (batch processing): \n$ dran-auto -f /path/to/data_directory/\n```\n\n2. Interactive Selection (GUI only):  The graphical user interface (GUI) allows users to interactively browse and select individual FITS files for processing.\n\n### Output Data Format\n\nDRAN stores the processed data in a SQLite database file. This file is automatically saved in the user's current working directory upon completion.\n\n\nGetting Started with DRAN\n----------\nOnce you've installed DRAN, you can start processing your data. Here's a quick guide to get you started:\n\n1. Explore available options:\n\nRun the following command to see a list of available options and what they do:\n\n```\n$ dran-auto -h or --help\n```\n\n2. Process your data:\n\nUse the -f option followed by the path to your data to process a single file or an entire directory:\n\n* To process a single file:\n```\n$ dran-auto -f /path/to/your/file.fits\n```\n\n* To process all FITS files in a directory (batch processing):\n\n```\n$ dran-auto -f /path/to/your/data/directory/\n```\n\n* To run the GUI\n```\n$ dran-gui \n```\n\n\n3. Additional options:\n\nFor more advanced users, the -db, -delete_db, -conv, and -quickview options provide additional functionalities. Refer to the full help menu (dran-auto -h) for detailed explanations.\n\n> `note:` If you have suggestions for new features, feel free to contact the author (details provided below).\n\nImportant Considerations:\n-------\n\nWhile DRAN strives to provide good quality fits to your data, it's important to be aware of the following:\n\n* Automatic Fitting: DRAN performs automated fitting routines. However, it's crucial for users to visually inspect the results to ensure a satisfactory fit.\n\n* Data Quality: DRAN attempts to fit all data points, including potentially problematic ones. Users should be mindful of potential outliers or noise in their data that might affect the final fit.\n\nRecommendation:\n-------\nTo ensure accurate analysis, we recommend that users review the generated plots located in the \"plots\" folder. These plots visually represent the fit and can help identify any potential issues with the data or the fitting process.\n\n\nGet Help and Contribute\n---------------\n\nHaving trouble with DRAN? Have questions about the software or features? We encourage you to:\n\n* Report Issues: Encounter any bugs or unexpected behavior? Please [OPEN AN ISSUE](https://github.com/Pfesi/dran2/issues) on the GitHub repository.\n* Share your thoughts: We value your feedback! Feel free to use the GitHub issue tracker to suggest improvements or request new features.\n\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Data reduction and analysis of HartRAO 26m telescope drift scans",
    "version": "0.0.9",
    "project_urls": {
        "Changelog": "https://dran2.readthedocs.io/en/latest/extras/changelog.html",
        "Documentation": "https://dran2.readthedocs.io/en/latest/",
        "Issues": "https://github.com/Pfesi/dran2/issues",
        "Repository": "https://github.com/Pfesi/dran2"
    },
    "split_keywords": [
        "dran",
        " single-dish",
        " hartrao",
        " sarao"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a4c5e6e45ede74cee714fbc95b00052dedbf19eaea667fda23973adc5a6811d8",
                "md5": "99966c4cb29a571e6d2b02dfb588a301",
                "sha256": "862bcee9cca4b4453e43e47549277e917730d1f2af405df5f887f8b5daf3e723"
            },
            "downloads": -1,
            "filename": "dran2-0.0.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "99966c4cb29a571e6d2b02dfb588a301",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 149920,
            "upload_time": "2024-09-03T18:24:14",
            "upload_time_iso_8601": "2024-09-03T18:24:14.971009Z",
            "url": "https://files.pythonhosted.org/packages/a4/c5/e6e45ede74cee714fbc95b00052dedbf19eaea667fda23973adc5a6811d8/dran2-0.0.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-03 18:24:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Pfesi",
    "github_project": "dran2",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "dran2"
}