Skip to content

Commit

Permalink
More images (review) for expression and algs (#9126)
Browse files Browse the repository at this point in the history
Backports #9125
  • Loading branch information
DelazJ authored May 29, 2024
2 parents c987630 + a78f231 commit 02563da
Show file tree
Hide file tree
Showing 34 changed files with 6,766 additions and 2,329 deletions.
72 changes: 45 additions & 27 deletions docs/user_manual/expressions/expression_help/GeometryGroup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@ Returns the geometry after an affine transformation. Calculations are in the Spa

.. figure:: /docs/user_manual/processing_algs/qgis/img/affinetransform.png
:align: center
:width: 100%

Vector point layer (green dots) before (left), and after (right) an affine transformation (translation).

Expand Down Expand Up @@ -201,7 +200,6 @@ Returns the closure of the combinatorial boundary of the geometry (ie the topolo

.. figure:: /docs/user_manual/processing_algs/qgis/img/boundary_polygon.png
:align: center
:width: 100%

Boundary (black dashed line) of the source polygon layer

Expand All @@ -228,7 +226,6 @@ Returns a geometry which represents the bounding box of an input geometry. Calcu

.. figure:: /docs/user_manual/processing_algs/qgis/img/bounding_box.png
:align: center
:width: 100%

Black lines represent the bounding boxes of each polygon feature

Expand Down Expand Up @@ -303,7 +300,6 @@ Returns a geometry that represents all points whose distance from this geometry

.. figure:: /docs/user_manual/processing_algs/qgis/img/buffer.png
:align: center
:width: 100%

Buffer (in yellow) of points, line, polygon with positive buffer, and polygon with negative buffer

Expand Down Expand Up @@ -332,7 +328,6 @@ Creates a buffer along a line geometry where the buffer diameter varies accordin

.. figure:: /docs/user_manual/processing_algs/qgis/img/variable_buffer_m.png
:align: center
:width: 100%

Buffering line features using the m value on the vertices

Expand All @@ -358,7 +353,6 @@ Returns the geometric center of a geometry.

.. figure:: /docs/user_manual/processing_algs/qgis/img/centroids.png
:align: center
:width: 100%

The red stars represent the centroids of the features of the input layer.

Expand Down Expand Up @@ -489,6 +483,11 @@ Returns a possibly concave polygon that contains all the points in the geometry
- * ``geom_to_wkt(concave_hull(geom_from_wkt('MULTILINESTRING((106 164,30 112,74 70,82 112,130 94,130 62,122 40,156 32,162 76,172 88),(132 178,134 148,128 136,96 128,132 108,150 130,170 142,174 110,156 96,158 90,158 88),(22 64,66 28,94 38,94 68,114 76,112 30,132 10,168 18,178 34,186 52,184 74,190 100,190 122,182 148,178 170,176 184,156 164,146 178,132 186,92 182,56 158,36 150,62 150,76 128,88 118))'), 0.99))`` → 'Polygon ((30 112, 36 150, 92 182, 132 186, 176 184, 190 122, 190 100, 186 52, 178 34, 168 18, 132 10, 112 30, 66 28, 22 64, 30 112))'


.. figure:: /docs/user_manual/processing_algs/qgis/img/concave_hull_threshold.png
:align: center

Concave hulls with increasing target_percent parameter

.. end_concave_hull_section
.. _expression_function_GeometryGroup_contains:
Expand Down Expand Up @@ -531,6 +530,11 @@ Returns the convex hull of a geometry. It represents the minimum convex geometry
- * ``geom_to_wkt( convex_hull( geom_from_wkt( 'LINESTRING(3 3, 4 4, 4 10)' ) ) )`` → 'POLYGON((3 3, 4 10, 4 4, 3 3))'


.. figure:: /docs/user_manual/processing_algs/qgis/img/convex_hull.png
:align: center

Black lines identify the convex hull for each feature

.. end_convex_hull_section
.. _expression_function_GeometryGroup_crosses:
Expand Down Expand Up @@ -576,7 +580,6 @@ Takes a polygon or line layer geometry and generates a new one in which the geom

.. figure:: /docs/user_manual/processing_algs/qgis/img/densify_geometry.png
:align: center
:width: 100%

Red points show the vertices before and after the densify

Expand All @@ -603,7 +606,6 @@ Takes a polygon or line layer geometry and generates a new one in which the geom

.. figure:: /docs/user_manual/processing_algs/qgis/img/densify_geometry_interval.png
:align: center
:width: 100%

Densify geometry at a given interval

Expand Down Expand Up @@ -712,6 +714,11 @@ Returns the last node from a geometry.
- * ``geom_to_wkt(end_point(geom_from_wkt('LINESTRING(4 0, 4 2, 0 2)')))`` → 'Point (0 2)'


.. figure:: /docs/user_manual/expressions/expression_help/img/end_point.*
:align: center

End point of a line feature

.. end_end_point_section
.. _expression_function_GeometryGroup_exif_geotag:
Expand Down Expand Up @@ -755,6 +762,11 @@ Extends the start and end of a linestring geometry by a specified amount. Lines
* ``geom_to_wkt(extend(geom_from_wkt('MultiLineString((0 0, 1 0, 1 1), (2 2, 0 2, 0 5))'),1,2))`` → 'MultiLineString ((-1 0, 1 0, 1 3),(3 2, 0 2, 0 7))'


.. figure:: /docs/user_manual/processing_algs/qgis/img/extend_lines.png
:align: center

The red dashes represent the initial and final extension of the original layer

.. end_extend_section
.. _expression_function_GeometryGroup_exterior_ring:
Expand All @@ -775,6 +787,11 @@ Returns a line string representing the exterior ring of a polygon geometry. If t
- * ``geom_to_wkt(exterior_ring(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),( 0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2, 0.1, 0.1 0.1))')))`` → 'LineString (-1 -1, 4 0, 4 2, 0 2, -1 -1)'


.. figure:: /docs/user_manual/expressions/expression_help/img/exterior_ring.*
:align: center

The dashed line represents the exterior ring of the polygon

.. end_exterior_ring_section
.. _expression_function_GeometryGroup_extrude:
Expand All @@ -798,6 +815,11 @@ Returns an extruded version of the input (Multi-)Curve or (Multi-)Linestring geo
* ``geom_to_wkt(extrude(geom_from_wkt('MultiLineString((1 2, 3 2), (4 3, 8 3))'), 1, 2))`` → 'MultiPolygon (((1 2, 3 2, 4 4, 2 4, 1 2)),((4 3, 8 3, 9 5, 5 5, 4 3)))'


.. figure:: /docs/user_manual/expressions/expression_help/img/extrude.*
:align: center

Generating a polygon by extruding a line with offset in x and y directions

.. end_extrude_section
.. _expression_function_GeometryGroup_flip_coordinates:
Expand Down Expand Up @@ -1450,7 +1472,6 @@ Returns the point interpolated by a specified distance along a linestring geomet

.. figure:: /docs/user_manual/processing_algs/qgis/img/interpolated_point.png
:align: center
:width: 100%

Interpolated point at 500m of the beginning of the line

Expand Down Expand Up @@ -1520,7 +1541,6 @@ Returns the portion of a line (or curve) geometry which falls between the specif

.. figure:: /docs/user_manual/processing_algs/qgis/img/substring.png
:align: center
:width: 100%

Substring line with starting distance set at 0 meters and the ending distance at 250 meters.

Expand Down Expand Up @@ -1942,6 +1962,11 @@ Returns the minimal enclosing circle of a geometry. It represents the minimum ci
* ``geom_to_wkt( minimal_circle( geom_from_wkt( 'MULTIPOINT(1 2, 3 4, 3 2)' ), 4 ) )`` → 'Polygon ((3 4, 3 2, 1 2, 1 4, 3 4))'


.. figure:: /docs/user_manual/processing_algs/qgis/img/minimum_enclosing_circles.png
:align: center

Minimal enclosing circle of each feature

.. end_minimal_circle_section
.. _expression_function_GeometryGroup_nodes_to_points:
Expand All @@ -1966,6 +1991,11 @@ Returns a multipoint geometry consisting of every node in the input geometry.
* ``geom_to_wkt(nodes_to_points(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))'),true))`` → 'MultiPoint ((-1 -1),(4 0),(4 2),(0 2))'


.. figure:: /docs/user_manual/processing_algs/qgis/img/extract_nodes.png
:align: center

Multi-point feature extracted from vertices

.. end_nodes_to_points_section
.. _expression_function_GeometryGroup_num_geometries:
Expand Down Expand Up @@ -2078,7 +2108,6 @@ Returns a geometry formed by offsetting a linestring geometry to the side. Dista

.. figure:: /docs/user_manual/processing_algs/qgis/img/offset_lines.png
:align: center
:width: 100%

In blue the source layer, in red the offset one

Expand Down Expand Up @@ -2129,7 +2158,6 @@ Returns a geometry which represents the minimal oriented bounding box of an inpu

.. figure:: /docs/user_manual/processing_algs/qgis/img/oriented_minimum_bounding_box.png
:align: center
:width: 100%

Oriented minimum bounding box

Expand Down Expand Up @@ -2556,7 +2584,6 @@ Calculates the approximate pole of inaccessibility for a surface, which is the m

.. figure:: /docs/user_manual/processing_algs/qgis/img/pole_inaccessibility.png
:align: center
:width: 100%

Pole of inaccessibility

Expand Down Expand Up @@ -2649,7 +2676,6 @@ Reverses the direction of a line string by reversing the order of its vertices.

.. figure:: /docs/user_manual/processing_algs/qgis/img/reverse_line.png
:align: center
:width: 100%

Reversing line direction

Expand Down Expand Up @@ -2681,7 +2707,6 @@ Returns a rotated version of a geometry. Calculations are in the Spatial Referen

.. figure:: /docs/user_manual/expressions/expression_help/img/rotate.*
:align: center
:width: 100%

Rotating features

Expand Down Expand Up @@ -2818,7 +2843,6 @@ Simplifies a geometry by removing nodes using a distance based threshold (ie, th

.. figure:: /docs/user_manual/processing_algs/qgis/img/simplify_geometries.png
:align: center
:width: 100%

From left to right, source layer and increasing simplification tolerances

Expand Down Expand Up @@ -2874,7 +2898,6 @@ Returns a geometry formed by buffering out just one side of a linestring geometr

.. figure:: /docs/user_manual/processing_algs/qgis/img/single_side_buffer.png
:align: center
:width: 100%

Left versus right side buffer on the same vector line layer

Expand Down Expand Up @@ -2927,7 +2950,6 @@ Smooths a geometry by adding extra nodes which round off corners in the geometry

.. figure:: /docs/user_manual/processing_algs/qgis/img/smooth_geometry_1.png
:align: center
:width: 100%

Increasing number of iterations causes smoother geometries

Expand Down Expand Up @@ -2958,7 +2980,6 @@ Constructs square/rectangular waves along the boundary of a geometry.

.. figure:: /docs/user_manual/expressions/expression_help/img/square_wave.*
:align: center
:width: 100%

Symbolizing features with square waves

Expand Down Expand Up @@ -2991,7 +3012,6 @@ Constructs randomized square/rectangular waves along the boundary of a geometry.

.. figure:: /docs/user_manual/expressions/expression_help/img/square_wave_randomized.*
:align: center
:width: 100%

Symbolizing features with square randomized waves

Expand All @@ -3015,6 +3035,11 @@ Returns the first node from a geometry.
- * ``geom_to_wkt(start_point(geom_from_wkt('LINESTRING(4 0, 4 2, 0 2)')))`` → 'Point (4 0)'


.. figure:: /docs/user_manual/expressions/expression_help/img/start_point.*
:align: center

Starting point of a line feature

.. end_start_point_section
.. _expression_function_GeometryGroup_straight_distance_2d:
Expand Down Expand Up @@ -3084,7 +3109,6 @@ Creates a buffer along a line geometry where the buffer diameter varies evenly o

.. figure:: /docs/user_manual/processing_algs/qgis/img/tapered_buffer.png
:align: center
:width: 100%

Tapered buffer on line features

Expand Down Expand Up @@ -3156,7 +3180,6 @@ Returns a translated version of a geometry. Calculations are in the Spatial Refe

.. figure:: /docs/user_manual/processing_algs/qgis/img/translate_geometry.png
:align: center
:width: 100%

Translating features

Expand Down Expand Up @@ -3187,7 +3210,6 @@ Constructs triangular waves along the boundary of a geometry.

.. figure:: /docs/user_manual/expressions/expression_help/img/triangular_wave.*
:align: center
:width: 100%

Symbolizing features with triangular waves

Expand Down Expand Up @@ -3220,7 +3242,6 @@ Constructs randomized triangular waves along the boundary of a geometry.

.. figure:: /docs/user_manual/expressions/expression_help/img/triangular_wave_randomized.*
:align: center
:width: 100%

Symbolizing features with triangular randomized waves

Expand Down Expand Up @@ -3272,7 +3293,6 @@ Constructs rounded (sine-like) waves along the boundary of a geometry.

.. figure:: /docs/user_manual/expressions/expression_help/img/wave.*
:align: center
:width: 100%

Symbolizing features with waves

Expand Down Expand Up @@ -3305,7 +3325,6 @@ Constructs randomized curved (sine-like) waves along the boundary of a geometry.

.. figure:: /docs/user_manual/expressions/expression_help/img/wave_randomized.*
:align: center
:width: 100%

Symbolizing features with randomized waves

Expand Down Expand Up @@ -3337,7 +3356,6 @@ Returns a wedge shaped buffer originating from a point geometry.

.. figure:: /docs/user_manual/processing_algs/qgis/img/wedge_buffers.png
:align: center
:width: 100%

Wedge buffering features

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
36 changes: 36 additions & 0 deletions docs/user_manual/expressions/expression_help/img/images_list.json
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,14 @@
"caption": "The red stars represent the centroids of the features of the input layer.",
"img": "",
"alg_img": "centroids" },
"expression_function_GeometryGroup_concave_hull": {
"caption": "Concave hulls with increasing target_percent parameter",
"img": "",
"alg_img": "concave_hull_threshold" },
"expression_function_GeometryGroup_convex_hull": {
"caption": "Black lines identify the convex hull for each feature",
"img": "",
"alg_img": "convex_hull" },
"expression_function_GeometryGroup_densify_by_count": {
"caption": "Red points show the vertices before and after the densify",
"img": "",
Expand All @@ -37,6 +45,22 @@
"caption": "Densify geometry at a given interval",
"img": "",
"alg_img": "densify_geometry_interval" },
"expression_function_GeometryGroup_end_point": {
"caption": "End point of a line feature",
"img": "end_point",
"alg_img": "" },
"expression_function_GeometryGroup_extend": {
"caption": "The red dashes represent the initial and final extension of the original layer",
"img": "",
"alg_img": "extend_lines" },
"expression_function_GeometryGroup_exterior_ring": {
"caption": "The dashed line represents the exterior ring of the polygon",
"img": "exterior_ring",
"alg_img": "" },
"expression_function_GeometryGroup_extrude": {
"caption": "Generating a polygon by extruding a line with offset in x and y directions",
"img": "extrude",
"alg_img": "" },
"expression_function_GeometryGroup_line_interpolate_point": {
"caption": "Interpolated point at 500m of the beginning of the line",
"img": "",
Expand All @@ -45,6 +69,14 @@
"caption": "Substring line with starting distance set at 0 meters and the ending distance at 250 meters.",
"img": "",
"alg_img": "substring" },
"expression_function_GeometryGroup_minimal_circle": {
"caption": "Minimal enclosing circle of each feature",
"img": "",
"alg_img": "minimum_enclosing_circles" },
"expression_function_GeometryGroup_nodes_to_points": {
"caption": "Multi-point feature extracted from vertices",
"img": "",
"alg_img": "extract_nodes" },
"expression_function_GeometryGroup_offset_curve": {
"caption": "In blue the source layer, in red the offset one",
"img": "",
Expand Down Expand Up @@ -85,6 +117,10 @@
"caption": "Symbolizing features with square randomized waves",
"img": "square_wave_randomized",
"alg_img": "" },
"expression_function_GeometryGroup_start_point": {
"caption": "Starting point of a line feature",
"img": "start_point",
"alg_img": "" },
"expression_function_GeometryGroup_tapered_buffer": {
"caption": "Tapered buffer on line features",
"img": "",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 02563da

Please sign in to comment.