openworld_radio_twin.licences#

Licences and credits of the data a scene is built from, and the dataset licence notice.

A scene records one entry per data layer and source in its provenance licences list, and the dataset manifest holds their union as data_licences. LICENSE.md at the dataset root is written from that union. Mapzen terrain has no single licence: its terms are those of the upstream source of each tile region, so it is used with the full credit list and is kept apart from the redistributable licences. An upstream dataset that Overture names for its records is a credit under the Overture entry of the same layer, not a separate licence.

Functions

data_licences(scenes)

The de-duplicated union of the scenes' licence entries, for the dataset manifest.

licence_name(value)

The licence as this module names it; an unknown name is kept as given.

licence_notice(manifest)

The text of the dataset's LICENSE.md, built from the manifest's scene records.

release_problems(entries)

Why a scene with these licence entries may not be redistributed; empty when it may.

scene_licences(buildings, environment[, ...])

One entry per data layer and source of a scene; layers without data are left out.

usable_in_release(license)

Whether a layer under license may be redistributed: a redistributable licence, or Mapzen terrain with its full credit list.

via_overture(entry)

Whether entry is an upstream dataset that Overture names for its records.

openworld_radio_twin.licences.licence_name(value)[source]#

The licence as this module names it; an unknown name is kept as given.

Return type:

str

openworld_radio_twin.licences.usable_in_release(license)[source]#

Whether a layer under license may be redistributed: a redistributable licence, or Mapzen terrain with its full credit list.

Return type:

bool

openworld_radio_twin.licences.via_overture(entry)[source]#

Whether entry is an upstream dataset that Overture names for its records.

Such data reach the scene in the Overture release, whose own entry carries the licence; the upstream entry is a credit, so its licence is not checked for release.

Return type:

bool

openworld_radio_twin.licences.release_problems(entries)[source]#

Why a scene with these licence entries may not be redistributed; empty when it may.

A layer blocks release when its licence is not recorded or is not redistributable, and a CC BY-SA 4.0 layer blocks it beside an ODbL layer, because data under one share-alike licence cannot be offered under the other.

Return type:

list[str]

openworld_radio_twin.licences.scene_licences(buildings, environment, antennas=None)[source]#

One entry per data layer and source of a scene; layers without data are left out.

Return type:

list[dict[str, object]]

openworld_radio_twin.licences.data_licences(scenes)[source]#

The de-duplicated union of the scenes’ licence entries, for the dataset manifest.

Return type:

list[dict[str, object]]

openworld_radio_twin.licences.licence_notice(manifest)[source]#

The text of the dataset’s LICENSE.md, built from the manifest’s scene records.

Return type:

str