Skip to content

Commit

Permalink
[Backport release_3.34] More images to visualize expressions (#9122)
Browse files Browse the repository at this point in the history
  • Loading branch information
DelazJ authored May 24, 2024
2 parents 77287c7 + f310cfe commit 8991260
Show file tree
Hide file tree
Showing 11 changed files with 92 additions and 3 deletions.
54 changes: 54 additions & 0 deletions docs/user_manual/expressions/expression_help/GeometryGroup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1518,6 +1518,12 @@ Returns the portion of a line (or curve) geometry which falls between the specif
- * ``geom_to_wkt(line_substring(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),start_distance:=2,end_distance:=6))`` → 'LineString (2 0,6 0)'


.. 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.

.. end_line_substring_section
.. _expression_function_GeometryGroup_m:
Expand Down Expand Up @@ -2810,6 +2816,12 @@ Simplifies a geometry by removing nodes using a distance based threshold (ie, th
- * ``geom_to_wkt(simplify(geometry:=geom_from_wkt('LineString(0 0, 5 0.1, 10 0)'),tolerance:=5))`` → 'LineString(0 0, 10 0)'


.. 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

.. end_simplify_section
.. _expression_function_GeometryGroup_simplify_vw:
Expand Down Expand Up @@ -2944,6 +2956,12 @@ Constructs square/rectangular waves along the boundary of a geometry.
- * ``square_wave(geom_from_wkt('LineString(0 0, 10 0)'), 3, 1)`` → Square waves with wavelength 3 and amplitude 1 along the linestring


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

Symbolizing features with square waves

.. end_square_wave_section
.. _expression_function_GeometryGroup_square_wave_randomized:
Expand Down Expand Up @@ -2971,6 +2989,12 @@ Constructs randomized square/rectangular waves along the boundary of a geometry.
- * ``square_wave_randomized(geom_from_wkt('LineString(0 0, 10 0)'), 2, 3, 0.1, 0.2)`` → Randomly sized square waves with wavelengths between 2 and 3 and amplitudes between 0.1 and 0.2 along the linestring


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

Symbolizing features with square randomized waves

.. end_square_wave_randomized_section
.. _expression_function_GeometryGroup_start_point:
Expand Down Expand Up @@ -3161,6 +3185,12 @@ Constructs triangular waves along the boundary of a geometry.
- * ``triangular_wave(geom_from_wkt('LineString(0 0, 10 0)'), 3, 1)`` → Triangular waves with wavelength 3 and amplitude 1 along the linestring


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

Symbolizing features with triangular waves

.. end_triangular_wave_section
.. _expression_function_GeometryGroup_triangular_wave_randomized:
Expand Down Expand Up @@ -3188,6 +3218,12 @@ Constructs randomized triangular waves along the boundary of a geometry.
- * ``triangular_wave_randomized(geom_from_wkt('LineString(0 0, 10 0)'), 2, 3, 0.1, 0.2)`` → Randomly sized triangular waves with wavelengths between 2 and 3 and amplitudes between 0.1 and 0.2 along the linestring


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

Symbolizing features with triangular randomized waves

.. end_triangular_wave_randomized_section
.. _expression_function_GeometryGroup_union:
Expand Down Expand Up @@ -3234,6 +3270,12 @@ Constructs rounded (sine-like) waves along the boundary of a geometry.
- * ``wave(geom_from_wkt('LineString(0 0, 10 0)'), 3, 1)`` → Sine-like waves with wavelength 3 and amplitude 1 along the linestring


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

Symbolizing features with waves

.. end_wave_section
.. _expression_function_GeometryGroup_wave_randomized:
Expand Down Expand Up @@ -3261,6 +3303,12 @@ Constructs randomized curved (sine-like) waves along the boundary of a geometry.
- * ``wave_randomized(geom_from_wkt('LineString(0 0, 10 0)'), 2, 3, 0.1, 0.2)`` → Randomly sized curved waves with wavelengths between 2 and 3 and amplitudes between 0.1 and 0.2 along the linestring


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

Symbolizing features with randomized waves

.. end_wave_randomized_section
.. _expression_function_GeometryGroup_wedge_buffer:
Expand All @@ -3287,6 +3335,12 @@ Returns a wedge shaped buffer originating from a point geometry.
- * ``wedge_buffer(center:=geom_from_wkt('POINT(1 2)'),azimuth:=90,width:=180,outer_radius:=1)`` → A wedge shaped buffer centered on the point (1,2), facing to the East, with a width of 180 degrees and outer radius of 1.


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

Wedge buffering features

.. end_wedge_buffer_section
.. _expression_function_GeometryGroup_within:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,10 @@
"caption": "Interpolated point at 500m of the beginning of the line",
"img": "",
"alg_img": "interpolated_point" },
"expression_function_GeometryGroup_line_substring": {
"caption": "Substring line with starting distance set at 0 meters and the ending distance at 250 meters.",
"img": "",
"alg_img": "substring" },
"expression_function_GeometryGroup_offset_curve": {
"caption": "In blue the source layer, in red the offset one",
"img": "",
Expand All @@ -61,6 +65,10 @@
"caption": "Rotating features",
"img": "rotate",
"alg_img": "" },
"expression_function_GeometryGroup_simplify": {
"caption": "From left to right, source layer and increasing simplification tolerances",
"img": "",
"alg_img": "simplify_geometries" },
"expression_function_GeometryGroup_single_sided_buffer": {
"caption": "Left versus right side buffer on the same vector line layer",
"img": "",
Expand All @@ -69,12 +77,40 @@
"caption": "Increasing number of iterations causes smoother geometries",
"img": "",
"alg_img": "smooth_geometry_1" },
"expression_function_GeometryGroup_square_wave": {
"caption": "Symbolizing features with square waves",
"img": "square_wave",
"alg_img": "" },
"expression_function_GeometryGroup_square_wave_randomized": {
"caption": "Symbolizing features with square randomized waves",
"img": "square_wave_randomized",
"alg_img": "" },
"expression_function_GeometryGroup_tapered_buffer": {
"caption": "Tapered buffer on line features",
"img": "",
"alg_img": "tapered_buffer" },
"expression_function_GeometryGroup_translate": {
"caption": "Translating features",
"img": "",
"alg_img": "translate_geometry" }
"alg_img": "translate_geometry" },
"expression_function_GeometryGroup_triangular_wave": {
"caption": "Symbolizing features with triangular waves",
"img": "triangular_wave",
"alg_img": "" },
"expression_function_GeometryGroup_triangular_wave_randomized": {
"caption": "Symbolizing features with triangular randomized waves",
"img": "triangular_wave_randomized",
"alg_img": "" },
"expression_function_GeometryGroup_wave": {
"caption": "Symbolizing features with waves",
"img": "wave",
"alg_img": "" },
"expression_function_GeometryGroup_wave_randomized": {
"caption": "Symbolizing features with randomized waves",
"img": "wave_randomized",
"alg_img": "" },
"expression_function_GeometryGroup_wedge_buffer": {
"caption": "Wedge buffering features",
"img": "",
"alg_img": "wedge_buffers" }
}
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.
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.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/user_manual/processing_algs/qgis/img/wedge_buffers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 1 addition & 2 deletions docs/user_manual/processing_algs/qgis/vectorgeometry.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6145,8 +6145,7 @@ distance based (the "Douglas-Peucker" algorithm), area based
.. figure:: img/simplify_geometries.png
:align: center

Clockwise from top left: source layer and increasing
simplification tolerances
From left to right, source layer and increasing simplification tolerances

|checkbox| Allows :ref:`features in-place modification <processing_inplace_edit>`
of line and polygon features
Expand Down

0 comments on commit 8991260

Please sign in to comment.