Namensraum „feature“

Unter feature befinden sich Funktionen, die auf 2D-Objekten (Punkte, Linien, Polygone) operieren.

feature.area(features)

Fläche

Gibt die 2D-Fläche jedes übergebenen Polygons in Quadratmetern zurück.

Parameter

features – Feature

Rückgabetyp

Float

feature.as_address(objects, key_street, key_number, key_city, key_zip)

Als Adresse

Keine Beschreibung vorhanden

Parameter

• objects – Feature

• key_street – String

• key_number – String

• key_city – String

• key_zip – String

Rückgabetyp

type-address

feature.as_line(features)

Punkte zu Linie

Generiert eine Linie aus allen übergebenen Punkten.

Parameter

features – Feature

Rückgabetyp

Feature

feature.as_oblique_trapeze(objects, key_direction, key_image_name, key_image_width, key_image_height, key_projection_center_x, key_projection_center_y, key_projection_center_z, key_camera_constant, key_pixel_size)

In Trapez umwandeln

Keine Beschreibung vorhanden

Parameter

• objects – Feature

• key_direction – String

• key_image_name – String

• key_image_width – String

• key_image_height – String

• key_projection_center_x – String

• key_projection_center_y – String

• key_projection_center_z – String

• key_camera_constant – String

• key_pixel_size – String

Rückgabetyp

type-oblique-trapeze

feature.as_points(features)

Knotenpunkte extrahieren

Extrahiert alle Knotenpunkte aus den Objekten und gibt sie als Punkte aus.

Parameter

features – Feature

Rückgabetyp

Feature

feature.as_pois(features, names, view, path)

Als POI

Die übergebenen Objekte werden als „Point of Interest“ (POI) an die angegebene View geschrieben.

Parameter

• features – Feature

• names – String

• view – View

• path – String

feature.as_tour(lines, view, path, height, duration, pitch, yaw)

Flugtour erstellen

Erstellt eine Flugtour aus dem angegebenen Linienpolygon. Die Flugtour fliegt alle Stützpunkte der Linie bis auf den letzten ab; dieser wird nur benutzt, um die finale Ausrichtung der Kamera zu bestimmen.

Parameter

• lines – Feature

• view – View

• path – String

• height – Number

• duration – Number

• pitch – Number

• yaw – Number

feature.as_wkt(features)

WKT-Repräsentation

Gibt den „Well-known text“ (WKT) jedes Objektes zurück.

Parameter

features – Feature

Rückgabetyp

String

feature.azimuth(points_a, points_b)

Winkel zwischen Punkten

Gibt den Richtungswinkel in Grad der Strecke zwischen points_a und points_b zurück.

Parameter

• points_a – Feature

• points_b – Feature

Rückgabetyp

Float

feature.bounds(features)

Bounding Box

Gibt die gesamte 2D-Bounding Box aller übergebenen Objekte zurück.

Parameter

features – Feature

Rückgabetyp

BBOX

feature.bounds3d(features)

3D-Bounding Box

Gibt die gesamte 3D-Bounding Box aller übergebenen Objekte zurück.

Parameter

features – Feature

Rückgabetyp

BBOX3D

feature.box_grid(features, xsize, ysize, sparse, quantized)

Rechteckgitter

Generiert ein Gitter aus Rechtecken, welches alle übergebenen Features überdeckt.

Parameter

• features – Feature

• xsize – Float

• ysize – Float

• sparse – Bool

• quantized – Bool

Rückgabetyp

Feature

feature.buffer(features, amount)

Puffer

Erzeuge einen 2D-Puffer für jedes Objekt.

Parameter

• features – Feature

• amount – Number

Rückgabetyp

Feature

feature.centroid(features)

Schwerpunkt

Gibt den Schwerpunkt jedes Objektes zurück.

Parameter

features – Feature

Rückgabetyp

Feature

feature.closest_point(features, other)

Nächstgelegener Punkt

Gibt für jedes übergebenene Feature den Punkt zurück, der am nächsten auf der Geometrie von other liegt.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.collect(features, by)

Geometrien zusammenfassen

Einzelne Geometrien zu MultiPoint, MultiLineString, MultiPolygon oder GeometryCollection vereinigen.

Parameter

• features – Feature

• by – Anything

Rückgabetyp

Feature

feature.coordinates(features)

Koordinaten als Zahlenreihen

