Place¶

class passengersim.config.Place[source]¶

Bases: Named

Attributes:

name	Identifying code for this place.
label	A descriptive label for this place.
country	Country code.
domestic_group	Shared group for domestic connection-time classification across countries.
resolved_domestic_group	Return the explicit or automatically inferred domestic group.
state	State code
lat	Latitude in degrees.
lon	Longitude in degrees.
time_zone	The time zone for this location.
tz_offset	Hours offset from GMT
mct	Default Minimum Connect Time (MCT) in minutes for this location (Airport).
max_connect_time	Maximum connection time (MCT) in minutes for this place.
tags	Optional dictionary of tags associated with this place.
time_zone_info
latitude	Alias for lat.
longitude	Alias for lon.

name : str¶

Identifying code for this place.

For airports, typically the three letter IATA code.

label : str¶

A descriptive label for this place.

country : str | None¶

Country code.

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

domestic_group : str | None¶

Shared group for domestic connection-time classification across countries.

None automatically selects "schengen" for Schengen countries, including places populated by airport lookup. An empty string disables automatic group membership for this place. Other strings define custom groups; two airports in the same nonempty group are treated as domestic without changing country codes. Same-country flights remain domestic regardless of this setting.

property resolved_domestic_group : str¶

Return the explicit or automatically inferred domestic group.

Returns:

str – Group name, or an empty string if no group applies. Membership uses current country codes, not historical travel dates.

state : str | None¶

State code

lat : float | None¶

Latitude in degrees.

lon : float | None¶

Longitude in degrees.

time_zone : str | None¶

The time zone for this location.

tz_offset : int | None¶

Hours offset from GMT

mct : Annotated[LimitConnectTime | int | None, AfterValidator(_inflate_simple_mct), BeforeValidator(_reformat_mct)]¶

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.

max_connect_time : Annotated[LimitConnectTime | int | None, AfterValidator(_inflate_simple_mct), BeforeValidator(_reformat_mct)]¶

Maximum connection time (MCT) in minutes for this place.

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.

If the maximum connection time for any category is missing or set to -1, then the simulation default maximum connection time will be used for that category.

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

tags : dict[str, str]¶

Optional dictionary of tags associated with this place.

Tags can be used to store arbitrary key-value pairs of information related to this place. This may be useful for categorization, filtering, or adding metadata. Tags can also be used in RM actions to apply different strategies based on place characteristics. For example, a tag could indicate whether a place is within the Schengen area, allowing RM actions to adjust their behavior accordingly.

property time_zone_info : ZoneInfo | None¶

property latitude : float¶

Alias for lat.

property longitude : float¶

Alias for lon.