Basic tools for Spatial Query

Spatial Query is a Query Mode that constructs a Filter through the spatial position relationship between Geometries. The Application currently supports 8 basic tools for Spatial Query, including intersection, inclusion, inclusion, superposition, separation, adjacency, coincidence, and intersection.

Spatial Query involves three elements: Layers for Query, Query Layer and Search Result. In the diagram of each operator, Query Layer is represented in green, objects not found in the Layers for Query are represented in black, and Search Result is represented in red.

Intersection

Returns the All Objects in the Layers for Query (line, surface, CAD) that intersect the queried object (line).

  • Basic relationship: Query Layer (A) traverses Layers for Query (B).
  • Line check: A enters from one side inside B and exits from the other side somewhere inside B. The intersection of the interior of A and the interior of B is not empty, and the topological dimension is 0-dimensional.
  • Line check face: the intersection of the interior of A and the interior of B is not empty; the intersection of the interior of A and the exterior of B is not empty.

Crossover operator details:

Spatial Query Condition Query the relationship Illustration Explain
Cross _ line line Line check line The line crosses the line, entering from one side and exiting from the other side somewhere inside, and the internal intersection can only be a point.
Cross _ Line _ Face Line check The line passes through the face, and at least one of the two endpoints of the line is outside the face.

Contain

Returns an object containing a Query Layer (point, line, face) in a Layers for Query (point, line, face, text, CAD). (It is not necessary to fully contain, and it is fine for the boundary to have an intersection.)

Basic relationship:

  • A Layers for Query (a) contains a Query Layer (B) (the boundary intersection of a and B may not be empty).
  • The intersection of the exterior of A with the interior of B is empty, and the interior intersection is not empty or the boundary of A has no intersection with the interior of B.
  • The dimension of A > = the dimension of B.

Contains a detailed description of the tool:

Spatial Query Condition Query the relationship Illustration Explain
Contains _ dots Count and check Point coincidence.
Contains _ dotted line Line check The line A contains the point B, which is on A, including on the endpoints of the line A.
Contains _ dot text Text enumeration Text A contains point B, which is on A, included on text A.
Contains _ lines Line check line Line A contains line B whose endpoints may coincide with the endpoints of A.
Include _ line text Text line check Text A contains line B, which is on A, included on text A.
Contains _ Points and Faces Face check The face A contains a point B, which may be in the interior or on the boundary of A.
Contains _ lines and faces Face check line The face A contains a line B whose endpoints may be on the boundary of A.
Contains _ Faces Face to face The face A contains the face B whose boundary may coincide with the boundary of A.
Include _ text face Face to face text The face A contains text B, which can be in the interior or on the boundary of A.

Be contained

Returns the objects in the Layers for Query (point, line, surface, CAD) that the Target Layer contains (point, line, surface). If the returned object is a face, it must contain (including on the boundary) the Layers for Query; if the returned object is a line, it must completely contain the Layers for Query; if the returned object is a point, it must be on the Layers for Query.

Basic relationship:

  • Layers for Query Target Layer contains. The inclusion is the inverse of the inclusion.

Detailed description of the included operator

Spatial Query Condition Query the relationship Illustration Explain
Contained _ dots Count and check Point coincidence.
Included _ Line Points Point check line The point A is contained by the line B, and A may coincide with the endpoint of B.
Included _ Dots Face check The point A is contained by the face B, and A may be in the interior or on the boundary of B.
Included _ line line Line check line The line A is contained by the line B, and the endpoints of A may coincide with the endpoints of B.
Included _ face line Line check The line A is contained by the face B, and A may be in the interior or on the boundary of B.
Included _ Faces Face to face The face A is contained by the face B, and the boundary of A may coincide with the boundary of B.

Overlay

Returns objects in the Layers for Query (lines, faces, CAD) that partially overlap the Query Layer (lines, faces).

Basic relationship:

Detailed description of the superposition operator:

Spatial Query Condition Query the relationship Illustration Explain
Overlay _ Line Line check line Line A and line B partially overlap, and the detailed restriction relationship is described in the basic relationship above. If B is completely on A or A is completely on B, then Query Conditions are not satisfied.
Overlay _ Faces Faces Face to face Face A partially overlaps face B. If B is completely within A or A is completely within B, the Query Conditions are not satisfied.

Separation

Returns objects in the Layers for Query (point, line, surface, CAD) away from the Query Layer (point, line, surface).

