# ewia
[](https://travis-ci.com/johndoe31415/ewia)
Ewia is a tool to calculate the apparent sky position (i.e., azimuth and
elevation) of astronomical objects such as stars or planets. It's an ancient
project of mine (dates back to 2009) and was almost completely rewritten in
2017. It's quite easy to use:
```
usage: ewia [-h] [--json] [-c filename] [--no-system-catalog] -l location
[-t timestamp] [-z tzone]
object [object ...]
positional arguments:
object Object under observation. Must refer to the catalog.
optional arguments:
-h, --help show this help message and exit
--json Output data in JSON format.
-c filename, --user-catalog filename
Specifies user catalogs to read after system catalogs
have been read.
--no-system-catalog Do not read system catalogs (by default,
~/.config/ewia/catalog.json and ./.catalog.json are
tried)
-l location, --observer-location location
Observer location on earth. Can be either a reference
to the catalog or actual coordinates.
-t timestamp, --observation-time timestamp
Time at which the observation is conducted. Accepts
the special argument 'now', which reflects the current
time. Otherwise, must be in format YYYY-mm-dd
HH:MM:SS.
-z tzone, --observation-timezone tzone
When a timestamp is given, this parameter influences
at which timezone the timestamp is interpreted to be
in. Can either be a timezone definition such as
'Europe/Berlin' or a static timezone such as 'utc' or
'Etc/GMT+8'. Alternatively, can be set to 'auto' in
order to take the timezone that has been specified in
the catalog for the observing location. Defaults to
auto.
```
Catalogs are given in JSON format and an example is included in the
.catalog.json file. You can easily dump positions of objects:
```
$ ./ewia -l Böblingen Saturn
Observer location: Böblingen (N48°41′16″, E9°0′17″), at time 2017-08-16 22:40:42 (Europe/Berlin)
Saturn: Altitude 16.1°, Azimuth 203.4° (SSW)
```
...or more objects at once...
```
$ ./ewia -l Böblingen Saturn Jupiter Venus Mars "Helix Nebula"
Observer location: Böblingen (N48°41′16″, E9°0′17″), at time 2017-08-16 22:41:18 (Europe/Berlin)
Saturn: Altitude 16.1°, Azimuth 203.6° (SSW)
Jupiter: Altitude -2.5°, Azimuth 263.0° (W)
Venus: Altitude -19.6°, Azimuth 354.7° (N)
Mars: Altitude -17.4°, Azimuth 324.6° (NW)
Helix Nebula: Altitude 6.2°, Azimuth 131.7° (SE)
```
and also of course dump everything as JSON:
```
$ ./ewia -l Bamberg --json M17
{'observer': {'lat': 49.884559, 'lon': 10.888149, 'tz': 'Europe/Berlin'},
'timezone': 'Europe/Berlin', 'timestamps': [{'timet': 1535186887, 'ts_utc':
'2018-08-25 08:48:07', 'ts_local': '2018-08-25 10:48:07'}], 'observations':
[{'obj_name': 'M17', 'positions': [{'apparent': {'altitide': {'deg':
-52.158318500088335, 'pretty': '-52°9′30″'}, 'azimuth': {'deg':
34.639970963487116, 'pretty': '+34°38′24″'}}, 'equatorial': {'ra': {'hrs':
18.346666666666668, 'deg': 275.2, 'pretty': '18:20:48'}, 'dec': {'deg':
-16.183333333333334, 'pretty': '-16°11′0″'}}}]}]}
```
It can also calculate the position of the sun:
```
./ewia -l Böblingen Sol
Observer location: Böblingen (N48°41′16″, E9°0′17″), at time 2018-08-25 10:48:43 (Europe/Berlin)
Sol: Altitude 39.9°, Azimuth 125.7° (SE)
```
# Author and License
Ewia was written by Johannes Bauer <JohannesBauer@gmx.de> and is released under
the terms of the GNU General Public License v2 (included in the LICENSE file).
Raw data
{
"_id": null,
"home_page": "https://github.com/johndoe31415/ewia",
"name": "ewia",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "astrophysics, calculator, position, deep-sky, ephemeris, planets",
"author": "Johannes Bauer",
"author_email": "joe@johannes-bauer.com",
"download_url": "https://files.pythonhosted.org/packages/ec/6e/aaac66071e52900d65054555429db50e9722e671e8c8a125e7e7b0e65859/ewia-0.0.2.tar.gz",
"platform": null,
"description": "# ewia\n[](https://travis-ci.com/johndoe31415/ewia)\n\nEwia is a tool to calculate the apparent sky position (i.e., azimuth and\nelevation) of astronomical objects such as stars or planets. It's an ancient\nproject of mine (dates back to 2009) and was almost completely rewritten in\n2017. It's quite easy to use:\n\n```\nusage: ewia [-h] [--json] [-c filename] [--no-system-catalog] -l location\n [-t timestamp] [-z tzone]\n object [object ...]\n\npositional arguments:\n object Object under observation. Must refer to the catalog.\n\noptional arguments:\n -h, --help show this help message and exit\n --json Output data in JSON format.\n -c filename, --user-catalog filename\n Specifies user catalogs to read after system catalogs\n have been read.\n --no-system-catalog Do not read system catalogs (by default,\n ~/.config/ewia/catalog.json and ./.catalog.json are\n tried)\n -l location, --observer-location location\n Observer location on earth. Can be either a reference\n to the catalog or actual coordinates.\n -t timestamp, --observation-time timestamp\n Time at which the observation is conducted. Accepts\n the special argument 'now', which reflects the current\n time. Otherwise, must be in format YYYY-mm-dd\n HH:MM:SS.\n -z tzone, --observation-timezone tzone\n When a timestamp is given, this parameter influences\n at which timezone the timestamp is interpreted to be\n in. Can either be a timezone definition such as\n 'Europe/Berlin' or a static timezone such as 'utc' or\n 'Etc/GMT+8'. Alternatively, can be set to 'auto' in\n order to take the timezone that has been specified in\n the catalog for the observing location. Defaults to\n auto.\n```\n\nCatalogs are given in JSON format and an example is included in the\n.catalog.json file. You can easily dump positions of objects:\n\n```\n$ ./ewia -l B\u00f6blingen Saturn\nObserver location: B\u00f6blingen (N48\u00b041\u203216\u2033, E9\u00b00\u203217\u2033), at time 2017-08-16 22:40:42 (Europe/Berlin)\n Saturn: Altitude 16.1\u00b0, Azimuth 203.4\u00b0 (SSW)\n```\n\n...or more objects at once...\n\n```\n$ ./ewia -l B\u00f6blingen Saturn Jupiter Venus Mars \"Helix Nebula\"\nObserver location: B\u00f6blingen (N48\u00b041\u203216\u2033, E9\u00b00\u203217\u2033), at time 2017-08-16 22:41:18 (Europe/Berlin)\n Saturn: Altitude 16.1\u00b0, Azimuth 203.6\u00b0 (SSW)\n Jupiter: Altitude -2.5\u00b0, Azimuth 263.0\u00b0 (W)\n Venus: Altitude -19.6\u00b0, Azimuth 354.7\u00b0 (N)\n Mars: Altitude -17.4\u00b0, Azimuth 324.6\u00b0 (NW)\n Helix Nebula: Altitude 6.2\u00b0, Azimuth 131.7\u00b0 (SE)\n```\n\nand also of course dump everything as JSON:\n\n```\n$ ./ewia -l Bamberg --json M17\n{'observer': {'lat': 49.884559, 'lon': 10.888149, 'tz': 'Europe/Berlin'},\n'timezone': 'Europe/Berlin', 'timestamps': [{'timet': 1535186887, 'ts_utc':\n'2018-08-25 08:48:07', 'ts_local': '2018-08-25 10:48:07'}], 'observations':\n[{'obj_name': 'M17', 'positions': [{'apparent': {'altitide': {'deg':\n-52.158318500088335, 'pretty': '-52\u00b09\u203230\u2033'}, 'azimuth': {'deg':\n34.639970963487116, 'pretty': '+34\u00b038\u203224\u2033'}}, 'equatorial': {'ra': {'hrs':\n18.346666666666668, 'deg': 275.2, 'pretty': '18:20:48'}, 'dec': {'deg':\n-16.183333333333334, 'pretty': '-16\u00b011\u20320\u2033'}}}]}]}\n```\n\nIt can also calculate the position of the sun:\n\n```\n./ewia -l B\u00f6blingen Sol\nObserver location: B\u00f6blingen (N48\u00b041\u203216\u2033, E9\u00b00\u203217\u2033), at time 2018-08-25 10:48:43 (Europe/Berlin)\n Sol: Altitude 39.9\u00b0, Azimuth 125.7\u00b0 (SE)\n```\n\n# Author and License\nEwia was written by Johannes Bauer <JohannesBauer@gmx.de> and is released under\nthe terms of the GNU General Public License v2 (included in the LICENSE file).\n",
"bugtrack_url": null,
"license": "gpl-3.0",
"summary": "A library to calculate astrophysical object positions",
"version": "0.0.2",
"project_urls": {
"Download": "https://github.com/johndoe31415/ewia/archive/v0.0.2.tar.gz",
"Homepage": "https://github.com/johndoe31415/ewia"
},
"split_keywords": [
"astrophysics",
" calculator",
" position",
" deep-sky",
" ephemeris",
" planets"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec6eaaac66071e52900d65054555429db50e9722e671e8c8a125e7e7b0e65859",
"md5": "390f9ac41bc19e09dcb44335fb511e46",
"sha256": "56142fd9e1dcf6ec79db92d8672ba3be984f062a91c7cd39eb369a7fe612249d"
},
"downloads": -1,
"filename": "ewia-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "390f9ac41bc19e09dcb44335fb511e46",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23051,
"upload_time": "2024-08-07T11:37:20",
"upload_time_iso_8601": "2024-08-07T11:37:20.644998Z",
"url": "https://files.pythonhosted.org/packages/ec/6e/aaac66071e52900d65054555429db50e9722e671e8c8a125e7e7b0e65859/ewia-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-07 11:37:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "johndoe31415",
"github_project": "ewia",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "ewia"
}
JSON
