IsCoordinateInPolygon: Unterschied zwischen den Versionen

Aus JACK Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
IsCoordinateInPolygon
{{Vorlage:Warnung|Warnung=Diese Seite beinhaltet eine Evaluator-Funktion im JACK3 System.}}
 
===Zugehörige Evaluatoren===
*'''MathEvaluator'''
 
=== Beschreibung ===
Die Funktion ''isCoordinateInPolygon'' überprüft, ob mindestens eine [[Coordinate|Koordinate]] aus einer [[List|Liste]] von [[Coordinate|Koordinaten]] innerhalb oder auf dem Rand eines [[Polygon|Polygons]] liegt. Sie erwartet als Eingabe einen [[Polygon|Polygon]], der durch mindestens drei [[Coordinate|Koordinaten]] (ein Tupel aus zwei Float-Werten für die x- und y-Koordinate) implementiert ist. Die Reihenfolge der [[Coordinate|Koordinaten]] bestimmt die Reihenfolge, in der das [[Polygon|Polygon]] gebildet wird. Zusätzlich wird eine [[List|Liste]] einzelner [[Coordinate|Koordinaten]] (ebenfalls Tupel aus zwei Float-Werten) übergeben, die überprüft werden soll. Die Funktion gibt einen booleschen Wert (True oder False) zurück, der angibt, ob mindestens eine [[Coordinate|Koordinate]] innerhalb oder auf den Rand des [[Polygon|Polygons]] liegt.
 
=== Syntax ===
isCoordinateInPolygon([[Polygon]] polygon, [[List]] [[Coordinate|koordinaten]])
 
=== Parameter ===
* '''polygon''' - [[Polygon|polygon]], bestehend aus mindestens drei [[Coordinate|Koordinaten]]
* '''koordinaten''' - [[List|Liste]] von [[Coordinate|Koordinaten]]
 
=== Return Value ===
* Gibt einen Boolean zurück
 
=== Beispiele ===
==== Standardfälle ====
isCoordinateInPolygon(polygon(coordinate(0,0), coordinate(4,0), coordinate(4,4), coordinate(0,4)), list(coordinate(2,2), coordinate(5,5)))    --> returns ''true''
isCoordinateInPolygon(polygon(coordinate(0,0), coordinate(4,0), coordinate(4,4), coordinate(0,4)), list(coordinate(5,6), coordinate(7,8)))  --> returns ''false''
isCoordinateInPolygon(polygon(coordinate(0,0), coordinate(4,0), coordinate(4,4), coordinate(0,4)), list(coordinate(0,0), coordinate(3,3)))    --> returns ''true''
 
===Hinweise===
* Bei den Funktionen [[Polygon]] und [[Coordinate]] handelt es sich um Konstruktoren, die entsprechend instanziiert werden müssen.
* Funktionen, die geometrische Figuren beschreiben: [[Coordinate]], [[Circle]], [[Rectangle]] und [[Polygon]]
* Weitere Funktionen, die prüfen ob eine Koordinate in einer geometrischen Figur liegt: [[IsCoordinateInRectangle]] und [[IsCoordinateInCircle]]
 
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Geometry]]

Aktuelle Version vom 4. Februar 2025, 13:56 Uhr

Diese Seite beinhaltet eine Evaluator-Funktion im JACK3 System.

Zugehörige Evaluatoren

  • MathEvaluator

Beschreibung

Die Funktion isCoordinateInPolygon überprüft, ob mindestens eine Koordinate aus einer Liste von Koordinaten innerhalb oder auf dem Rand eines Polygons liegt. Sie erwartet als Eingabe einen Polygon, der durch mindestens drei Koordinaten (ein Tupel aus zwei Float-Werten für die x- und y-Koordinate) implementiert ist. Die Reihenfolge der Koordinaten bestimmt die Reihenfolge, in der das Polygon gebildet wird. Zusätzlich wird eine Liste einzelner Koordinaten (ebenfalls Tupel aus zwei Float-Werten) übergeben, die überprüft werden soll. Die Funktion gibt einen booleschen Wert (True oder False) zurück, der angibt, ob mindestens eine Koordinate innerhalb oder auf den Rand des Polygons liegt.

Syntax

isCoordinateInPolygon(Polygon polygon, List koordinaten)

Parameter

Return Value

  • Gibt einen Boolean zurück

Beispiele

Standardfälle

isCoordinateInPolygon(polygon(coordinate(0,0), coordinate(4,0), coordinate(4,4), coordinate(0,4)), list(coordinate(2,2), coordinate(5,5)))     --> returns true
isCoordinateInPolygon(polygon(coordinate(0,0), coordinate(4,0), coordinate(4,4), coordinate(0,4)), list(coordinate(5,6), coordinate(7,8)))   --> returns false
isCoordinateInPolygon(polygon(coordinate(0,0), coordinate(4,0), coordinate(4,4), coordinate(0,4)), list(coordinate(0,0), coordinate(3,3)))    --> returns true

Hinweise