Skip to content

Places

MinConnectTime

Bases: BaseModel

Source code in passengersim/config/places.py 
 9
10
11
12
13
14
15
16
17
18
19
20
class MinConnectTime(BaseModel, extra="forbid", validate_assignment=True):
    domestic_domestic: int
    """Minimum connect time for domestic to domestic connections in minutes."""

    domestic_international: int
    """Minimum connect time for domestic to international connections in minutes."""

    international_domestic: int
    """Minimum connect time for international to domestic connections in minutes."""

    international_international: int
    """Minimum connect time for international to international connects in minutes."""

domestic_domestic instance-attribute 

domestic_domestic: int

Minimum connect time for domestic to domestic connections in minutes.

domestic_international instance-attribute 

domestic_international: int

Minimum connect time for domestic to international connections in minutes.

international_domestic instance-attribute 

international_domestic: int

Minimum connect time for international to domestic connections in minutes.

international_international instance-attribute 

international_international: int

Minimum connect time for international to international connects in minutes.

Place

Bases: BaseModel

Source code in passengersim/config/places.py 
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
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."""

    country: str | None = None
    """Country code.

    Recommended to use ISO 3166-1 alpha-2 codes, ie. US / GB / AU / MX / etc."""

    state: str | None = None
    """State code"""

    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.
    """

    tz_offset: int | None = None
    """Hours offset from GMT"""

    mct: Annotated[
        MinConnectTime | int | None,
        AfterValidator(_inflate_simple_mct),
        BeforeValidator(_reformat_mct),
    ] = None
    """
    Default Minimum Connect Time (MCT) in minutes for this location (Airport).

    This can be given as a single integer, which will be applied to all
    connections, or differentiated by connection type (domestic-domestic,
    domestic-international, etc.).  Connection types can be given using their
    full name (with underscore) or using shorthand codes (DD, DI, ID, II), or
    as a list of 4 integers in the order DD, DI, ID, II.

    Future version of PassengerSim will also allow specific exceptions by
    airline / route / etc.
    """

    @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)

country class-attribute instance-attribute 

country: str | None = None

Country code.

Recommended to use ISO 3166-1 alpha-2 codes, ie. US / GB / AU / MX / etc.

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.

mct class-attribute instance-attribute 

mct: Annotated[
    MinConnectTime | int | None,
    AfterValidator(_inflate_simple_mct),
    BeforeValidator(_reformat_mct),
] = None

Default Minimum Connect Time (MCT) in minutes for this location (Airport).

This can be given as a single integer, which will be applied to all connections, or differentiated by connection type (domestic-domestic, domestic-international, etc.). Connection types can be given using their full name (with underscore) or using shorthand codes (DD, DI, ID, II), or as a list of 4 integers in the order DD, DI, ID, II.

Future version of PassengerSim will also allow specific exceptions by airline / route / etc.

name instance-attribute 

name: str

Identifying code for this place.

For airports, typically the three letter code.

state class-attribute instance-attribute 

state: str | None = None

State 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

tz_offset class-attribute instance-attribute 

tz_offset: int | None = None

Hours offset from GMT

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 
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
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