Basic relationship:

Detailed description of the separation operator:

Spatial Query Condition Query the relationship Illustration Explain
Separating _ Dots Count and check Point A does not coincide with point B.
Separated _ Dotted Line Point check line Point A has no intersection with line B.
Separate _ Point _ Face Click and check the surface The point A has no intersection with the face B.
Detach _ Line Points Line check Line A does not have any intersection with point B.
Separate _ line line Line check line Line A does not have any intersection with Line B.
Separated _ Line/Surface Line check Line A has no intersection with face B.
Separate _ Dough Face check Face A does not have any intersection with point B.
Separate _ face line Face check line Face A does not have any intersection with line B.
Separate _ Faces Face to face Face A has no intersection with face B.

Adjacent

Returns objects in the Layers for Query (point, line, surface, CAD) whose boundaries touch the boundaries of the Query Layer (point, line, surface).

Basic relationship:

Adjacency operator details:

Spatial Query Condition Query the relationship Illustration Explain
Adjacent _ dotted line Point check line Point A is at the end of line B.
Adjacent _ Point _ Face Click and check the surface The point A is on the boundary of the face B.
Adjacent _ Line Points Line check Point B is at the end of line A.
Adjacent _ Line Line check line There are three cases where line A is adjacent to line B:
Adjacent _ Line/Face Line check Either one of the endpoints of the line A is on the boundary of the face B and the rest is outside the face B, or part of the line A is on the boundary of the face B and the rest is outside the face B, or all of the line A is on the boundary of the face B.
Adjacent _ Faces Face check Point B is on the boundary of face A.
Adjacent _ Face Line Face check line Either one of the endpoints of the line B is on the boundary of the face A and the rest is outside the face A, or part of the line B is on the boundary of the face A and the rest is outside the face A, or all of the line B is on the boundary of the face A.
Adjacent _ Faces Face to face Face A has only boundary intersection with face B.

Coincidence

Returns an object in the Layers for Query (point, line, surface, CAD) that exactly coincides with the Query Layer (point, line, surface), but the control points on the object may not be exactly the same.

Basic relationship:

Detailed description of coincidence operator:

Spatial Query Condition Query the relationship Illustration Explain
Coincident _ Dots Count and check Point coincidence.
Coincidence _ line line Line check line The lines coincide and the control points can be different.
Coincident _ Faces Face to face The faces are coincident and the control points can be different.

Intersect

Returns all Layers for Query objects (points, lines, faces) that intersect the Query Layer (points, lines, faces, text, CAD).

Basic relationship:

Detailed description of the intersection operator:

Spatial Query Condition Query the relationship Illustration Explain
Intersect _ Dots Count and check Point A coincides with point B.
Intersecting _ Dotted Lines Point check line Point A intersects line B.
Intersect _ Point _ Face Click and check the surface The point A intersects the face B.
Intersect _ Point Text Click on the text Point A coincides with text B.
Intersection _ Line Points Line check Line A intersects point B.
Intersect _ Line Line check line Line A intersects Line B.
Intersection _ Line _ Face Line check Line A intersects face B.
Intersection _ line text Check the text online Line A intersects text B.
Intersect _ Face Points Face check The face A intersects the point B.
Intersect _ Face Line Face check line Face A intersects line B.
Intersect _ Faces Faces Face to face The face A intersects the face B.
Intersect _ Face Text Face to face text The face A intersects the text B.
  • Basic relationship: Query Layer (A) overlaps with Layers for Query (B).
    • A has the same dimension as B.
      • The interior of
    • A intersects the interior of B (C) is not empty, the exterior of A crosses the interior of B, and the exterior of B crosses the interior of A.
      • The type of
    • C is still the same as that of A.
    • Query Layer (A) and Layers for Query (B) are separated, that is, there is no intersection.
    • Query Layer (A) interior and Layers for Query (B) interior intersection is empty and (A-interior and B-boundary intersection is not empty or A-boundary B-interior intersection is not empty or A-boundary and B-boundary intersection is not empty).
    • The types of
    • Query Layer (A) and Layers for Query (B) must be the same, and the intersection of A-interior and B-interior is not empty, the intersection of A-boundary and B-exterior is empty, the intersection of A-interior and B-exterior is empty, and the nodes can be different.
    • The query object (A) and the object to be queried (B) have an intersection.