{"id":35009981,"url":"https://github.com/antarctica/bas-air-unit-network-dataset","last_synced_at":"2026-05-19T12:07:04.254Z","repository":{"id":45659868,"uuid":"513907776","full_name":"antarctica/bas-air-unit-network-dataset","owner":"antarctica","description":"Management of the network of routes and waypoints used by the British Antarctic Survey (BAS) Air Unit.","archived":false,"fork":false,"pushed_at":"2024-12-11T21:08:26.000Z","size":3048,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-11-27T17:25:40.571Z","etag":null,"topics":["bas-magic","geospatial","geospatial-data","geospatial-processing","utility"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/antarctica.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-07-14T13:14:47.000Z","updated_at":"2025-03-29T16:40:20.000Z","dependencies_parsed_at":"2023-12-03T19:27:49.501Z","dependency_job_id":"844df918-0b1f-4033-9bf0-434f16d33b81","html_url":"https://github.com/antarctica/bas-air-unit-network-dataset","commit_stats":{"total_commits":108,"total_committers":1,"mean_commits":108.0,"dds":0.0,"last_synced_commit":"c555522e595f8eece27853f1844a0e52723f83c7"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/antarctica/bas-air-unit-network-dataset","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antarctica%2Fbas-air-unit-network-dataset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antarctica%2Fbas-air-unit-network-dataset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antarctica%2Fbas-air-unit-network-dataset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antarctica%2Fbas-air-unit-network-dataset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/antarctica","download_url":"https://codeload.github.com/antarctica/bas-air-unit-network-dataset/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antarctica%2Fbas-air-unit-network-dataset/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33215617,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-19T07:54:09.561Z","status":"ssl_error","status_checked_at":"2026-05-19T07:54:08.508Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bas-magic","geospatial","geospatial-data","geospatial-processing","utility"],"created_at":"2025-12-27T04:57:41.148Z","updated_at":"2026-05-19T12:07:04.250Z","avatar_url":"https://github.com/antarctica.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BAS Air Unit Network Dataset\n\nUtility to process routes and waypoints used by the British Antarctic Survey (BAS) Air Unit.\n\n## Overview\n\n**Note:** This project is focused on needs within the British Antarctic Survey. It has been open-sourced in case it is\nof interest to others. Some resources, indicated with a '🛡' or '🔒' symbol, can only be accessed by BAS staff or\nproject members respectively. Contact the [Project Maintainer](#project-maintainer) to request access.\n\n### Purpose\n\nTo support the BAS Air Unit manage their network of routes and waypoints such that:\n\n* information is internally consistent, through defined structures and constraints\n* information is interoperable between different systems, through the use of open/standard formats\n* information is well described and sharable with other teams, through distribution as datasets (through the \n  [Ops Data Store 🛡](https://gitlab.data.bas.ac.uk/MAGIC/ops-data-store))\n\n### Background\n\nThis project was developed in response to discussions and requests with the BAS Air Unit to review and simplify the \nprocess they used to manage their network of waypoints, and to ensure its future sustainability.\n\nBAS staff can read more about this background in this \n[GitLab issue 🛡](https://gitlab.data.bas.ac.uk/MAGIC/ops-support/-/issues/134).\n\n### Limitations\n\nThis service has a number of limitations, including:\n\n* the Air Unit Network utility does not support multiple, or additional, networks\n* the Air Unit Network utility does not require route names to follow the required naming convention\n* the Air Unit Network utility does not require waypoint identifiers to be unique across all waypoints\n* the Air Unit Network utility does not require waypoint comments to follow the required GPX comment structure\n* the Air Unit Network utility does not require waypoints within imported routes to be listed as standalone waypoints\n* comments for waypoints use an overly complex structure to support an ad-hoc serialisation format within GPX files\n* Unicode characters (such as emoji) are unsupported in route/waypoint names, comments, etc.\n\nSome or all of these limitations may be addressed in future improvements to this project. See the project \n[issue tracker 🛡](https://gitlab.data.bas.ac.uk/MAGIC/ops-data-store/-/issues) for details.\n\n## Install\n\n```\n$ python -m pip install bas-air-unit-network-dataset\n```\n\n## Usage\n\n### Loading features from GPX files\n\nIf loading waypoints and routes from a GPX file, these requirements must be met in addition to the constraints from the \n[Information Model](IMPLEMENTATION.md#information-model):\n\n- the GPX comment field should consist of 8 elements, in the order below, separated with a vertical bar (`|`):\n  - *name*: a full, or formal name for the waypoint (maximum 17 characters)\n  - *co-located with*: name of a related depot, instrument and/or other feature - use `N/A` if not applicable\n  - *last accessed at*: date waypoint was last accessed in the form `YYYY-MM-DD` - use `N/A` if unvisited\n  - *last accessed by*: pilot that that last accessed waypoint - use `N/A` if unvisited\n  - *fuel*: amount of fuel at a waypoint, as a positive whole number - use `N/A` if not applicable\n  - *elevation_ft*: elevation at waypoint, as a positive whole number - use `N/A` if not applicable\n  - *comment*: any other information - use `N/A` if not applicable\n  - *category*: a grouping value - use `N/A` if not applicable\n\nFor example (a co-located, previously visited, waypoint with a full name, additional information and a category):\n\n* identifier: `ALPHA`\n* comment: `Alpha 001 | Dog | 2014-12-24 | CW | 10 | 130 | Bring treats. | Animals`\n\nFor example (a standalone, unvisited, waypoint with no full/formal name or additional information):\n\n* identifier: `BRAVO`\n* comment: `N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A`\n\n**Note:** Only the 'name' in a comment will be included in FPL waypoints.\n\n### Creating outputs\n\nSee the [`tests/create_outputs.py`](tests/create_outputs.py) for an example of converting a set of input waypoints and \nroutes into output formats, creating an [Output Directory](#output-directory), using an instance of the \n`MainAirUnitNetwork` class.\n\nThe `Network` class (on which the `MainAirUnitNetwork` class is based) includes a built-in method for loading features \nfrom a GPX file (used in the example above). To load data from other data sources, construct `Waypoint` and `Route` \nfeatures directly and add to a `Network` object.\n\n### Output directory\n\nWhen using the `MainAirUnitNetwork` class from this project to process waypoints and routes, an output directory \nsimilar to the example below will be created:\n\n```\n/path/to/output/directory\n├── CSV\n│   ├── 00_WAYPOINTS_DDM_2023_12_03.csv\n│   └── 00_WAYPOINTS_DD_2023_12_03.csv\n├── FPL\n│   ├── 00_NETWORK_2023_12_03.fpl\n│   ├── 01_BRAVO_TO_ALPHA.fpl\n│   ├── 02_BRAVO_TO_BRAVO.fpl\n│   └── 03_BRAVO_TO_LIMA.fpl\n├── GPX\n│   ├── 00_NETWORK_2023_12_03.gpx\n└── PDF\n    └── 00_WAYPOINTS_2023_12_03.pdf\n```\n\n#### Access control\n\nThe Air Unit Network utility does not include access control. If needed, access controls should be applied to the\noutput directory, as is the case for the [Ops Data Store 🛡](https://gitlab.data.bas.ac.uk/MAGIC/ops-data-store) for \nexample.\n\n## Implementation\n\nSee [Implementation](IMPLEMENTATION.md) documentation.\n\n## Developing\n\nSee [Developing](DEVELOPING.md) documentation.\n\n## Releases\n\n- [all releases 🛡](https://gitlab.data.bas.ac.uk/MAGIC/air-unit-network-dataset/-/releases)\n- [latest release 🛡](https://gitlab.data.bas.ac.uk/MAGIC/air-unit-network-dataset/-/releases/permalink/latest)\n- [PyPi](https://pypi.org/project/bas-air-unit-network-dataset/)\n\n## Project maintainer\n\nBritish Antarctic Survey ([BAS](https://www.bas.ac.uk)) Mapping and Geographic Information Centre\n([MAGIC](https://www.bas.ac.uk/teams/magic)). Contact [magic@bas.ac.uk](mailto:magic@bas.ac.uk).\n\nThe project lead is [@felnne](https://www.bas.ac.uk/profile/felnne).\n\n## License\n\nCopyright (c) 2022 - 2024 UK Research and Innovation (UKRI), British Antarctic Survey (BAS).\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantarctica%2Fbas-air-unit-network-dataset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantarctica%2Fbas-air-unit-network-dataset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantarctica%2Fbas-air-unit-network-dataset/lists"}