aeronavx 0.3.1__tar.gz

aeronavx-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Tefik Yildiz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aeronavx-0.3.1/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: aeronavx
+Version: 0.3.1
+Summary: Production-grade airport data and flight geometry library
+Author-email: Teyfik OZ <teyfikoz@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/teyfikoz/AeroNavX
+Project-URL: Repository, https://github.com/teyfikoz/AeroNavX
+Project-URL: Documentation, https://github.com/teyfikoz/AeroNavX/docs
+Project-URL: Issues, https://github.com/teyfikoz/AeroNavX/issues
+Keywords: airport,aviation,geodesy,geography,distance,routing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: full
+Requires-Dist: pandas>=2.0; extra == "full"
+Requires-Dist: scipy>=1.10; extra == "full"
+Requires-Dist: rapidfuzz>=3.0; extra == "full"
+Requires-Dist: timezonefinder>=6.0; extra == "full"
+Requires-Dist: requests>=2.31; extra == "full"
+Provides-Extra: api
+Requires-Dist: fastapi>=0.104; extra == "api"
+Requires-Dist: uvicorn[standard]>=0.24; extra == "api"
+Provides-Extra: all
+Requires-Dist: pandas>=2.0; extra == "all"
+Requires-Dist: scipy>=1.10; extra == "all"
+Requires-Dist: rapidfuzz>=3.0; extra == "all"
+Requires-Dist: timezonefinder>=6.0; extra == "all"
+Requires-Dist: requests>=2.31; extra == "all"
+Requires-Dist: fastapi>=0.104; extra == "all"
+Requires-Dist: uvicorn[standard]>=0.24; extra == "all"
+Dynamic: license-file
+
+# AeroNavX
+
+A production-grade Python library for airport data and flight geometry calculations.
+
+**🆕 v0.2.0:** Now with **84,000+ airports** from [OurAirports](https://ourairports.com) (MIT License)
+
+## Features
+
+- 🛫 **Airport Database**: 84,000+ global airports with efficient IATA/ICAO indexing
+- 📏 **Distance Calculations**: Haversine, Vincenty, and Spherical Law of Cosines
+- 🌍 **Geodesy**: Bearings, midpoints, great circle paths
+- 🔍 **Search**: Fuzzy name search, nearest neighbor queries, radius search
+- 🛤️ **Routing**: Multi-segment routes, flight time estimation, shortest paths
+- 📊 **Analytics**: Statistics by country, continent, type, and elevation
+- ⏰ **Timezone Support**: Automatic timezone detection and local time
+- 🌱 **Emissions**: CO2 emissions estimation per passenger
+- 🌤️ **Weather**: METAR and TAF data fetching
+- 💻 **CLI**: Command-line interface for quick queries
+- 🌐 **REST API**: FastAPI-based web service
+
+## Installation
+
+```bash
+pip install aeronavx
+```
+
+**Or from source:**
+```bash
+git clone https://github.com/teyfikoz/AeroNavX.git
+cd AeroNavX
+pip install -e .
+```
+
+## Quick Start
+
+```python
+import aeronavx
+
+# Get airports
+ist = aeronavx.get_airport("IST")
+jfk = aeronavx.get_airport("JFK")
+
+# Calculate distance
+dist_km = ist.distance_to(jfk)
+print(f"Distance: {dist_km:.2f} km")
+
+# Find nearest airports
+nearest = aeronavx.nearest_airport(41.0, 29.0, n=5)
+
+# Estimate emissions
+co2 = aeronavx.estimate_co2_kg_for_segment("IST", "JFK")
+print(f"CO2: {co2:.2f} kg per passenger")
+```
+
+### Advanced: Filtering Airports
+
+```python
+from aeronavx.core import loader
+
+# Load only major airports (large + medium with scheduled service)
+major_airports = loader.load_airports(
+    include_types=['large_airport', 'medium_airport'],
+    scheduled_service_only=True
+)
+print(f"Major airports: {len(major_airports):,}")  # ~3,200
+
+# Load specific countries
+us_airports = loader.load_airports(countries=['US'])
+print(f"US airports: {len(us_airports):,}")  # ~20,000
+
+# Load airports with IATA codes only
+iata_airports = loader.load_airports(has_iata_only=True)
+print(f"IATA airports: {len(iata_airports):,}")  # ~9,000
+```
+
+## CLI Usage
+
+```bash
+# Calculate distance
+aeronavx distance --from IST --to JFK --unit nmi
+
+# Find nearest airports
+aeronavx nearest --lat 41.0 --lon 29.0 --n 5
+
+# Search by name
+aeronavx search --name "Heathrow"
+
+# Estimate emissions
+aeronavx emissions --from IST --to LHR
+
+# Flight time
+aeronavx flight-time --from IST --to JFK
+```
+
+## API Server
+
+```bash
+python -m aeronavx.api.server
+```
+
+Then access:
+- http://localhost:8000/health
+- http://localhost:8000/airport/IST
+- http://localhost:8000/distance?from=IST&to=JFK
+- http://localhost:8000/nearest?lat=41.0&lon=29.0&n=5
+
+## Data
+
+AeroNavX includes **84,000+ airports** from [OurAirports](https://ourairports.com/data/), which provides:
+- ✅ **Global Coverage**: Airports, heliports, seaplane bases, and more
+- ✅ **MIT License**: Free to use commercially
+- ✅ **Regular Updates**: Community-maintained and updated
+- ✅ **Comprehensive Data**: IATA/ICAO codes, coordinates, types, and more
+
+**Data Attribution:**
+Airport data from [OurAirports](https://ourairports.com) (David Megginson et al.) - Licensed under [MIT License](https://github.com/davidmegginson/ourairports-data)
+
+## Examples
+
+See `examples/` directory for:
+- `basic_distance.py`: Distance calculations
+- `nearest_airports.py`: Finding nearby airports
+- `routing_example.py`: Multi-segment routes
+- `emissions_example.py`: CO2 estimation
+
+## Testing
+
+```bash
+pytest
+```
+
+## Dependencies
+
+**Required**: Python >= 3.10
+
+**Optional**:
+- `pandas`: DataFrame support
+- `scipy`: Faster spatial indexing
+- `rapidfuzz`: Better fuzzy search
+- `timezonefinder`: Timezone support
+- `fastapi`, `uvicorn`: API server
+- `requests`: Weather data
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions welcome! Please open an issue or pull request.

aeronavx-0.3.1/README.md

@@ -0,0 +1,150 @@
+# AeroNavX
+
+A production-grade Python library for airport data and flight geometry calculations.
+
+**🆕 v0.2.0:** Now with **84,000+ airports** from [OurAirports](https://ourairports.com) (MIT License)
+
+## Features
+
+- 🛫 **Airport Database**: 84,000+ global airports with efficient IATA/ICAO indexing
+- 📏 **Distance Calculations**: Haversine, Vincenty, and Spherical Law of Cosines
+- 🌍 **Geodesy**: Bearings, midpoints, great circle paths
+- 🔍 **Search**: Fuzzy name search, nearest neighbor queries, radius search
+- 🛤️ **Routing**: Multi-segment routes, flight time estimation, shortest paths
+- 📊 **Analytics**: Statistics by country, continent, type, and elevation
+- ⏰ **Timezone Support**: Automatic timezone detection and local time
+- 🌱 **Emissions**: CO2 emissions estimation per passenger
+- 🌤️ **Weather**: METAR and TAF data fetching
+- 💻 **CLI**: Command-line interface for quick queries
+- 🌐 **REST API**: FastAPI-based web service
+
+## Installation
+
+```bash
+pip install aeronavx
+```
+
+**Or from source:**
+```bash
+git clone https://github.com/teyfikoz/AeroNavX.git
+cd AeroNavX
+pip install -e .
+```
+
+## Quick Start
+
+```python
+import aeronavx
+
+# Get airports
+ist = aeronavx.get_airport("IST")
+jfk = aeronavx.get_airport("JFK")
+
+# Calculate distance
+dist_km = ist.distance_to(jfk)
+print(f"Distance: {dist_km:.2f} km")
+
+# Find nearest airports
+nearest = aeronavx.nearest_airport(41.0, 29.0, n=5)
+
+# Estimate emissions
+co2 = aeronavx.estimate_co2_kg_for_segment("IST", "JFK")
+print(f"CO2: {co2:.2f} kg per passenger")
+```
+
+### Advanced: Filtering Airports
+
+```python
+from aeronavx.core import loader
+
+# Load only major airports (large + medium with scheduled service)
+major_airports = loader.load_airports(
+    include_types=['large_airport', 'medium_airport'],
+    scheduled_service_only=True
+)
+print(f"Major airports: {len(major_airports):,}")  # ~3,200
+
+# Load specific countries
+us_airports = loader.load_airports(countries=['US'])
+print(f"US airports: {len(us_airports):,}")  # ~20,000
+
+# Load airports with IATA codes only
+iata_airports = loader.load_airports(has_iata_only=True)
+print(f"IATA airports: {len(iata_airports):,}")  # ~9,000
+```
+
+## CLI Usage
+
+```bash
+# Calculate distance
+aeronavx distance --from IST --to JFK --unit nmi
+
+# Find nearest airports
+aeronavx nearest --lat 41.0 --lon 29.0 --n 5
+
+# Search by name
+aeronavx search --name "Heathrow"
+
+# Estimate emissions
+aeronavx emissions --from IST --to LHR
+
+# Flight time
+aeronavx flight-time --from IST --to JFK
+```
+
+## API Server
+
+```bash
+python -m aeronavx.api.server
+```
+
+Then access:
+- http://localhost:8000/health
+- http://localhost:8000/airport/IST
+- http://localhost:8000/distance?from=IST&to=JFK
+- http://localhost:8000/nearest?lat=41.0&lon=29.0&n=5
+
+## Data
+
+AeroNavX includes **84,000+ airports** from [OurAirports](https://ourairports.com/data/), which provides:
+- ✅ **Global Coverage**: Airports, heliports, seaplane bases, and more
+- ✅ **MIT License**: Free to use commercially
+- ✅ **Regular Updates**: Community-maintained and updated
+- ✅ **Comprehensive Data**: IATA/ICAO codes, coordinates, types, and more
+
+**Data Attribution:**
+Airport data from [OurAirports](https://ourairports.com) (David Megginson et al.) - Licensed under [MIT License](https://github.com/davidmegginson/ourairports-data)
+
+## Examples
+
+See `examples/` directory for:
+- `basic_distance.py`: Distance calculations
+- `nearest_airports.py`: Finding nearby airports
+- `routing_example.py`: Multi-segment routes
+- `emissions_example.py`: CO2 estimation
+
+## Testing
+
+```bash
+pytest
+```
+
+## Dependencies
+
+**Required**: Python >= 3.10
+
+**Optional**:
+- `pandas`: DataFrame support
+- `scipy`: Faster spatial indexing
+- `rapidfuzz`: Better fuzzy search
+- `timezonefinder`: Timezone support
+- `fastapi`, `uvicorn`: API server
+- `requests`: Weather data
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions welcome! Please open an issue or pull request.

aeronavx-0.3.1/aeronavx/__init__.py

@@ -0,0 +1,69 @@
+from .models import Airport, Runway
+from .core.airports import get as get_airport, get_by_iata, get_by_icao, search_by_name as search_airports_by_name
+from .core.distance import distance, distance_km, distance_mi, distance_nmi
+from .core.geodesy import initial_bearing, midpoint, great_circle_path
+from .core.search import nearest_airport, nearest_airports, airports_within_radius
+from .core.routing import estimate_flight_time_hours as estimate_flight_time, route_distance
+from .core.emissions import estimate_co2_kg_by_codes as estimate_co2_kg_for_segment
+from .core.weather import get_metar, get_taf
+from .core.runways import (
+    get_runways_by_airport,
+    get_longest_runway,
+    get_paved_runways,
+)
+from .core.statistics import (
+    get_country_stats,
+    get_continent_stats,
+    get_global_stats,
+    get_top_countries_by_airports,
+    get_top_countries_by_large_airports,
+)
+from .exceptions import (
+    AeroNavXError,
+    AirportNotFoundError,
+    InvalidAirportCodeError,
+    DataLoadError,
+    RoutingError,
+    WeatherDataError,
+)
+
+
+__version__ = "0.3.1"
+
+__all__ = [
+    "Airport",
+    "Runway",
+    "get_airport",
+    "get_by_iata",
+    "get_by_icao",
+    "distance",
+    "distance_km",
+    "distance_mi",
+    "distance_nmi",
+    "initial_bearing",
+    "midpoint",
+    "great_circle_path",
+    "nearest_airport",
+    "nearest_airports",
+    "airports_within_radius",
+    "estimate_flight_time",
+    "route_distance",
+    "estimate_co2_kg_for_segment",
+    "search_airports_by_name",
+    "get_metar",
+    "get_taf",
+    "get_runways_by_airport",
+    "get_longest_runway",
+    "get_paved_runways",
+    "get_country_stats",
+    "get_continent_stats",
+    "get_global_stats",
+    "get_top_countries_by_airports",
+    "get_top_countries_by_large_airports",
+    "AeroNavXError",
+    "AirportNotFoundError",
+    "InvalidAirportCodeError",
+    "DataLoadError",
+    "RoutingError",
+    "WeatherDataError",
+]

aeronavx-0.3.1/aeronavx/api/__init__.py

@@ -0,0 +1,3 @@
+from .server import app, run_server
+
+__all__ = ["app", "run_server"]

aeronavx-0.3.1/aeronavx/api/server.py

@@ -0,0 +1,180 @@
+from typing import Optional
+from fastapi import FastAPI, HTTPException, Query
+from fastapi.responses import JSONResponse
+
+from ..core.airports import get
+from ..core.distance import distance
+from ..core.search import nearest_airports, search_airports_by_name
+from ..core.routing import estimate_flight_time_hours
+from ..core.emissions import estimate_co2_kg_by_codes
+from ..exceptions import AeroNavXError
+
+
+app = FastAPI(
+    title="AeroNavX API",
+    description="Airport and flight geometry utilities",
+    version="0.1.0"
+)
+
+
+@app.get("/health")
+async def health():
+    return {"status": "ok", "service": "AeroNavX API"}
+
+
+@app.get("/airport/{code}")
+async def get_airport(
+    code: str,
+    code_type: str = Query("auto", regex="^(iata|icao|auto)$")
+):
+    try:
+        airport = get(code, code_type=code_type)
+
+        if airport is None:
+            raise HTTPException(status_code=404, detail=f"Airport not found: {code}")
+
+        return airport.as_dict()
+
+    except AeroNavXError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@app.get("/distance")
+async def calculate_distance(
+    from_code: str = Query(..., alias="from"),
+    to_code: str = Query(..., alias="to"),
+    code_type: str = Query("auto", regex="^(iata|icao|auto)$"),
+    model: str = Query("haversine", regex="^(haversine|slc|vincenty)$"),
+    unit: str = Query("km", regex="^(km|mi|nmi)$")
+):
+    try:
+        from_airport = get(from_code, code_type=code_type)
+        to_airport = get(to_code, code_type=code_type)
+
+        if from_airport is None:
+            raise HTTPException(status_code=404, detail=f"Origin airport not found: {from_code}")
+
+        if to_airport is None:
+            raise HTTPException(status_code=404, detail=f"Destination airport not found: {to_code}")
+
+        dist = distance(
+            from_airport.latitude_deg,
+            from_airport.longitude_deg,
+            to_airport.latitude_deg,
+            to_airport.longitude_deg,
+            model=model,
+            unit=unit
+        )
+
+        return {
+            "from": from_airport.as_dict(),
+            "to": to_airport.as_dict(),
+            "distance": dist,
+            "unit": unit,
+            "model": model
+        }
+
+    except AeroNavXError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@app.get("/nearest")
+async def find_nearest(
+    lat: float = Query(..., ge=-90, le=90),
+    lon: float = Query(..., ge=-180, le=180),
+    n: int = Query(5, ge=1, le=100)
+):
+    try:
+        airports = nearest_airports(lat, lon, n=n)
+
+        return {
+            "query": {"lat": lat, "lon": lon},
+            "count": len(airports),
+            "airports": [a.as_dict() for a in airports]
+        }
+
+    except AeroNavXError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@app.get("/search")
+async def search(
+    q: str = Query(..., min_length=1),
+    limit: int = Query(20, ge=1, le=100)
+):
+    try:
+        airports = search_airports_by_name(q, limit=limit)
+
+        return {
+            "query": q,
+            "count": len(airports),
+            "airports": [a.as_dict() for a in airports]
+        }
+
+    except AeroNavXError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@app.get("/flight-time")
+async def flight_time(
+    from_code: str = Query(..., alias="from"),
+    to_code: str = Query(..., alias="to"),
+    speed_kts: float = Query(450.0, ge=100, le=1000)
+):
+    try:
+        from_airport = get(from_code, code_type="auto")
+        to_airport = get(to_code, code_type="auto")
+
+        if from_airport is None:
+            raise HTTPException(status_code=404, detail=f"Origin airport not found: {from_code}")
+
+        if to_airport is None:
+            raise HTTPException(status_code=404, detail=f"Destination airport not found: {to_code}")
+
+        time_hours = estimate_flight_time_hours(from_airport, to_airport, speed_kts=speed_kts)
+
+        hours = int(time_hours)
+        minutes = int((time_hours - hours) * 60)
+
+        return {
+            "from": from_airport.as_dict(),
+            "to": to_airport.as_dict(),
+            "speed_kts": speed_kts,
+            "time_hours": time_hours,
+            "time_formatted": f"{hours}h {minutes}m"
+        }
+
+    except AeroNavXError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@app.get("/emissions")
+async def emissions(
+    from_code: str = Query(..., alias="from"),
+    to_code: str = Query(..., alias="to"),
+    model: str = Query("haversine", regex="^(haversine|slc|vincenty)$")
+):
+    try:
+        co2_kg = estimate_co2_kg_by_codes(from_code, to_code, code_type="auto", model=model)
+
+        from_airport = get(from_code, code_type="auto")
+        to_airport = get(to_code, code_type="auto")
+
+        return {
+            "from": from_airport.as_dict(),
+            "to": to_airport.as_dict(),
+            "co2_kg_per_passenger": co2_kg,
+            "model": model
+        }
+
+    except AeroNavXError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+def run_server(host: str = "0.0.0.0", port: int = 8000):
+    import uvicorn
+    uvicorn.run(app, host=host, port=port)
+
+
+if __name__ == "__main__":
+    run_server()

aeronavx-0.3.1/aeronavx/cli/__init__.py

@@ -0,0 +1,3 @@
+from .main import main
+
+__all__ = ["main"]