Gibt alle verwendeten Koordinaten der übergebenen Objekte als einzelne X-, Y- und Z-Zahlenreihen zurück.

Parameter

features – Feature

Rückgabe

x

Rückgabetyp

Float

Rückgabe

y

Rückgabetyp

Float

Rückgabe

z

Rückgabetyp

Float

feature.difference(features, other)

Unterschied

Gibt nur den geometrischen Teilbereich aller Objekte zurück, der nicht innerhalb von other liegt. Diese Funktion verändert die Geometrie der Objekte, wenn diese nicht komplett außerhalb liegt.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.dissolve(features, by)

Geometrien auflösen

Überlappende Geometrien vereinigen.

Parameter

• features – Feature

• by – Anything

Rückgabetyp

Feature

feature.distance(features, other)

Distanz

Gibt die minimale Distanz zu other zurück.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Float

feature.drop_z(features)

Z-Wert entfernen

Stellt sicher, dass die Geometrie 2-dimensional ist.

Parameter

features – Feature

Rückgabetyp

Feature

feature.exterior_ring(features)

Äußerer Umring

Gibt für die übergebenen Features nur den äußeren Umring zurück. In anderen Worten: Alle inneren Ringe (Löcher) werden entfernt.

Parameter

features – Feature

Rückgabetyp

Feature

feature.extrude(features, height, offset)

Extrudieren

Extrudiert die übergebenen 2D-Objekte mit der angegebenen Höhe (height) und Abstand zu Normalnull (offset).

Parameter

• features – Feature

• height – Number

• offset – Number

Rückgabetyp

Mesh

feature.filter.centroid_in_bounds(features, bounds)

Schwerpunkt in Bounding Box

Filtert alle Objekte, deren Schwerpunkt innerhalb der angegebenen Bounding Box liegen.

Parameter

• features – Feature

• bounds – BBOX

Rückgabetyp

Feature

feature.filter.contains(features, other)

Enthält

Gibt nur diejenigen Objekte zurück, die other enthalten.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.filter.crosses(features, other)

Kreuzt

Gibt nur diejenigen Objekte zurück, die other kreuzen.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.filter.disjoint(features, other)

Überschneidet nicht

Gibt nur diejenigen Objekte zurück, die sich nicht mit other überschneiden.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.filter.intersects(features, other)

Überschneidet

Gibt nur diejenigen Objekte zurück, die sich mit other überschneiden.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.filter.not_within(features, other)

Nicht innerhalb

Gibt nur diejenigen Objekte zurück, die nicht innerhalb von other liegen.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.filter.touches(features, other)

Berührt

Gibt nur diejenigen Objekte zurück, die other berühren. D.h. die Objekte haben mit other mindestens einen Punkt gemeinsam aber überscheiden sich nicht.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.filter.type(features, type)

Filter nach Geometrietyp

Filtert die übergebenen Features nach dem angegebenen Geometrietyp. Mögliche Werte sind: „Point“, „LineString“, „Polygon“, „MultiPoint“, „MultiLineString“, „MultiPolygon“ oder „GeometryCollection“.

Parameter

• features – Feature

• type – String

Rückgabetyp

Feature

feature.filter.within(features, other)

Innerhalb

Gibt nur diejenigen Objekte zurück, die innerhalb von other liegen.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.find.intersects(features, containers, default)

Überschneidung zuordnen

Findet für jedes Objekt des ersten Datensatzes ein entsprechendes Objekt aus dem zweiten Datensatz. Die Entsprechung findet bei dieser Funktion durch räumliche Überschneidung statt.

Parameter

• features – Feature

• containers – Feature

• default – Feature

Rückgabetyp

Feature

feature.find.nearest(features, containers, default)

Nächstgelegene zuordnen

Findet für jedes Objekt des ersten Datensatzes das Objekt aus dem zweiten Datensatz, welches sich am nächsten zum ursprünglichen Objekt befinden.

Parameter

• features – Feature

• containers – Feature

• default – Feature

Rückgabetyp

Feature

feature.find.within(features, containers, default)

Enthaltende zuordnen

Findet für jedes Objekt des ersten Datensatzes ein entsprechendes Objekt aus dem zweiten Datensatz. Das Objekt aus dem zweiten Datensatz wird ausgewählt, wenn das Objekt des ersten Datensatzes innerhalb von diesem liegt.

So kann diese Funktion zum Beispiel dazu verwendet werden, für mehrere Punkte das jeweils dazugehörige Grenzpolygon auszuwählen.

