generate_sat_rd: Generate satellite pads and roads for each CPF

View source: R/simulate_inf.R

generate_sat_rdR Documentation

Generate satellite pads and roads for each CPF

Description

generate_sat_rd simulates the location of satellite production pads as a function of relative estimated undiscovered oil, development restrictions, and the presence of waterbodies. These are then connected to their parent central processing facility (CPF) with roads using least cost paths, and the entire "anchor facility" is connected via roads to existing or previously simulated infrastructure.

Usage

generate_sat_rd(
  cpf.df,
  cpf.sp,
  pad.exist,
  exist.coords,
  oil.av.res,
  maxd2sat = 56327,
  mind2sat = 6437.4,
  n.sat = c(4, 8),
  n.iter = 100,
  alt.b.stranded.leases = NULL,
  tr.cost.alt.c.row = NULL,
  alt.d.TLnorth = NULL,
  tr.cost.alt,
  cost.map,
  road.res,
  rd.exist,
  tr.cost.alt.b.stranded = NULL,
  wd.loc,
  path.out,
  proj.info,
  scenario,
  z,
  i,
  debug.out = FALSE
)

Arguments

cpf.df

data.frame of CPF point locations. Created by generate_cpf.

cpf.sp

SpatialPoints object depicting CPF point locations. Created by generate_cpf.

pad.exist

SpatialPolygonsDataFrame of existing CPF and satellite gravel pad locations. Created by prep_general_inputs.

exist.coords

data.frame containing coordinates of existing infrastructure. Created by prep_general_inputs.

oil.av.res

Scenario-specific relative estimated undiscovered oil RasterLayer. Created by prep_scenario_inputs.

maxd2sat

Numeric value indicating the maximum allowed distance (m) from a CPF to an associated satellite production pad. Defaults to 56,327 m based on BLM (2019c) p.B-9.

mind2sat

Numeric value indicating the minimum allowed distance (m) between two satellite production pads, or a CPF and associated satellite production pad. Defaults to 6437.4 m, similar to what is seen in the Willow Master Development Plan (BLM 2019b).

n.sat

Desired number of satellite pads to be simulated per CPF. This can either be a fixed integer value or a range, c(min,max), from which a random value will be drawn each iteration using a uniform distribution. Defaults to a range of c(4, 8) satellites per CPF.

n.iter

Integer indicating the desired number of iterations to be run for each scenario. Defaults to 100.

alt.b.stranded.leases

RasterLayer identifying stranded lease locations under Alternative B. Created by prep_scenario_inputs. Optional, as this is only needed when running Alternative B.

tr.cost.alt.c.row

TransitionLayer for right-of-way (ROW) areas under Alternative C, accounting for connecting roads that are allowed within some of the 50% Teshekpuk Caribou Herd (TCH) calving kernel under this alternative. Created by prep_scenario_inputs. Optional, as this is only needed when running Alternative C.

alt.d.TLnorth

RasterLayer identifying available areas for development north of Teshekpuk Lake under Alternative D. Created by prep_scenario_inputs. Optional, as this is only needed when running Alternative D.

tr.cost.alt

Scenario-specific TransitionLayer indicating road development cost. Created by prep_scenario_inputs.

cost.map

RasterLayer indicating land and water areas, used in gravel pad simulation. Created by prep_general_inputs.

road.res

Scenario-specific road restriction RasterLayer. Created by prep_scenario_inputs.

rd.exist

SpatialLinesDataFrame object representing existing roads. Created by prep_general_inputs.

tr.cost.alt.b.stranded

TransitionLayer specific to the stranded leases in Alternative B. Created by prep_scenario_inputs.

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.

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.

debug.out

Logical indicator of whether intermediate infrastructure .csv files should be written out for the purpose of debugging code. Defaults to FALSE.

Value

List containing four objects: a data.frame of satellite pad locations (sat_df), SpatialPointsDataFrame of satellite pad locations (sat_spdf), data.frame of road coordinates (rd_df), and SpatialLines representation of road locations (rd_sl).

References

BLM [Bureau of Land Management] 2019b. Willow Master Development Plan Draft Environmental Impact Statement. Bureau of Land Management, U.S. Department of the Interior. Anchorage, AK, USA.

BLM 2019c. Arctic National Wildlife Refuge Coastal Plain Oil and Gas Leasing Program Final Environmental Impact Statement. Bureau of Land Management, U.S. Department of the Interior, Anchorage, AK, USA.


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