difference — Berechnen der Differenz von Mengen von Regionen.
difference(Region, Sub : RegionDifference : : )
difference berechnet die flächenmäßige Differenz von
Regionen:
(Regionen aus Region) - (Regionen aus Sub)
Eine Ergebnisregion berechnet sich aus der Eingaberegion
(Region) minus aller Punkte der Regionen aus
Sub. Intern werden alle Regionen aus Sub
zunächst vereinigt, bevor die Differenz jeder einzelnen
Region aus Region mit der vereinigten Region
berechnet wird.
Leere Eingaberegionen sind bei beiden Parametern zulässig. Es ist zu beachten, dass leere Regionen entstehen können. Hierbei ist der Wert von 'store_empty_region' zu beachten.
Region (input_object) region(-array) → object
Zu bearbeitende Region(en).
Sub (input_object) region(-array) → object
Diese Region(en) (ihre Vereinigung) werden von Region abgezogen.
RegionDifference (output_object) region(-array) → object
Ergebnis der Differenz.
* provides the region X without the points in Y difference(X,Y,RegionDifference)
Sei die Anzahl der Region und deren mittlere
Fläche und die Gesamtfläche aller Regionen aus Sub,
dann ist die Laufzeitkomplexität:
.
difference liefert normalerweise den Wert 2 (
H_MSG_TRUE)
. Das
Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden)
lässt sich mittels
set_system('no_object_result',<Result>),
das bei leerer Region mit
set_system('empty_region_result',<Result>) festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
threshold,
connection,
regiongrowing,
pouring,
class_ndim_norm
intersection,
union1,
union2,
complement,
symm_difference
Foundation