modxlib

modxlib是 CTPS 模型数据资源管理器中使用的常用函数、数据和类的包。

版本标识

功能：get_version() - 返回库的版本 ID 字符串。

行程表管理

功能：open_trip_tables(tt_dir)

摘要：给定一个目录，其中包含该模式使用的四个每日时间段的 OMX 格式的行程表，打开它们并返回一个字典，其中的键为“am”、“md”、“pm”和“nt”，其值是对应的打开的OMX文件。

参数： tt_dir - 包含 OMX 格式的行程表文件的目录

返回值：一个字典，键为“am”、“md”、“pm”和“nt”，其值为对应的打开的 OMX 文件。

功能：load_trip_tables（tt_dir，模式=无）

摘要：将所有时间段的行程表从打开的 OMX 文件中加载到 NumPy 数组中的指定模式列表中。如果没有通过模式列表，则将返回所有模式的行程表。

参数

• tt_omxs - 字典，由时间段标识符（“am”、“md”、“pm”和“nt”）键入，每个值都是相应时间段的打开 OMX 行程表文件。
• 模式 - 模式列表（字符串），或无

返回值：一个两级字典（即第一级=时间段，第二级=模式），第二级包含行程表，以numPy数组的形式，用于[time_period][mode ] 有问题。

TAZ“shapefile”管理

摘要：“tazManager”类提供了一组方法来对表示模型区域中的 TAZ 的 ESRI 格式“Shapefile”执行属性查询。属性从 Shapefile 的 .DBF 文件中读取；Shapefile 的其他组件被忽略。

Shapefile 的 .DBF 文件必须包含以下属性：

1. ID
2. 塔兹
3. 类型 - 'I'（内部）或 'E'（外部）
4. town - 城镇名称（大写）
5. state - 州的缩写，例如“MA”
6. town_state - 城镇，州
7. mpo - MPO 名称的缩写：
8. in_brmpo - 1（是）或 0（否）
9. 次区域 - 波士顿地区 MPO 次区域的缩写或 NULL
10. 部门 - CTPS 的 Bill Kuttner 定义的“分析部门”。'Northeast', 'North', 'Northwest', 'West', 'Southwest', South', 'Southeast', 'Central' 或 ''; 空字符串 ('') 表示 TAZ 比包括曾经被称为“CTPS 示范区”的 164 个自治市大得多。

类 tazManager 的对象通过将 Shapefile 的完全限定路径传递给类构造函数来实例化。因此，如果需要，可以同时激活该类的多个实例。

类 tazManager
方法：

1. init (path_to_shapefile) - 类构造函数
2. mpo_to_tazes(mpo) - 给定 MPO 的名称（即缩写），返回其中 TAZes 的记录列表
3. brmpo_tazes() - 返回波士顿地区 MPO 中 TAZes 的记录列表
4. brmpo_town_to_tazes(town) - 给定波士顿地区 MPO 的城镇名称，返回其中 TAZes 的记录列表
5. brmpo_subregion_to_tazes(subregion) - 给定波士顿地区 MPO 子区域的名称（即缩写），返回其中 TAZes 的记录列表
6. ector_to_tazes - 给定“分析扇区”的名称，返回该扇区中 TAZes 的记录列表。
7. town_to_tazes(town) - 给定一个城镇的名称，返回该城镇 TAZes 的记录列表。注意：如果同名城镇出现在多个州，则返回所有此类州的 TAZ 列表。
8. town_state_to_tazes(town, state) - 给定一个城镇和一个州的缩写（例如，'MA'），返回城镇中 TAZes 的记录列表
9. state_to_tazes(state) - 给定一个州缩写，返回该州 TAZes 的记录列表。
10. taz_ids(TAZ_record_list) - 给定一个 TAZ 记录列表，返回这些记录中仅包含 TAZ ID 的列表。

注意：对于上述所有返回“TAZ 记录列表”的 API 调用，每个返回的“TAZ”都是一个 Python“dict”，其中包含上面列出的所有键（即“属性”）。要将此类列表转换为仅包含 TAZ ID 的列表，请在 TAZ 记录列表上调用 taz_ids。

Transit 模式的其他实用程序

注意：传输实用程序特定于 TDM19。它们将针对 TDM23 进行修改。

功能：mode_to_metamode（模式）

摘要：给定 TDM 支持的 50 多种运输“模式”之一，返回其“元模式”。例如，该模型支持 MBTA 公交路线的 3 种不同“模式”；所有这三个都具有“MBTA_Bus”的共同“元模式”。元模式的世界包括“MBTA_Bus”、“Light_Rail”、“Heavy_Rail”、“Commuter_Rail”、“Ferry”、“Shuttle_Express”、“RTA”、“Private”和“Walk”。

参数：

• mode - 标识 TDM 支持的传输“模式”之一的字符串。

返回值：表示输入模式的“元模式”的字符串。

功能：import_transit_assignment（场景）

摘要：导入给定方案的交通分配结果 CSV 文件。

参数：：

• 场景 - 给定场景的 TDM 中转登机（“ONO.csv”）文件的根目录路径。

返回值：形式的字典：

{	'AM'    : dataframe with totals for the AM period,
	'MD'    : datafrme with totals for the MD period,
	'PM'    : dataframe with totals for the PM period,
	'NT'    : dataframe with totals for the NT period,
	'daily' : dataframe with totals for the entire day
}

数据框和地理数据框实用程序

功能：export_gdf_to_geojson(geo_dataframe, geojson_fn)

摘要：将 GeoPandas gdataframe 导出到 GeoJSON 文件。

参数：

• geo_dataframe - GeoPandas 数据框
• geojson_fn - GeoJSON 文件的名称

返回值：不适用

功能：export_gdf_to_shapefile(geo_dataframe, shapefile_fn)

摘要：将 GeoPandas gdataframe 导出到 ESRI 格式的 shapefile

参数：

• geo_dataframe - GeoPandas 数据框
• geojson_fn - 形状文件的名称

注意：由于用于 Shapefile 属性的 DBF 文件的限制，超过 10 个字符的属性（属性）名称将被截断。

返回值：不适用

功能：bbox_of_gdf(gdf)

Summar：返回地理数据框中所有特征的边界框。

参数：

• gdf - GeoPandas 数据框

返回值：输入地理数据框中所有要素的边界框。边界框作为带有键的字典返回：{ 'minx', 'miny', 'maxx', 'maxy' }

功能：center_of_bbox(bbox)

摘要：给定一个几何“边界框”，返回它的中心点。

参数：

• bbox - 字典形式的边界框，键为 { 'minx', 'miny', 'maxx', 'maxy'}

返回值：边界框的中心点作为带有键 { 'x' , 'y' } 的字典。