reproj-package: reproj: Coordinate System Transformations for Generic Map...

reproj-packageR Documentation

reproj: Coordinate System Transformations for Generic Map Data

Description

Transform coordinates from a specified source to a specified target map projection. This uses the 'PROJ' library directly, by wrapping the 'PROJ' package which leverages 'libproj', otherwise the 'proj4' package. The 'reproj()' function is generic, methods may be added to remove the need for an explicit source definition. If 'proj4' is in use 'reproj()' handles the requirement for conversion of angular units where necessary. This is for use primarily to transform generic data formats and direct leverage of the underlying 'PROJ' library. (There are transformations that aren't possible with 'PROJ' and that are provided by the 'GDAL' library, a limitation which users of this package should be aware of.) The 'PROJ' library is available at https://proj.org/.

reproj provides helpers for easily reprojecting generic data, by depending on a reprojection engine (proj4 for now).

Details

The function reproj is designed to take an input data set x and then a target coordinate system specification. The source argument is not positional (must be named) and must be provided. The coordinate system string may be anything accepted by the PROJ library (libproj).

Methods are provided for data frame and matrix, add S3 methods for you classes in your own package. For classed objects, or objects with a known method for finding the 'source' coordinate system your method can provide that logic.

See reproj for global options to control assumptions about data that is input in longitude latitude form.

There is an option set at start up reproj.mock.noproj6 which is designed for testing the support in the PROJ package. Even if this package is functional this option can be set to true so that reproj falls-back to use the proj4 package instead.

Author(s)

Maintainer: Michael D. Sumner mdsumner@gmail.com (ORCID)

See Also

Useful links:


mdsumner/reproj documentation built on April 19, 2024, 1:18 p.m.