Parameters for the Sharp Pattern

A vegetated and a bare zone separated by a sharp boundary.

Usage

pattern_sharp(boundary_position = 0.5)

Arguments

boundary_position

Numeric. Relative position of the horizontal vegetation boundary (if not rotated) from the top (0-1, default: 0.5).

Value

A named "landscape_params" list containing the supplied parameters.

See also

Other landscape creation: create_landscape(), create_landscapes(), pattern_bands(), pattern_bare(), pattern_clustered(), pattern_dense(), pattern_diffuse(), pattern_fingers(), pattern_gaps(), pattern_labyrinth(), pattern_random(), pattern_spots()

Valid values and batch sampling

A single value fixes a parameter. A length-2 vector is a range, sampled once per landscape by create_landscapes and rejected by create_landscape. The table below shows for each parameter:

valid values that create_landscape accepts, and sampled ranges that create_landscapes draws from once per landscape for any parameter left unset. The defaults shown in Usage therefore apply to create_landscape only. Ranges that scale with landscape size are shown for the default 100 by 100.

Parameter	Valid	Sampled
boundary_position	0 to 1	0.2 to 0.8

Examples

# A single landscape, with a fixed value
create_landscape("sharp", params = pattern_sharp(boundary_position = 0.3))
#> Landscape: <unnamed> [pattern: sharp]
#> -----------------------------------------
#> Dimensions: 100x100 (10000 cells)
#> Resolution: 1.0x1.0
#> Extent    : xmin=0.0, xmax=100.0, ymin=0.0, ymax=100.0
#> Values    : min=0.0, max=1.0
#> Parameters: width = 100, height = 100, boundary_position = 0.3, rotation = 0 

# A batch, with boundary_position drawn from a range once per landscape
create_landscapes(
  n = 4,
  patterns = "sharp",
  params_list = list(sharp = pattern_sharp(boundary_position = c(0.2, 0.8)))
)
#> ✔ Successfully generated all 4 training landscapes
#> $sharp_1_rot76
#> Landscape: "sharp_1_rot76" [pattern: sharp]
#> -----------------------------------------
#> Dimensions: 100x100 (10000 cells)
#> Resolution: 1.0x1.0
#> Extent    : xmin=0.0, xmax=100.0, ymin=0.0, ymax=100.0
#> Values    : min=0.0, max=1.0
#> Parameters: width = 100, height = 100, boundary_position = 0.730201113969088, rotation = 76 
#> 
#> $sharp_2_rot356
#> Landscape: "sharp_2_rot356" [pattern: sharp]
#> -----------------------------------------
#> Dimensions: 100x100 (10000 cells)
#> Resolution: 1.0x1.0
#> Extent    : xmin=0.0, xmax=100.0, ymin=0.0, ymax=100.0
#> Values    : min=0.0, max=1.0
#> Parameters: width = 100, height = 100, boundary_position = 0.525204385630786, rotation = 356 
#> 
#> $sharp_3_rot5
#> Landscape: "sharp_3_rot5" [pattern: sharp]
#> -----------------------------------------
#> Dimensions: 100x100 (10000 cells)
#> Resolution: 1.0x1.0
#> Extent    : xmin=0.0, xmax=100.0, ymin=0.0, ymax=100.0
#> Values    : min=0.0, max=1.0
#> Parameters: width = 100, height = 100, boundary_position = 0.643062900286168, rotation = 5 
#> 
#> $sharp_4_rot358
#> Landscape: "sharp_4_rot358" [pattern: sharp]
#> -----------------------------------------
#> Dimensions: 100x100 (10000 cells)
#> Resolution: 1.0x1.0
#> Extent    : xmin=0.0, xmax=100.0, ymin=0.0, ymax=100.0
#> Values    : min=0.0, max=1.0
#> Parameters: width = 100, height = 100, boundary_position = 0.657975327223539, rotation = 358 
#> 

# Rotation is an argument of create_landscape(), not a pattern parameter
create_landscape(
  "sharp",
  params = pattern_sharp(boundary_position = 0.3),
  rotation = 45
)
#> Landscape: <unnamed> [pattern: sharp]
#> -----------------------------------------
#> Dimensions: 100x100 (10000 cells)
#> Resolution: 1.0x1.0
#> Extent    : xmin=0.0, xmax=100.0, ymin=0.0, ymax=100.0
#> Values    : min=0.0, max=1.0
#> Parameters: width = 100, height = 100, boundary_position = 0.3, rotation = 45