Package 'ASGS.foyer'

Install a (nearly) complete package of the Australian Statistical Geography Standard

Description

The ASGS package provides a nearly comprehensive set of shapefiles, both unmodified and simplified from the Australian Bureau of Statistics. The ASGS package is over 700 MB, so cannot be hosted on CRAN. This function allows the package to be distributed almost as conveniently as through CRAN.

Should you find ASGS lacks some shapefile that you require, please file an issue requesting it be added.

Note that the package is quite large and provides no limits on access, so it is preferred that distribution occur as far as possible via other channels to ensure the method of access provided here is sustainable.

Usage

install_ASGS(
  temp.tar.gz = tempfile(fileext = ".tar.gz"),
  overwrite = FALSE,
  lib = .libPaths()[1],
  repos = getOption("repos"),
  type = getOption("pkgType", "source"),
  ...,
  .reinstalls = 4L,
  url.tar.gz = NULL,
  verbose = FALSE
)

Arguments

temp.tar.gz	A file to save the ASGS tarball after download. Since the package is quite large, it may be prudent to set this to a non-temporary file so that subsequent attempts to reinstall do not require additional downloads.
overwrite	(logical, default: FALSE). If temp.tar.gz already exists, should it be overwritten or should there be an error?
lib, repos, type	Passed to install.packages when installing ASGS's dependencies (if not already installed).
...	Other arguments passed to install.packages.
.reinstalls	Number of times to attempt to install any (absent) dependencies of ASGS before aborting. Try restarting R rather than setting this number too high.
url.tar.gz	The URL of the tarball to be downloaded. Not normally needed by users, but may be in case the link becomes fallow, and a new one becomes available before the release of a new package entirely. If set to special value "latest", an online file is consulted and set to the remote file there.
verbose	(logical, default: FALSE) Report logic paths?

Value

temp.tar.gz, invisibly.

---

Determine whether coordinates lie in a given statistical area.

Description

Determine whether coordinates lie in a given statistical area.

Usage

latlon2SA(
  lat,
  lon,
  to = c("STE", "SA2", "SA1", "SA3", "SA4"),
  yr = c("2016", "2011"),
  return = c("v", "sp"),
  NAME = TRUE,
  .shapefile = NULL
)

Arguments

lat, lon	Numeric vector representing coordinates in decimal degrees. Coordinates south of the equator have lat < 0.
to	The statistical area to convert to.
yr	The year of the statistical area.
return	Whether to return an atomic vector (v) representing the shapefile for each point lat, lon or a spatial points object from package sp.
NAME	(logical, default: TRUE) whether to use the name or number of the statistical area
.shapefile	If specified, an arbitrary shapefile containing the statistical areas to locate.

Value

The statistical area that contains each point.

Examples

latlon2SA(-35.3, 149.2, to = "STE", yr = "2016")

---

State shapefile

Description

State shapefile

Usage

STE_2016_simple

Format

An object of class SpatialPolygonsDataFrame with 9 rows and 4 columns.

---