generate_cpf: Simulate CPF locations

In tfullman/dia: Monte Carlo Development Simulation and Wildlife Impacts Analysis

Simulate CPF locations

Description

generate_cpf simulates the location of central processing facilities (CPFs) as a function of relative estimated undiscovered oil, development restrictions, and the presence of waterbodies. CPFs are "the operational center for long-term production" of an oilfield (BLM 2019a, p. B-6) so infrastructure simulation starts with CPFs. CPF locations approximate the locations of newly discovered oil accumulations suitable for development (Wilson et al. 2013).

Usage

generate_cpf(
  oil.im,
  n.cpf = c(3, 7),
  d2cpf = 35000,
  debug.out = FALSE,
  wd.loc,
  path.out,
  n.iter = 100,
  proj.info = NULL,
  scenario = NULL,
  z = NULL,
  i = NULL
)

Arguments

oil.im	Object of type "im" representing the relative likelihood of pad development as a function of relative undiscovered oil, development restrictions, and the presence of waterbodies. Created by prep_scenario_inputs.
n.cpf	Indicator of the desired number of CPFs to be generated. This can either be a single integer value, indicating a fixed number of CPFs, or a range c(min,max), from which a random value will be drawn using a uniform distribution. Defaults to c(3,7) to reflect a reasonable range of potential variability, depending on the number and distribution of undiscovered oil deposits.
d2cpf	Numeric value indicating the minimum allowed distance (m) between two central processing facilities (CPFs). Defaults to 35,000 m.
debug.out	Logical indicator of whether intermediate infrastructure .csv files should be written out for the purpose of debugging code. Defaults to FALSE.
wd.loc	Character string identifying the base directory containing both input and output data folders.
path.out	Character string identifying the relative path from the base directory (wd.loc) to where output data will be saved. Defaults to an "Output_Data" folder within the base folder.
n.iter	Integer indicating the desired number of iterations to be run for each scenario. Defaults to 100.
proj.info	Desired projection string in EPSG code format ("EPSG:XXXX"), common to all spatial objects in the analysis.
scenario	Vector of character strings identifying the scenarios being run.
z	Iterator value used by dia to specify the development scenario being analyzed.
i	Iterator value used by dia to run development simulation and impacts analyses in parallel, indicating the specific iteration being run.

Value

List containing a data.frame of simulated CPF locations (cpf_df), SpatialPoints object of CPF locations (cpf_sp), and integer indicating the number of simulated CPFs in the current iteration (tmp_n_cpf).

References

BLM [Bureau of Land Management] 2019a. National Petroleum Reserve in Alaska Draft Integrated Activity Plan and Environmental Impact Statement. Bureau of Land Management, U.S. Department of the Interior, Anchorage, AK, USA.

Wilson RR, Liebezeit JR, Loya WM. 2013. Accounting for uncertainty in oil and gas development impacts to wildlife in Alaska. Conservation Letters 6:350-358.

tfullman/dia documentation built on Oct. 17, 2023, 6:31 p.m.