PseudoAbsences

backgroundpoints(layer::T, n::Int; kwargs...) where {T <: SimpleSDMLayer}

Generates background points based on a layer that gives the weight of each cell in the final sample. The additional keywords arguments are passed to StatsBase.sample, which is used internally. This includes the replace keyword to determine whether sampling should use replacement.

pseudoabsencemask(::Type{BetweenDegrees}, presences::SDMLayer{Bool}; closer::Number = 1.0, further::Number=3.0)

Generates a mask for pseudo-absences where pseudo-absences can be in a band given by two distances (in degrees) of the original observation. Internally, this uses DegreesToEvent. All other keyword arguments are passed to pseudoabsencemask.

pseudoabsencemask(::Type{BetweenRadius}, presences::SDMLayer{Bool}; closer::Number = 10.0, further::Number=100.0)

Generates a mask for pseudo-absences where pseudo-absences can be in a band given by two distances (in kilometers) of the original observation. Internally, this uses DistanceToEvent. All other keyword arguments are passed to pseudoabsencemask.

pseudoabsencemask( ::Type{DegreesToEvent}, presences::SDMLayer{Bool}; f = minimum, absolute::Bool = false)

Generates a mask for pseudo-absences using the distance to event method. Candidate cells are weighted according to their distance to a known observation, with far away places being more likely. The f function is used to determine which distance is reported (minimum by default, but can be any other relevant function). The distance is measured in degrees, and is therefore very sensitive to the projection / position.

When absolute is false (the default), the distance is measured as the absolute difference in coordinates instead of using the Euclidean distance.

pseudoabsencemask( ::Type{DistanceToEvent}, presences::SDMLayer{Bool}; f = minimum, )

Generates a mask for pseudo-absences using the distance to event method. Candidate cells are weighted according to their distance to a known observation, with far away places being more likely. Depending on the distribution of distances, it may be a very good idea to flatten this layer using log or an exponent. The f function is used to determine which distance is reported (minimum by default, but can be any other relevant function).

pseudoabsencemask(::Type{RandomSelection}, presences::SDMLayer{Bool})

Generates a mask for pseudo-absences using the random selection method. Candidate cells for the pseudo-absence mask are (i) within the bounding box of the layer (use SurfaceRangeEnvelope to use the presences bounding box), and (ii) valued in the layer.

pseudoabsencemask(::Type{SurfaceRangeEnvelope}, presences::SDMLayer{Bool})

Generates a mask from which pseudo-absences can be drawn, by picking cells that are (i) within the bounding box of occurrences, (ii) valued in the layer, and (iii) not already occupied by an occurrence

pseudoabsencemask(::Type{WithinDegrees}, presences::SDMLayer{Bool}; distance::Number = 3.0, )

Generates a mask for pseudo-absences where pseudo-absences can be within a distance (in degrees) of the original observation. Internally, this uses DegreesToEvent. All other keyword arguments are passed to pseudoabsencemask.

pseudoabsencemask(::Type{WithinRadius}, presences::SDMLayer{Bool}; distance::Number = 100.0, )

Generates a mask for pseudo-absences where pseudo-absences can be within a distance (in kilometers) of the original observation. Internally, this uses DistanceToEvent. All other keyword arguments are passed to pseudoabsencemask.

pseudoabsencemask(::Type{WithoutDegrees}, presences::SDMLayer{Bool}; distance::Number = 3.0, )

Generates a mask for pseudo-absences where pseudo-absences can be outside of a distance (in degrees) of the original observation. Internally, this uses DegreesToEvent. All other keyword arguments are passed to pseudoabsencemask.

pseudoabsencemask(::Type{WithoutRadius}, presences::SDMLayer{Bool}; distance::Number = 100.0, )

Generates a mask for pseudo-absences where pseudo-absences can be outside of a distance (in kilometers) of the original observation. Internally, this uses DistanceToEvent. All other keyword arguments are passed to pseudoabsencemask.

BetweenDegrees

Equivalent of BetweenRadius with the distance measured in degrees.

BetweenRadius

Generates pseudo-absences within two set radii (in kilometers) around each occurrence. Internally, this relies on DistanceToEvent.

DegreesToEvent

Generates a weight for the pseudo-absences based on the distance to cells with a true value. The distances are measured as the Euclidean distance expressed in degrees around the point.

DistanceToEvent

Generates a weight for the pseudo-absences based on the distance to cells with a true value. The distances are always measured in km using the haversine formula.

PseudoAbsenceGenerator

Abstract type to which all of the pseudo-absences generator types belong. Note that the pseudo-absence types are singleton types, and the arguments are passed when generating the pseudo-absence mask.

RandomSelection

Generates pseudo-absences at random within the layer. The full extent is considered, and cells with a true value cannot be part of the background sample.

SurfaceRangeEnvelope

Generates pseudo-absences at random within the geographic range covered by actual occurrences. Cells with presences cannot be part of the background sample.

WithinDegrees

Equivalent of WithinRadius with the distance measured in degrees.

WithinRadius

Generates pseudo-absences within a set radius (in kilometers) around each occurrence. Internally, this relies on DistanceToEvent.

WithoutDegrees

Equivalent of WithoutRadius with the distance measured in degrees.

WithoutRadius

Generates pseudo-absences outside of a set radius (in kilometers) around each occurrence. Internally, this relies on DistanceToEvent.