# nightflight
This is a very small library that leverages the astral package to calculate how
much of a flight occurs during regulatory night time (30 minutes after sunset to
30 minutes before sunrise).
This calculation is somewhat complicated because sunset and sunrise are a
function of location, and location is changing rapidly during a flight.
Positions and times during the flight are approximated by assuming that the
flight follows a great circle track between origin and destination and that
velocity is constant throughout.
The latter assumption is likely the greatest source of error, since average
velocity along the great circle track will be much lower during the initial and
terminal manoeuvring phases.
The assumption of great circle track may also be erroneous on very long
trips. If a trip starts on exactly opposite sides of the planet, there are an
infinite number of equally efficient tracks to choose from, so when the
situation is close to this, the actual track flown may end up being radically
different from that assumed.
The main function takes n_vectors (vectors normal to the tangent plane at a
given location) as arguments to avoid dealing with singularities. A database of
n_vectors for airfields as designated by their three letter IATA code is
included. This data is a processed version of the database generously provided
by openflights.org (see <https://openflights.org/data.html>). The `make_locations`
module has a `to_nvec` function to convert an arbitrary latitude and longitude
to an n_vector .
Raw data
{
"_id": null,
"home_page": "https://github.com/JonHurst/nightflight",
"name": "nightflight",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": null,
"author": "Jon Hurst",
"author_email": "jon.a@hursts.org.uk",
"download_url": "https://files.pythonhosted.org/packages/76/31/82bc71e3f3d1edaa9f8e8a632430253b7887a6639dc41cc916f647c09b06/nightflight-0.9.tar.gz",
"platform": null,
"description": "# nightflight\n\nThis is a very small library that leverages the astral package to calculate how\nmuch of a flight occurs during regulatory night time (30 minutes after sunset to\n30 minutes before sunrise).\n\nThis calculation is somewhat complicated because sunset and sunrise are a\nfunction of location, and location is changing rapidly during a flight.\n\nPositions and times during the flight are approximated by assuming that the\nflight follows a great circle track between origin and destination and that\nvelocity is constant throughout.\n\nThe latter assumption is likely the greatest source of error, since average\nvelocity along the great circle track will be much lower during the initial and\nterminal manoeuvring phases.\n\nThe assumption of great circle track may also be erroneous on very long\ntrips. If a trip starts on exactly opposite sides of the planet, there are an\ninfinite number of equally efficient tracks to choose from, so when the\nsituation is close to this, the actual track flown may end up being radically\ndifferent from that assumed.\n\nThe main function takes n_vectors (vectors normal to the tangent plane at a\ngiven location) as arguments to avoid dealing with singularities. A database of\nn_vectors for airfields as designated by their three letter IATA code is\nincluded. This data is a processed version of the database generously provided\nby openflights.org (see <https://openflights.org/data.html>). The `make_locations`\nmodule has a `to_nvec` function to convert an arbitrary latitude and longitude\nto an n_vector .\n",
"bugtrack_url": null,
"license": null,
"summary": "Calculate night flying hours",
"version": "0.9",
"project_urls": {
"Homepage": "https://github.com/JonHurst/nightflight"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "19ce946e4c6b6d9fca8d6757431701563d65ade525e03ffec97d6017a2e11a15",
"md5": "70b3f524339e7dcd448a7f4f218a4b8f",
"sha256": "4595701d2806d48c268c2ed7e2e8a97860f5dd774f8ee069b46da18cb8fff379"
},
"downloads": -1,
"filename": "nightflight-0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "70b3f524339e7dcd448a7f4f218a4b8f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 233489,
"upload_time": "2024-08-30T09:37:29",
"upload_time_iso_8601": "2024-08-30T09:37:29.224815Z",
"url": "https://files.pythonhosted.org/packages/19/ce/946e4c6b6d9fca8d6757431701563d65ade525e03ffec97d6017a2e11a15/nightflight-0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "763182bc71e3f3d1edaa9f8e8a632430253b7887a6639dc41cc916f647c09b06",
"md5": "171e5792a75a991b602b6fd57fa573df",
"sha256": "087606f32b475b4e325fe3c956551427f4c773aab856f2db834c3d1b08bf525c"
},
"downloads": -1,
"filename": "nightflight-0.9.tar.gz",
"has_sig": false,
"md5_digest": "171e5792a75a991b602b6fd57fa573df",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 235989,
"upload_time": "2024-08-30T09:37:30",
"upload_time_iso_8601": "2024-08-30T09:37:30.764865Z",
"url": "https://files.pythonhosted.org/packages/76/31/82bc71e3f3d1edaa9f8e8a632430253b7887a6639dc41cc916f647c09b06/nightflight-0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-30 09:37:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "JonHurst",
"github_project": "nightflight",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nightflight"
}
JSON