Parameter

• features – Feature

• containers – Feature

• default – Feature

Rückgabetyp

Feature

feature.flatten(features)

Einteilige Geometrien

Konvertiert alle Bestandteile von MultiPoint, MultiLineString, MultiPolygon und GeometryCollection zu einzelnen Geometrien.

Parameter

features – Feature

Rückgabetyp

Feature

feature.force_z(features)

Z-Wert erzwingen

Stellt sicher, dass die Geometrie 3-dimensional ist. Wenn kein Z-Wert gesetzt sein sollte, wird dieser auf 0 gesetzt.

Parameter

features – Feature

Rückgabetyp

Feature

feature.from_wkt(wkt)

2D-Objekte aus WKT

Wandelt die als „Well-known text“ (WKT) übergebene Geometrie in ein 2D-Objekt um.

Parameter

wkt – String

Rückgabetyp

Feature

feature.geom_dimension(features)

Geometriedimension

Gibt die Dimension der Geometrie zurück (2 oder 3).

Parameter

features – Feature

Rückgabetyp

Int

feature.geom_type(features)

Geometrietyp

Gibt den Geometrietyp der übergebenen Features aus (Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection).

Parameter

features – Feature

Rückgabetyp

String

feature.heal_geometry(features)

Geometrie reparieren

Versucht, die Geometrie zu reparieren, falls diese ungültig ist.

Experimentell: Name und Parameter können sich ändern.

Parameter

features – Feature

Rückgabe

healed

Rückgabetyp

Int

Rückgabe

failed

Rückgabetyp

Feature

Rückgabetyp

Feature

feature.hierarchy.contains(features, key_id, key_parent, threshold)

Hierarchie erzeugen (enthält)

Erzeugt eine Hierarchie auf Basis der Enthält-Relation.

Parameter

• features – Feature

• key_id – String

• key_parent – String

• threshold – Float

Rückgabetyp

Feature

feature.import(filename, format, attr)

2D-Objekte importieren

Unterstützte Formate sind: ESRI Shapefile, GML, GeoJSON, GeoPackage, KML, GeoRSS, GPX, MapInfo File

Parameter

• filename – String

• format – String

• attr – type-feature-import-config

Rückgabetyp

Feature

feature.individual_bounds(features)

Bounding Box

Gibt die 2D-Bounding Box für jedes übergebene Objekt zurück.

Parameter

features – Feature

Rückgabetyp

BBOX

feature.intersection(features, other)

Zuschneiden

Gibt nur den geometrischen Teilbereich aller Objekte zurück, der sich mit other überschneidet. Diese Funktion verändert die Geometrie der Objekte, wenn diese nicht komplett innerhalb liegt.

Parameter

• features – Feature

• other – Feature

Rückgabetyp

Feature

feature.jiggle(features, distance, seed)

Rütteln

Verrückt die einzelnen Punkte der Geometrien um verschiedene, zufällig gewählte Werte. Der maximale dabei zwischen den Punkten entstehende Abstand wird in dem Parameter distance festgelegt. Um bei mehrmaligem Ausführen auf denselben Ausgangspunkten dieselbe Anordnung der Punkte zu erhalten, kann der Parameter seed kann auf eine beliebige Ganzzahl gesetzt werden. Für dieselbe Anordnung muss diese Ganzzahl beibehalten werden. Eine andere Ganzzahl erzeugt eine andere zufällige Anordnung der Punkte.

Parameter

• features – Feature

• distance – Float

• seed – Int

Rückgabetyp

Feature

feature.length(features)

Länge

Gibt die 2D-Länge jeder übergebenen Linie zurück.

Parameter

features – Feature

Rückgabetyp

Float

feature.line_to_polygon(features)

Linie zu Polygon

Konvertiert alle übergebenen Linien zu Polygonen

Parameter

features – Feature

Rückgabetyp

Feature

Rückgabe

failed

Rückgabetyp

Feature

feature.load(files, format, attr)

2D-Objekte laden

Unterstützte Formate sind: ESRI Shapefile, GML, GeoJSON, GeoPackage, KML, GeoRSS, GPX, MapInfo File

Parameter

• files – File

• format – String

• attr – type-feature-import-config

Rückgabetyp

Feature

feature.points_from_coords(x, y, z)

Punkte aus Koordinaten

Generiert Punkte aus den übergebenen Koordinaten.

