Package: fireSenseUtils 0.2.3.9097

Eliot J B McIntire

fireSenseUtils: Utilities for Working With the 'fireSense' Group of 'SpaDES' Modules

Utilities for working with the 'fireSense' group of 'SpaDES' modules.

Authors:Jean Marchal [aut], Eliot J B McIntire [aut, cre], Alex M Chubaty [aut], Ian Eddy [aut]

fireSenseUtils_0.2.3.9097.tar.gz
fireSenseUtils_0.2.3.9060.zip(r-4.7-any)fireSenseUtils_0.2.3.9060.zip(r-4.6-any)fireSenseUtils_0.2.3.9060.zip(r-4.5-any)
fireSenseUtils_0.2.3.9060.tgz(r-4.6-any)fireSenseUtils_0.2.3.9060.tgz(r-4.5-any)
fireSenseUtils_0.2.3.9060.tar.gz(r-4.7-any)fireSenseUtils_0.2.3.9097.tar.gz(r-4.6-any)
fireSenseUtils_0.2.3.9097.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
fireSenseUtils/json (API)

# Install 'fireSenseUtils' in R:
install.packages('fireSenseUtils', repos = c('https://predictiveecology.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/predictiveecology/firesenseutils/issues

On CRAN:

Conda:

5.03 score 1 stars 5 scripts 178 exports 128 dependencies

Last updated from:95f8d319e4 (on development). Checks:7 FAIL, 2 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develFAIL177
source / vignettesOK770
linux-releaseFAIL203
macos-releaseFAIL167
macos-oldrelFAIL226
windows-develFAIL126
windows-releaseFAIL152
windows-oldrelFAIL132
wasm-releaseOK225

Exports:.doDataChecks.objfunSpreadFitaddBufferEdgeadWeightAutoannualStackToDTx1000assertCovariateRangeassessFuelClassesbestByReplicatedMeanbufferEdgebufferToAreabufferToAreaRastcalcNonForestYoungAgecalcYoungAgecastCohortDatachk_duplicatedStartPixelschooseDomSecFuelClassescleanUpSpreadFirePointsclimateCovRangesclimateRasterToDataTablecoefIdentifiabilitycohortsToFuelClassescombinePlanscombineSpreadProbSummariescovsX1000AndSetDFdataYearElementdataYearFordefaultFireYearsdeoptimPopulationSizedtReplaceNAwith0ELFfireCountsELFfireOverlayELFfitStatusELFflammableAreaelfLabelsELFmergedNameELFmergePlanELFneighboursELFregionStatsELFrunNameELFsArcticELFsExcludedELFsInStudyAreaELFsizePlanELFsSkippedELFtemplateRasteremptySpreadCovariatesescapedFiresescapeSizePixelsescapesTxtfewFireELFsfirePixelsByYearfireRecordShapefilefireSenseCloudParametersfireSenseCloudParametersMapfireSenseCovariatesCreatefireSenseFlammabilityThresholdfireSenseForestedLCCfireSenseFuelClassColfireSenseIgAggFactorfireSenseNonflammableLCCfireSenseNonForestCanBeYoungAgefireSenseRunawayEdgeFracfireSenseRunawayEdgeMinfireSenseSCANFIVersionfireSenseYoungAgeCutofffitConvergencefixedLogisticParsfuelClassPrepfuelLinearRangefuelLogToLineargetFirePoints_NFDBgetFirePoints_NFDB_V2getFirePolygonsharmonizeBufferAndPointsharmonizeFireDataharmonizeFireDataDepshindcastObservedhindcastSimulatedidentifiedInIsolationignitionFitAdditionalColNamesTxtignitionFitFilenameForignitionFitFileTagignitionFitLedgerFolderignitionsTxtigOrEscNamesisLinearFuelRangeisYoungAgelatestIgnitionFitslatestNBACUrllatestSpreadFitslccFlammableSharelinkSaturationlogistic2plogistic3plogistic3pUpperlogistic4plogistic5plogisticAlllogisticParamNameslogMinBmakeELFsmakeFireIDsmakeFireSenseLCCmakeFireSenseLCCDepsmakeLandcoverDTmakeLociListmakeMutuallyExclusivemakeTSDmergeELFsmergePreparedCovsmultipliernfdbPointUrlnonNFColNamesTxtomitNullArgsparamsSeparateplotBurnSummaryplotCumulativeBurnsplotELFsplotHindcastDistributionsplotHindcastMapplotHindcastSizesplotHistoricFiresplotSpreadFitResponseplotSpreadFitValidationpolygonIDTxtpredictIgnitionprepare_FuelCovsCoarseprepare_FuelCovsCoarseByYearprepare_ignitionClimateprepare_LightningDataprepareCovariatesOuterprofileCoefficientsputBackIntoRasterrasterFireBufferDTrasterFireSpreadPointsrbetaBetweenreadLightningDataremoveBufferedFiresOutsideRTMrescaleCovariatesrescaleKnown2rescaleVarsByMagnituderescorePopulationrunDEoptimrunELFsscoreFireSizessimulateFireSizessizeRuleLandCoverspreadCovCentrespreadCovColsspreadDesignColsspreadFitAdditionalColNamesspreadFitAdditionalColNamesTxtspreadFitCovCentreTxtspreadFitFilenameForspreadFitFileTagspreadFitLedgerFolderspreadFitValidationDataspreadFitWorkerMemoryGBspreadIndicatorColsspreadIndicatorRangesspreadInterceptTxtspreadProbCeilingspreadProbFloorspreadProbFromIntegerCovsspreadProbGatesspreadProbGateTestspreadProbSummarystackAndExtracttermsInDEoptimtoX1000treedWetlandAgbTxttreedWetlandTxtupdateStackYearNamesvisualizeDEyearTxtyoungAgeAtYearyoungAgeExclusiveColsyoungAgeTxt

Dependencies:abindamcaskpassbackportsbase64encbitopsbootcallrcheckmateclassclassIntcliclimateDataclusterscodetoolscowplotcpp11crayoncurldata.tableDBIDEoptimdigestdismodplyre1071EnvStatsfarverfastDummiesfasterizefilelockfireregimetoolsFormulafpComparefsgarglegenericsggplot2ggspatialgluegoogledrivegridExtragtablehmshttrhttr2igraphinsightisobandjpegjsonliteKernSmoothlabelingLandRlatticelifecyclelme4lobstrmagrittrMASSMatrixmimeminqaMuMInnlmenloptrnortestopensslotelpakparallellypatchworkpemiscpeutilspillarpkgconfigpngprettyunitsprocessxprogressproxypspurrrqs2quickPlotR6rappdirsrasterrbibutilsRColorBrewerRcppRcppArmadilloRcppEigenRcppParallelRCurlRdpackreformulasreproducibleRequireRhpcBLASctlrlangrosmrstudioapis2S7scalessfspSpaDES.coreSpaDES.toolsstringfishstringistringrsysterratibbletidyrtidyselecttidyterraunitsutf8uuidvctrsviridisviridisLitewhiskerwithrwk

fireSense tutorial
Introduction | Fit the statistical model of fire ignitions | Fit the statistical model of fire escapes | Fit the statistical model of the spread probabilities | Fit the statistical model of the fire size distribution | Produce the maps of the tapered Pareto parameters | Use predicted parameters of the tapered Pareto as inputs to the statistical model of the spread probabilities | Predict maps of fire ignition rates, escape and spread probabilities | Fire ignition rates | Fire escape probabilities | Fire spread probabilities | Run fireSense, finally! | Additional resources | References

Last update: 2026-09-29
Started: 2020-04-03

fireSense LCC flammability analysis
Compare LCC and fire data | Plot

Last update: 2026-09-01
Started: 2020-11-24

Readme and manuals

Help Manual

Help pageTopics
'fireSenseUtils' packagefireSenseUtils-package fireSenseUtils
Objective function for 'fireSense_spreadFit' module.objfunSpreadFit
Abbreviate species names for fuel classesabbreviateSpNames
Automatic weight for the Anderson-Darling termadWeightAuto
Convert list of annual 'SpatRaster' to 'data.table'annualStackToDTx1000 annualStackToDTx1000.list annualStackToDTx1000.Raster annualStackToDTx1000.SpatRaster
Assert that rescaled spread covariates are usableassertCovariateRange
Semi-automated selection of fuel classed based on GLMsassessFuelClasses
The edge ring of each fire's bufferaddBufferEdge bufferEdge
Create buffers around polygons based on area target for bufferbufferToArea bufferToArea.list bufferToArea.sf bufferToArea.SpatialPolygons
Create a variable sized buffer around a set of pixels belonging to the same fire IDbufferToAreaRast
Modify 'cohortData' with burn columnbuildCohortBurnHistory
Zero-out young non-forest pixels across LCC layers and add a 'youngAge' maskcalcNonForestYoungAge
Iteratively calculate 'youngAge' column in FS covariatescalcYoungAge
preparing covariates for fitting modulescastCohortData
Data checks and assertions for 'spreadFitRun'.doDataChecks chk_duplicatedStartPixels
Choose an ELF's dominant and secondary fuel classeschooseDomSecFuelClasses
Ensure fire points are located on flammable pixels inside a fire polygon Intended to be run using 'Map'cleanUpSpreadFirePoints
Fixed ranges of the spread covariatesclimateCovRanges
Converts stacks of climate rasters to data.table and optionally subsets to indexclimateRasterToDataTable
Classify 'pixelGroups' by flammabilitycohortsToFuelClasses
Merging and assignment of fuel classescombine_fuel_classes
Add the size merges to the fire-count plancombinePlans
Convert covariates to/from integers for smaller footprint; make 'data.frame'covsX1000AndSetDF
The data year a year's vegetation comes fromdataYearElement dataYearFor
Default fire years for the fireSense modulesdefaultFireYears
Default DEoptim population size for a fitdeoptimPopulationSize
Replace 'NA's in a 'data.table' with zerosdtReplaceNAwith0
Count fires in each ELFELFfireCounts
Clip fire polygons to each ELF, onceELFfireOverlay
Classify each ELF as zero, few or ok on its fire countsELFfitStatus
Measure flammable area in each ELFELFflammableArea
Text to print on ELFselfLabels
Name of a merged ELFELFmergedName
Decide which ELFs with too few fires to merge, and which not to fitELFmergePlan
Shared core borders between ELFsELFneighbours
Area, land cover and burn rate of each regionELFregionStats
The ELF to run for an ELF idELFrunName
ELFs permanently left out of fireSenseELFsArctic
ELFs that cannot be fittedELFsExcluded
Identify and rasterize Ecologically-based Low Fractal-dimensional objects within a study areaELFsInStudyArea
Merge regions that are too small with a similar neighbourELFsizePlan
ELFs not fitted after mergingELFsSkipped
Build a Canada-wide raster template for ELF constructionELFtemplateRaster
Spread covariates that carry no informationemptySpreadCovariates
Fires that escapedescapedFires
Pixels a fire must burn to count as escapedescapeSizePixels
Count fires per ELF and merge ELFs with too fewfewFireELFs
Pixel IDs burned in each yearfirePixelsByYear
Path to the shapefile in a fire-record archivefireRecordShapefile
Get current state of FireSense Fit parameters as a mapfireSenseCloudParameters
Get current state of FireSense Fit parameters as a mapfireSenseCloudParametersMap
Create FireSense Input CovariatesfireSenseCovariatesCreate
Non-flammable land-cover codes for the FireSense land coverfireSenseNonflammableLCC
Defaults shared by the fireSense modules and functionsfireSenseFlammabilityThreshold fireSenseForestedLCC fireSenseFuelClassCol fireSenseIgAggFactor fireSenseNonForestCanBeYoungAge fireSenseRunawayEdgeFrac fireSenseRunawayEdgeMin fireSenseSCANFIVersion fireSenseSharedDefaults fireSenseYoungAgeCutoff
Hard-coded name/text constantsescapesTxt fireSenseUtils-constants ignitionFitAdditionalColNamesTxt ignitionsTxt nonNFColNamesTxt polygonIDTxt spreadFitAdditionalColNamesTxt spreadFitCovCentreTxt spreadInterceptTxt treedWetlandAgbTxt treedWetlandTxt yearTxt youngAgeTxt
Diagnostics of a fitted spread modelcoefIdentifiability combineSpreadProbSummaries fitConvergence fitDiagnostics identifiedInIsolation linkSaturation profileCoefficients scoreFireSizes simulateFireSizes spreadProbSummary
The Google Drive folder of the shared fit ledgersfitLedgerFolders ignitionFitLedgerFolder spreadFitLedgerFolder
The logistic parameters fixed at 1, not fittedfixedLogisticPars
Calculate proportional burn of landcover and tree speciesfuelClassPrep
Range that puts linear fuel biomass on the scale the spread fit usesfuelLinearRange
Fuel biomass from the log scale back to the linear scalefuelLogToLinear
Get Fire 'SpatialPoints' from Canadian Fire DatabasegetFirePoints_NFDB
Get Fire 'SpatialPoints' from Canadian Fire DatabasegetFirePoints_NFDB_V2
Download and prepare fire data from National Fire DatabasegetFirePolygons
Cleaning up the polygon pointsharmonizeBufferAndPoints
Harmonize fire dataharmonizeFireData
Functions whose code affects what 'harmonizeFireData()' returnsharmonizeFireDataDeps
Observed fire in an ELF core in one yearhindcastObserved
One simulated year in an ELF corehindcastSimulated
The shared IgnitionFit ledger filesignitionFitFilenameFor ignitionFitFileTag latestIgnitionFits
Construct standardized FireSense object namesigOrEscNames
Was this covariate rescaled as linear fuel biomass?isLinearFuelRange
Is an age young?isYoungAge
Discover the URL of the most recent NBAC shapefile archivelatestNBACUrl
Each land-cover class's share of an ELF's flammable pixelslccFlammableShare
Multiple-parameter versions of logistic functionslogistic2p logistic3p logistic3pUpper logistic4p logistic5p logisticAll
Logistic parameter nameslogisticParamNames
Log with a minimumlogMinB
Make Ecologically-based Low Fractal-Dimensional polygonsmakeELFs plotELFs
Identify each year's individual fires and buffer them accordinglymakeFireIDs
Prepare NTEMS Land Cover Data for Fire Simulation ModelsmakeFireSenseLCC
Functions whose code affects what 'makeFireSenseLCC()' returnsmakeFireSenseLCCDeps
Wrapper on 'glm' that creates separate GLMs for each item in fuelmakeGLM
Create 'landcoverDT' object to classify and track non-forest land cover classesmakeLandcoverDT
Convert a list of 'SpatialPointsDataFrame' object to a list of 'data.table' objectsmakeLociList
guarantees mutually exclusive values in a data tablemakeMutuallyExclusive
Put 'cohortData' back into a 'SpatRaster' with some extra detailsmakeRastersFromCD
Prepare a time since disturbance map from stand age and fire datamakeTSD
Merge ELF maps as plannedmergeELFs
Build ignition covariates table by stacking/extracting rasters and joining lightningmergePreparedCovs
Buffer-size multiplier for fire footprintsmultiplier
URL of the National Fire Database point archivenfdbPointUrl
Names of the arguments that are 'NULL', to give to 'Cache(omitArgs =)'omitNullArgs
Split the character vector of parameters into 'covPars' and 'logisticPars'paramsSeparate
Plot burn summaryplotBurnSummary
Plot cumulative burn mapsplotCumulativeBurns
Simulated rep-years beside the observed yearplotHindcastDistributions
Burn-frequency map with the observed fires on topplotHindcastMap
Fire-size distribution, simulated and observedplotHindcastSizes
Plot historic ignitions, escapes, and area burnedplotHistoricFires
Predictions from ignition modelpredictIgnition
Create and aggregate fuel covariate rasters to a coarse resolutionprepare_FuelCovsCoarse
Fuel covariate rasters at a coarse resolution, with 'youngAge' resolved for each fire yearprepare_FuelCovsCoarseByYear
Aggregate and cache ignition-related climate rastersprepare_ignitionClimate
Prepare and cache lightning rasters from Google Drive sourcesprepare_LightningData
Prepare and (optionally) cache scaled covariates for modelingprepareCovariatesOuter
Rebuild land cover layers back into a SpatRastserputBackIntoRaster
this is a wrapper to simplify caching of 'lapply' with 'bufferForFireRaster'. Years are iteratively processed by 'makeFireID'.rasterFireBufferDT
Create a list of annual ignition points based on fire rasterrasterFireSpreadPoints
Generate random beta variates between 2 values and a meanrbetaBetween
Read lightning datareadLightningData
Remove buffered fires in 'fireBufferedListDT' that are outside 'flammableRTM'removeBufferedFiresOutsideRTM
Rescale/standardize covariates for modelingrescaleCovariates
rescale function no.2rescaleKnown2
Rescale a 'data.table' according to a named vector of rescalersrescaleVarsByMagnitude
Re-score a population with replication, and pick the best members by their meanbestByReplicatedMean rescorePopulation
Run 'DEoptim'runDEoptim termsInDEoptim
Run the ELFs module and return the ELF names or mapsrunELFs
Path to the land-cover map the size rule usessizeRuleLandCover
The centre of each covariate of a spread fit: its mean over the data the objective usesspreadCovCentre
The columns of the spread model's design, in the order of its coefficientsspreadCovCols spreadDesignCols
Default values for various thingsspreadFitAdditionalColNames
The shared SpreadFit ledger fileslatestSpreadFits spreadFitFilenameFor spreadFitFileTag
Compare a spread fit with the data it was fitted toplotSpreadFitResponse plotSpreadFitValidation spreadFitValidationData
Memory (GB) assumed per DEoptim worker before a fit has a memory recordspreadFitWorkerMemoryGB
Indicator covariates of the spread modelspreadIndicatorCols spreadIndicatorRanges
The spread-probability ceiling and floorspreadProbBounds spreadProbCeiling spreadProbFloor
Convert covariates from their 'x1000' integer to usable by spreadspreadProbFromIntegerCovs
Would parameter sets pass the objective's spreadProb gates in its first block of years?spreadProbGates
The objective's spread-probability gates, on one year's spreadProbspreadProbGateTest
Prepare covariate table with ignition year, fuel class, climate value, and land coverstackAndExtract
Convert numeric values to integers x 1000toX1000
Update name of layers in a climate raster stackupdateStackYearNames
Make histograms of 'DEoptim' object 'pars'visualizeDE
'youngAge' of pixels at one fire yearyoungAgeAtYear
Columns 'youngAge' is mutually exclusive withyoungAgeExclusiveCols