catatom2osm.app module

Main application processes.

class catatom2osm.app.CatAtom2Osm(a_path, options)

Bases: object

Main application class.

add_comments()

Recover missing task files metadata after JOSM editing.

static create_and_run(a_path, options)

exit()

Exit properly.

export_layer(layer, filename, driver_name='GeoJSON', target_crs_id=None)

Export a vector layer.

Parameters

• layer (QgsVectorLayer) – Source layer.

• filename (str) – Output filename.

• driver_name (str) – name of OGR driver (or get it from filename).

• target_crs_id (int) – Defaults to source CRS.

export_poly()

finish()

Generate final report.

get_address()

Read Address GML dataset.

get_auxiliary_addresses()

Read and conflate auxiliary sources of addresses data.

get_boundary()

Get best boundary search area for overpass queries.

get_building()

Merge building, parts and pools.

get_cbcn()

Read CartoBCN addresses.

get_current_ad_osm()

Get OSM address for conflation.

get_highway()

Get OSM highways for street names conflation.

get_parcel()

Get parcels dataset.

get_place()

Get OSM places for street names conflation.

get_split()

Get boundary file for splitting.

static get_task_comment(label)

Return comment for task with this label.

get_tasks(source)

Put each source feature into a task layer.

get_translations(address)

Get the translate file.

If there exists the translation file ‘highway_types.csv’, read it, else write one with default values. If the translations file ‘highway_names.csv’ don’t exist, creates one parsing current OSM highways data, else reads and returns it as a dictionary.

• ‘highway_types.csv’ List of osm elements in json format located in the application path that contains translations from abbreviations to full types of highways.

• ‘highway_names.csv’ is located in the outputh folder and contains corrections for original highway names.

get_zoning()

Get zoning data.

merge_address(building_osm, address_osm)

Copy address from address_osm to building_osm using ‘ref’ tag.

If there exists one building with the same ‘ref’ that an address, copy the address tags to the building if it isn’t a ‘entrace’ type address or else to the entrance if there exist a node with the address coordinates in the building.

Precondition: building.move_address deleted addresses belonging to multiple buildings

Parameters

• building_osm (Osm) – OSM data set with buildings

• address_osm (Osm) – OSM data set with addresses

move_project()

Move to tasks all files needed for the backup the in the repository.

Use a subdirectory if it’s a split municipality.

output_zoning()

Generate project zoning file.

process_address()

Fix street names, conflate and move addresses.

process_building()

Process all buildings dataset.

process_parcel()

Process parcels dataset.

process_tasks(source)

Convert to osm for each task.

read_osm(*paths, **kwargs)

Read an OSM data set from an OSM XML file.

If the file not exists, downloads data from overpass using ql query.

Parameters

• paths (str) – input filename components relative to self.path

• ql (str) – Query to put in the url for overpass

Returns

Osm: OSM data set

resume_address()

Resume processing for second run of addresses dataset.

run()

Launch the app processing.

stop_address()

Save current processing status and exits.

write_osm(data, *paths)

Generate an OSM XML file for an OSM data set.

Parameters

• data (Osm) – OSM data set

• paths (str) – output filename components relative to self.path (compress if ends with .gz)

class catatom2osm.app.QgsSingleton

Bases: qgis._core.QgsApplication

Keep a unique instance of QGIS for the application (and tests).