Parameter

• x – Float

• y – Float

• z – Float

Rückgabetyp

Feature

feature.points_grid(bounds, distance)

Punktegitter

Generiert ein Punktegitter innerhalb der angegebenen Polygone. Die Dichte des Punktegitters kann über den Distanzparameter distance angegeben werden.

Parameter

• bounds – Feature

• distance – Float

Rückgabetyp

Feature

feature.polygon_to_line(features)

Polygon zu Linie

Konvertiert alle übergebenen Polygone zu Linien

Parameter

features – Feature

Rückgabetyp

Feature

feature.rasterize(features, style, bbox, width, height, pixel_size)

Als Raster rendern

Keine Beschreibung vorhanden

Parameter

• features – Feature

• style – Style

• bbox – BBOX

• width – Number

• height – Number

• pixel_size – Number

Rückgabetyp

Grid

feature.remove_overlaps(features)

Überlappungen entfernen

Schneidet jeweils kleinere Polygone aus den größeren aus, falls diese sich überlappen.

Parameter

features – Feature

Rückgabetyp

Feature

feature.representative_point(features)

Repräsentativer Punkt

Gibt einen beliebigen Punkt zurück, der innerhalb der Geometrie liegt.

Parameter

features – Feature

Rückgabetyp

Feature

feature.reproject_gcp(features, points_in, points_out)

Auf Kontrollpunkte projezieren

Die Eingabedaten werden so reprojeziert, dass jeder Punkt aus points_in nach der Transformation auf dem entsprechenden Punkt aus points_out liegt. Die Anzahl der Punkte in points_in muss der Anzahl der Punkte in points_out entsprechen. Es werden mindestens drei Punktepaare benötigt.

Parameter

• features – Feature

• points_in – Feature

• points_out – Feature

Rückgabetyp

Feature

feature.save(features, format, name)

2D-Objekte exportieren

Exportiert 2D-Objekte in Dateien.

Unterstützte Formate sind: ESRI Shapefile, GML, GeoJSON, GeoPackage, KML, GeoRSS, GPX, MapInfo File, CSV

Parameter

• features – Feature

• format – String

• name – String

Rückgabetyp

File

feature.set_z(features, elevation)

Z-Wert festlegen

Setzt den Z-Wert der Geometrien auf den übergebenen Wert.

Parameter

• features – Feature

• elevation – Number

Rückgabetyp

Feature

feature.set_z_from_grid(features, grids)

Z-Wert übernehmen

Sucht für jeden Punkt der Objektgeometrien die entsprechende Höhe aus einem Höhenraster und setzt diese als Z-Wert.

Parameter

• features – Feature

• grids – Grid

Rückgabetyp

Feature

feature.simplify(features, tolerance)

Vereinfachen

Vereinfacht die Geometrie unter Berücksichtigung der angegebenen Toleranz in Karteneinheiten.

Parameter

• features – Feature

• tolerance – Float

Rückgabetyp

Feature

feature.split.geometry_change(a, b, key, threshold, rel_threshold)

Keine Beschreibung vorhanden

Parameter

• a – Feature

• b – Feature

• key – String

• threshold – Float

• rel_threshold – Float

Rückgabe

a_changed

Rückgabetyp

Feature

Rückgabe

a_unchanged

Rückgabetyp

Feature

Rückgabe

b_changed

Rückgabetyp

Feature

Rückgabe

b_unchanged

Rückgabetyp

Feature

feature.thinout(features, distance)

Ausdünnen

Gibt eine Untermenge von den Objekten zurück, so dass kein Objekt näher als distance an einem anderen Objekt ist.

Parameter

• features – Feature

• distance – Number

Rückgabetyp

Feature

feature.transform(features, src_crs, dst_crs)

Koordinatentransformation

Transfomiert die Geometrien von src_crs nach dst_crs. Das Koordinatensystem kann entweder als EPSG-Code oder als Proj4-String angegeben werden. Wird einer der Parameter nicht angegeben, wird für diesen das Standardkoordinatensystem dieser PlexMap-Installation genommen.

Parameter

• features – Feature

• src_crs – String

• dst_crs – String

Rückgabetyp

Feature

feature.translate(features, x, y, z)

Verschieben

Verschiebt die Geometrie um die angegebenen Werte in Karteneinheiten.

Parameter

• features – Feature

• x – Number

• y – Number

• z – Number

Rückgabetyp

Feature