tess-ephem
==========
**Where are Solar System objects located in TESS FFI data?**
|pypi| |pytest| |black| |flake8| |mypy|
.. |pypi| image:: https://img.shields.io/pypi/v/tess-ephem
:target: https://pypi.python.org/pypi/tess-ephem
.. |pytest| image:: https://github.com/SSDataLab/tess-ephem/workflows/pytest/badge.svg
.. |black| image:: https://github.com/SSDataLab/tess-ephem/workflows/black/badge.svg
.. |flake8| image:: https://github.com/SSDataLab/tess-ephem/workflows/flake8/badge.svg
.. |mypy| image:: https://github.com/SSDataLab/tess-ephem/workflows/mypy/badge.svg
`tess-ephem` is a user-friendly package which enables users to compute the positions of Solar System objects -- asteroids, comets, and planets --
in the data archive of NASA's TESS Space Telescope.
Installation
------------
.. code-block:: bash
python -m pip install tess-ephem
Example use
-----------
tess-ephem allows you to search the entire archive of TESS FFI's for the presence
of a known minor planet, and obtain the result as a Pandas DataFrame.
For example:
.. code-block:: python
>>> from tess_ephem import ephem
>>> ephem("Sedna")
sector camera ccd column row
time
2018-11-16 00:00:00.000 5 1 4 1543.312296 1102.821559
2018-11-17 00:00:00.000 5 1 4 1545.160910 1102.880825
2018-11-18 00:00:00.000 5 1 4 1547.011351 1102.934375
...
2018-12-09 00:00:00.000 5 1 4 1584.585407 1102.239292
2018-12-10 00:00:00.000 5 1 4 1586.245261 1102.132304
2018-12-11 00:00:00.000 5 1 4 1587.906380 1102.012091
You can also obtain the ephemeris for one or more specific times
by passing the `time` parameter:
.. code-block:: python
>>> ephem("Sedna", time="2018-11-21 17:35:00")
sector camera ccd column row
time
2018-11-21 17:35:00.000 5 1 4 1553.887838 1103.048431
Additional physical parameters can be obtained by passing the `verbose=True` parameter:
.. code-block:: python
>>> ephem("Sedna", time="2018-11-21 17:35:00", verbose=True)
sector camera ccd column row pixels_per_hour ra dec vmag sun_distance obs_distance phase_angle
time
2018-11-21 17:35:00.000 5 1 4 1553.887838 1103.048431 0.074054 57.05786 7.63721 20.612 84.942885 83.975689 0.1419
Raw data
{
"_id": null,
"home_page": "https://github.com/SSDataLab/tess-ephem",
"name": "tess-ephem",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "NASA, TESS, Astronomy",
"author": "Geert Barentsen",
"author_email": "hello@geert.io",
"download_url": "https://files.pythonhosted.org/packages/78/01/faf02456d678ee517efb313ef38fd5263b2cdc7e0ff1625adecd7008ffcd/tess_ephem-0.4.0.tar.gz",
"platform": null,
"description": "tess-ephem\n==========\n\n\n**Where are Solar System objects located in TESS FFI data?**\n\n|pypi| |pytest| |black| |flake8| |mypy|\n\n.. |pypi| image:: https://img.shields.io/pypi/v/tess-ephem\n :target: https://pypi.python.org/pypi/tess-ephem\n.. |pytest| image:: https://github.com/SSDataLab/tess-ephem/workflows/pytest/badge.svg\n.. |black| image:: https://github.com/SSDataLab/tess-ephem/workflows/black/badge.svg\n.. |flake8| image:: https://github.com/SSDataLab/tess-ephem/workflows/flake8/badge.svg\n.. |mypy| image:: https://github.com/SSDataLab/tess-ephem/workflows/mypy/badge.svg\n\n`tess-ephem` is a user-friendly package which enables users to compute the positions of Solar System objects -- asteroids, comets, and planets --\nin the data archive of NASA's TESS Space Telescope.\n\nInstallation\n------------\n\n.. code-block:: bash\n\n python -m pip install tess-ephem\n\n\nExample use\n-----------\n\ntess-ephem allows you to search the entire archive of TESS FFI's for the presence\nof a known minor planet, and obtain the result as a Pandas DataFrame.\nFor example:\n\n.. code-block:: python\n\n >>> from tess_ephem import ephem\n >>> ephem(\"Sedna\")\n sector camera ccd column row\n time\n 2018-11-16 00:00:00.000 5 1 4 1543.312296 1102.821559\n 2018-11-17 00:00:00.000 5 1 4 1545.160910 1102.880825\n 2018-11-18 00:00:00.000 5 1 4 1547.011351 1102.934375\n ...\n 2018-12-09 00:00:00.000 5 1 4 1584.585407 1102.239292\n 2018-12-10 00:00:00.000 5 1 4 1586.245261 1102.132304\n 2018-12-11 00:00:00.000 5 1 4 1587.906380 1102.012091\n\n\nYou can also obtain the ephemeris for one or more specific times\nby passing the `time` parameter:\n\n.. code-block:: python\n\n >>> ephem(\"Sedna\", time=\"2018-11-21 17:35:00\")\n sector camera ccd column row\n time\n 2018-11-21 17:35:00.000 5 1 4 1553.887838 1103.048431\n\n\nAdditional physical parameters can be obtained by passing the `verbose=True` parameter:\n\n.. code-block:: python\n\n >>> ephem(\"Sedna\", time=\"2018-11-21 17:35:00\", verbose=True)\n sector camera ccd column row pixels_per_hour ra dec vmag sun_distance obs_distance phase_angle\n time\n 2018-11-21 17:35:00.000 5 1 4 1553.887838 1103.048431 0.074054 57.05786 7.63721 20.612 84.942885 83.975689 0.1419\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Where are Solar System objects located in TESS FFI data?",
"version": "0.4.0",
"project_urls": {
"Homepage": "https://github.com/SSDataLab/tess-ephem",
"Repository": "https://github.com/SSDataLab/tess-ephem"
},
"split_keywords": [
"nasa",
" tess",
" astronomy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cbc9031401744c4947e7f1e38e82acf4e56b372250e48a7872e412ae4d0720d0",
"md5": "493404c8a20666db83fc0bd46d7285aa",
"sha256": "2e88d5bfbafa557593b03cd8d8370511b4aabc5b7f4fdfa8fd7a2d2f2a2338c4"
},
"downloads": -1,
"filename": "tess_ephem-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "493404c8a20666db83fc0bd46d7285aa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 6310,
"upload_time": "2023-12-08T03:51:42",
"upload_time_iso_8601": "2023-12-08T03:51:42.859551Z",
"url": "https://files.pythonhosted.org/packages/cb/c9/031401744c4947e7f1e38e82acf4e56b372250e48a7872e412ae4d0720d0/tess_ephem-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7801faf02456d678ee517efb313ef38fd5263b2cdc7e0ff1625adecd7008ffcd",
"md5": "2d34fb93661cbf1b028ae416ec148129",
"sha256": "e867681b842c9ea266bf2ebbc7781f94dc8bac34a78f387dd8d56057ffbf84b4"
},
"downloads": -1,
"filename": "tess_ephem-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "2d34fb93661cbf1b028ae416ec148129",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 5594,
"upload_time": "2023-12-08T03:51:44",
"upload_time_iso_8601": "2023-12-08T03:51:44.531280Z",
"url": "https://files.pythonhosted.org/packages/78/01/faf02456d678ee517efb313ef38fd5263b2cdc7e0ff1625adecd7008ffcd/tess_ephem-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-08 03:51:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SSDataLab",
"github_project": "tess-ephem",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tess-ephem"
}
JSON
