Skip to content

Places

Place

Bases: BaseModel

Source code in passengersim/config/places.py 
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
class Place(BaseModel, extra="forbid", validate_assignment=True):
    name: str
    """Identifying code for this place.

    For airports, typically the three letter code."""

    label: str
    """A descriptive label for this place."""

    lat: float | None = None
    """Latitude in degrees."""

    lon: float | None = None
    """Longitude in degrees."""

    time_zone: str | None = None
    """
    The time zone for this location.
    """

    @field_validator("time_zone")
    def _valid_time_zone(cls, v: str):
        """Check for valid time zones."""
        if isinstance(v, str):
            ZoneInfo(v)
        return v

    @property
    def time_zone_info(self):
        return ZoneInfo(self.time_zone)

label instance-attribute 

label: str

A descriptive label for this place.

lat class-attribute instance-attribute 

lat: float | None = None

Latitude in degrees.

lon class-attribute instance-attribute 

lon: float | None = None

Longitude in degrees.

name instance-attribute 

name: str

Identifying code for this place.

For airports, typically the three letter code.

time_zone class-attribute instance-attribute 

time_zone: str | None = None

The time zone for this location.

time_zone_info property 

time_zone_info

great_circle 

great_circle(place1: Place, place2: Place)

Using Haversine formula, to get distance between points in miles.

Source code in passengersim/config/places.py 
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
def great_circle(place1: Place, place2: Place):
    """Using Haversine formula, to get distance between points in miles."""
    lon1 = math.radians(place1.lon)
    lat1 = math.radians(place1.lat)
    lon2 = math.radians(place2.lon)
    lat2 = math.radians(place2.lat)
    lon_diff = lon2 - lon1
    lat_diff = lat2 - lat1
    a = math.sin((lat_diff) / 2.0) ** 2.0 + (
        math.cos(lat1) * math.cos(lat2) * (math.sin((lon_diff) / 2.0) ** 2.0)
    )
    angle2 = 2.0 * math.asin(min(1.0, math.sqrt(a)))
    # Convert back to degrees.
    angle2 = math.degrees(angle2)
    # Each degree on a great circle of Earth is 69.0468 miles. ( 60 nautical miles )
    distance2 = 69.0468 * angle2
    return distance2