# Astro Toolbox
[](https://astro-toolbox.readthedocs.io/en/latest/) [](https://en.wikipedia.org/wiki/GNU_General_Public_License) [](https://www.python.org/dev/peps/pep-0008/)
The astro_toolbox project is developped to allow amateur astronomer and observatory to perform observationnal astronomy calculations. This repository contain the source code of the project. At this moment the project represent an alpha version.
## Installation
Use `pip install astro_toolbox` to install last version or clone this repository and execute `make install`.
## Basic usage
### Synopsis
astro-toolbox \[options1\] \<command\> \<argument\> \[options2\]
# Options 1
**-v, \--verbose** Program verbosity.
# Commands
# airmass
This command allows you to plot airmass map of one or multiple objects.
# *argument*
You can enter one or many objects or a path to a file or a directory. If
you left it blank, it will search on your current directory a file named
observations.lst
You must end the name to a directory with a `/`
# *examples:*
`astro-toolbox airmass examples/`
`astro-toolbox airmass examples/examples.lst`
`astro-toolbox airmass betelgeuse vega`
# *options*
**-d, \--date** Option to inform a different date `-d 2022-12-18`,
default is None (today date).
**-l, \--location** Option to inform a location name `-l Greenwich`,
default is None (last location used).
**-o, \--output** Option to inform the output directory (must end with a
`/`) `-o examples/`, default is \'\' (current directory).
**\--bounds** Option which requires two hours arguments consider this
program calculates everything in UT `--bounds 19 33` mean we begin
calculations at 7pm and end these at 9am the next day.
# info
This command allows you to query Simbad (for stars and deep sky objects)
or JPL Horizons for solar system objects.
# *argument*
Enter the object name as argument
# *options*
**-d, \--date** Option to inform a different date `-d 2022-12-18`,
default is None (today date).
**-l, \--location** Option to inform a location name `-l Greenwich`,
default is None (last location used).
# location
This command allows you to add, update or read a location.
# *argument*
Enter the location name, list allow you to display all locations saved.
# *options*
**-a, \--add** Option to add a new location (if it doesn\'t exists). It
will ask you longitude, latitude in degrees (0.0) or DMS (0°0\'0\") and
elevation in meters.
**-d, \--delete** Option to delete a location (if it exists).
**-u, \--update** Option to update an existing location it will ask the
same thing as adding option but left blank the data, you don\'t want to
change.
# polaris
This command allows you to display the polaris position (northern and
southern hemisphere) in a polar finder. This command doesn\'t need any
argument.
# *options*
**-d, \--datetime** Option to inform a different date and time
`-d 2022-12-18:20:35:55`, default is None (today date).
**-l, \--location** Option to inform a location name `-l Greenwich`,
default is None (last location used).
# weather
This command allows you to display forecasts of a given location.
This command doesn\'t need any argument.
# *options*
**-l, \--location** Option to inform a location name `-l Greenwich`,
default is None (last location used).
**-d, \--days** Counter to inform the number of days to display,
default is 1.
**-p, \--past** Counter to inform the number of past days to display,
default is 0.
## Documentation
The documentation is availale on [readthedocs.io](https://astro-toolbox.readthedocs.io/en/latest/)
## License
Astropy is licensed under a GNU GPL license - see the [LICENSE](https://github.com/rloustalet/astro_toolbox/blob/main/LICENSE) file.
Raw data
{
"_id": null,
"home_page": "https://github.com/rloustalet/astro_toolbox",
"name": "astro-toolbox",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "astro,toolbox,astro_toolbox,observationnal",
"author": "Romain Loustalet Palengat",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/2f/f7/0b706901234c32f68352b95cf541c94c1e978202d76191019328f6bf19aa/astro-toolbox-0.1.2.tar.gz",
"platform": "unix",
"description": "# Astro Toolbox\n\n[](https://astro-toolbox.readthedocs.io/en/latest/) [](https://en.wikipedia.org/wiki/GNU_General_Public_License) [](https://www.python.org/dev/peps/pep-0008/)\n\nThe astro_toolbox project is developped to allow amateur astronomer and observatory to perform observationnal astronomy calculations. This repository contain the source code of the project. At this moment the project represent an alpha version. \n\n## Installation\n\nUse `pip install astro_toolbox` to install last version or clone this repository and execute `make install`.\n\n## Basic usage\n\n### Synopsis\n\nastro-toolbox \\[options1\\] \\<command\\> \\<argument\\> \\[options2\\]\n\n# Options 1\n\n**-v, \\--verbose** Program verbosity.\n\n# Commands\n\n# airmass\n\nThis command allows you to plot airmass map of one or multiple objects.\n\n# *argument*\n\nYou can enter one or many objects or a path to a file or a directory. If\nyou left it blank, it will search on your current directory a file named\nobservations.lst\n\nYou must end the name to a directory with a `/`\n\n# *examples:*\n\n`astro-toolbox airmass examples/`\n\n`astro-toolbox airmass examples/examples.lst`\n\n`astro-toolbox airmass betelgeuse vega`\n\n# *options*\n\n**-d, \\--date** Option to inform a different date `-d 2022-12-18`,\ndefault is None (today date).\n\n**-l, \\--location** Option to inform a location name `-l Greenwich`,\ndefault is None (last location used).\n\n**-o, \\--output** Option to inform the output directory (must end with a\n`/`) `-o examples/`, default is \\'\\' (current directory).\n\n**\\--bounds** Option which requires two hours arguments consider this\nprogram calculates everything in UT `--bounds 19 33` mean we begin\ncalculations at 7pm and end these at 9am the next day.\n\n# info\n\nThis command allows you to query Simbad (for stars and deep sky objects)\nor JPL Horizons for solar system objects.\n\n# *argument*\n\nEnter the object name as argument\n\n# *options*\n\n**-d, \\--date** Option to inform a different date `-d 2022-12-18`,\ndefault is None (today date).\n\n**-l, \\--location** Option to inform a location name `-l Greenwich`,\ndefault is None (last location used).\n\n# location\n\nThis command allows you to add, update or read a location.\n\n# *argument*\n\nEnter the location name, list allow you to display all locations saved.\n\n# *options*\n\n**-a, \\--add** Option to add a new location (if it doesn\\'t exists). It\nwill ask you longitude, latitude in degrees (0.0) or DMS (0\u00b00\\'0\\\") and\nelevation in meters.\n\n**-d, \\--delete** Option to delete a location (if it exists).\n\n**-u, \\--update** Option to update an existing location it will ask the\nsame thing as adding option but left blank the data, you don\\'t want to\nchange.\n\n# polaris\n\nThis command allows you to display the polaris position (northern and\nsouthern hemisphere) in a polar finder. This command doesn\\'t need any\nargument.\n\n# *options*\n\n**-d, \\--datetime** Option to inform a different date and time\n`-d 2022-12-18:20:35:55`, default is None (today date).\n\n**-l, \\--location** Option to inform a location name `-l Greenwich`,\ndefault is None (last location used).\n\n# weather\n\nThis command allows you to display forecasts of a given location.\nThis command doesn\\'t need any argument.\n\n# *options*\n\n**-l, \\--location** Option to inform a location name `-l Greenwich`,\ndefault is None (last location used).\n\n**-d, \\--days** Counter to inform the number of days to display,\ndefault is 1.\n\n**-p, \\--past** Counter to inform the number of past days to display,\ndefault is 0.\n\n## Documentation\n\nThe documentation is availale on [readthedocs.io](https://astro-toolbox.readthedocs.io/en/latest/)\n\n## License\n\nAstropy is licensed under a GNU GPL license - see the [LICENSE](https://github.com/rloustalet/astro_toolbox/blob/main/LICENSE) file.\n",
"bugtrack_url": null,
"license": "",
"summary": "Toolbox for observationnal astronomy",
"version": "0.1.2",
"split_keywords": [
"astro",
"toolbox",
"astro_toolbox",
"observationnal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ce5eb352302f9e92e9f113071632d137e53e5ed9fc2ff24ba2821ca20f882093",
"md5": "adcf2e51da904da28b9f0068cd2dc71b",
"sha256": "40d799a6db9543473825bedb51c5b235775f7476aca52fab24d3c699faa93b7d"
},
"downloads": -1,
"filename": "astro_toolbox-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "adcf2e51da904da28b9f0068cd2dc71b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 56839,
"upload_time": "2023-04-22T12:38:55",
"upload_time_iso_8601": "2023-04-22T12:38:55.035486Z",
"url": "https://files.pythonhosted.org/packages/ce/5e/b352302f9e92e9f113071632d137e53e5ed9fc2ff24ba2821ca20f882093/astro_toolbox-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2ff70b706901234c32f68352b95cf541c94c1e978202d76191019328f6bf19aa",
"md5": "be57e2ee4c723471f9ca01ad29ec7d50",
"sha256": "f76c2f7038386ea956928a1e6f20ac3333ea0e61f6ea5be07496113c5d8da600"
},
"downloads": -1,
"filename": "astro-toolbox-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "be57e2ee4c723471f9ca01ad29ec7d50",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 47509,
"upload_time": "2023-04-22T12:38:57",
"upload_time_iso_8601": "2023-04-22T12:38:57.911110Z",
"url": "https://files.pythonhosted.org/packages/2f/f7/0b706901234c32f68352b95cf541c94c1e978202d76191019328f6bf19aa/astro-toolbox-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-22 12:38:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "rloustalet",
"github_project": "astro_toolbox",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "astro-toolbox"
}
JSON
