proj

package module
v10.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 30, 2023 License: MIT Imports: 5 Imported by: 5

README

go-proj

GoDoc

Package go-proj provides an interface to PROJ.

Features

  • High performance bulk transformation of coordinates.
  • Idiomatic Go API, including complete error handling.
  • Supports PROJ versions 6 and upwards.
  • Compatible with all geometry libraries.
  • Automatically handles C memory management.
  • Well tested.

Install

$ go get github.com/twpayne/go-proj/v10

Example

func ExamplePJ_Forward() {
	pj, err := proj.NewCRSToCRS("EPSG:4326", "EPSG:3857", nil)
	if err != nil {
		panic(err)
	}

	// Convert Zürich's WGS84 latitude/longitude to Web Mercator.
	zurichEPSG4326 := proj.NewCoord(47.374444, 8.541111, 408, 0)
	zurichEPSG3857, err := pj.Forward(zurichEPSG4326)
	if err != nil {
		panic(err)
	}
	fmt.Printf("x=%.6f y=%.6f z=%.6f", zurichEPSG3857.X(), zurichEPSG3857.Y(), zurichEPSG3857.Z())
	// Output: x=950792.127329 y=6003408.475803 z=408.000000
}

Comparisons with other PROJ bindings

There are many existing bindings for PROJ. Generally speaking, these:

  • Only transform one coordinate a time, making them extremely slow when transforming large number of coordinates.

  • Are tied to a single geometry representation.

  • Do not handle errors during transformation.

  • Are no longer maintained.

These existing bindings include:

License

MIT

Documentation

Overview

Package proj provides an interface to PROJ. See https://proj.org.

Index

Examples

Constants

View Source 
const (
	VersionMajor = C.PROJ_VERSION_MAJOR
	VersionMinor = C.PROJ_VERSION_MINOR
	VersionPatch = C.PROJ_VERSION_PATCH
)

Version.

Variables

This section is empty.

Functions

This section is empty.

Types

type Area 

type Area struct {
	// contains filtered or unexported fields
}

An Area is an area.

func NewArea 

func NewArea(westLonDegree, southLatDegree, eastLonDegree, northLatDegree float64) *Area

NewArea returns a new Area.

func (*Area) Destroy 

func (a *Area) Destroy()

Destroy frees all resources associated with a.

type Bounds 

type Bounds struct {
	XMin float64
	YMin float64
	XMax float64
	YMax float64
}

type Context 

type Context struct {
	// contains filtered or unexported fields
}

A Context is a context.

func NewContext 

func NewContext() *Context

NewContext returns a new Context.

func (*Context) Destroy 

func (c *Context) Destroy()

Destroy frees all resources associated with c.

func (*Context) Lock added in v10.0.1 

func (c *Context) Lock()

func (*Context) New 

func (c *Context) New(definition string) (*PJ, error)

New returns a new PJ with the given definition.

func (*Context) NewCRSToCRS 

func (c *Context) NewCRSToCRS(sourceCRS, targetCRS string, area *Area) (*PJ, error)

NewCRSToCRS returns a new PJ from sourceCRS to targetCRS and optional area.

func (*Context) NewCRSToCRSFromPJ added in v10.1.0 

func (c *Context) NewCRSToCRSFromPJ(sourcePJ, targetPJ *PJ, area *Area, options string) (*PJ, error)

NewCRSToCRSFromPJ returns a new PJ from two CRSs.

func (*Context) NewFromArgs 

func (c *Context) NewFromArgs(args ...string) (*PJ, error)

NewFromArgs returns a new PJ from args.

func (*Context) Unlock added in v10.0.1 

func (c *Context) Unlock()

type Coord 

type Coord [4]float64

A coord is a coordinate.

func NewCoord 

func NewCoord(x, y, z, m float64) Coord

NewCoord returns a new Coord.

func (Coord) DegToRad 

func (c Coord) DegToRad() Coord

DegToRad returns a new Coord with the first two elements transformed from degrees to radians.

func (*Coord) M 

func (c *Coord) M() float64

M returns c's M coordinate.

func (Coord) RadToDeg 

func (c Coord) RadToDeg() Coord

RadToDeg returns a new Coord with the first two elements transformed from radians to degrees.

func (*Coord) X 

func (c *Coord) X() float64

X returns c's X coordinate.

func (*Coord) Y 

func (c *Coord) Y() float64

Y returns c's Y coordinate.

func (*Coord) Z 

func (c *Coord) Z() float64

Z returns c's Z coordinate.

type Direction 

type Direction C.PJ_DIRECTION

A Direction is a direction. 

const (
	DirectionFwd   Direction = C.PJ_FWD
	DirectionIdent Direction = C.PJ_IDENT
	DirectionInv   Direction = C.PJ_INV
)

Directions.

type Error 

type Error struct {
	// contains filtered or unexported fields
}

An Error is an error.

func (*Error) Error 

func (e *Error) Error() string

type PJ 

type PJ struct {
	// contains filtered or unexported fields
}

A PJ is a projection or a transformation.

func New added in v10.1.0 

func New(definition string) (*PJ, error)

New returns a PJ with the given definition.

func NewCRSToCRS 

func NewCRSToCRS(sourceCRS, targetCRS string, area *Area) (*PJ, error)

NewCRSToCRS returns a new PJ from sourceCRS to targetCRS and optional area.

func NewCRSToCRSFromPJ added in v10.1.0 

func NewCRSToCRSFromPJ(sourcePJ, targetPJ *PJ, area *Area, options string) (*PJ, error)

NewCRSToCRSFromPJ returns a new PJ from two CRSs.

func NewFromArgs added in v10.1.0 

func NewFromArgs(args ...string) (*PJ, error)

NewFromArgs returns a PJ with the given args.

func (*PJ) Destroy 

func (p *PJ) Destroy()

Destroy releases all resources associated with p.

func (*PJ) Forward 

func (p *PJ) Forward(coord Coord) (Coord, error)

Forward transforms coord in the forward direction.

Example 
pj, err := proj.NewCRSToCRS("EPSG:4326", "EPSG:3857", nil)
if err != nil {
	panic(err)
}

// Convert Zürich's WGS84 latitude/longitude to Web Mercator.
zurichEPSG4326 := proj.NewCoord(47.374444, 8.541111, 408, 0)
zurichEPSG3857, err := pj.Forward(zurichEPSG4326)
if err != nil {
	panic(err)
}
fmt.Printf("x=%.6f y=%.6f z=%.6f", zurichEPSG3857.X(), zurichEPSG3857.Y(), zurichEPSG3857.Z())

Output:

x=950792.127329 y=6003408.475803 z=408.000000

func (*PJ) ForwardArray 

func (p *PJ) ForwardArray(coords []Coord) error

ForwardArray transforms coorsd in the forward direction.

func (*PJ) ForwardBounds 

func (p *PJ) ForwardBounds(bounds Bounds, densifyPoints int) (Bounds, error)

ForwardBounds transforms bounds in the forward direction.

func (*PJ) ForwardFlatCoords 

func (p *PJ) ForwardFlatCoords(flatCoords []float64, stride, zIndex, mIndex int) error

ForwardFlatCoords transforms flatCoords in the forward direction.

func (*PJ) Geod 

func (p *PJ) Geod(a, b Coord) (float64, float64, float64)

Geod returns the distance, forward azimuth, and reverse azimuth between a and b.

func (*PJ) GetLastUsedOperation 

func (p *PJ) GetLastUsedOperation() (*PJ, error)

GetLastUsedOperation returns the operation used in the last call to Trans.

func (*PJ) Info 

func (p *PJ) Info() PJInfo

Info returns information about p.

func (*PJ) Inverse 

func (p *PJ) Inverse(coord Coord) (Coord, error)

Inverse transforms coord in the inverse direction.

func (*PJ) InverseArray 

func (p *PJ) InverseArray(coords []Coord) error

InverseArray transforms coorsd in the inverse direction.

func (*PJ) InverseBounds 

func (p *PJ) InverseBounds(bounds Bounds, densifyPoints int) (Bounds, error)

InverseBounds transforms bounds in the forward direction.

func (*PJ) InverseFlatCoords 

func (p *PJ) InverseFlatCoords(flatCoords []float64, stride, zIndex, mIndex int) error

InverseFlatCoords transforms flatCoords in the inverse direction.

func (*PJ) IsCRS added in v10.1.0 

func (p *PJ) IsCRS() bool

IsCRS returns whether p is a CRS.

func (*PJ) LPDist 

func (p *PJ) LPDist(a, b Coord) float64

LPDist returns the geodesic distance between a and b in geodetic coordinates.

func (*PJ) LPZDist 

func (p *PJ) LPZDist(a, b Coord) float64

LPZDist returns the geodesic distance between a and b in geodetic coordinates, taking height above the ellipsoid into account.q

func (*PJ) NormalizeForVisualization added in v10.1.0 

func (p *PJ) NormalizeForVisualization() (*PJ, error)

Returns a new PJ instance whose axis order is the one expected for visualization purposes. If the axis order of its source or target CRS is northing,easting, then an axis swap operation will be inserted. The axis order of geographic CRS will be longitude, latitude [,height], and the one of projected CRS will be easting, northing [, height]

func (*PJ) Trans 

func (p *PJ) Trans(direction Direction, coord Coord) (Coord, error)

Trans transforms a single Coord.

func (*PJ) TransArray 

func (p *PJ) TransArray(direction Direction, coords []Coord) error

TransArray transforms an array of Coords.

func (*PJ) TransBounds 

func (p *PJ) TransBounds(direction Direction, bounds Bounds, densifyPoints int) (Bounds, error)

func (*PJ) TransFlatCoords 

func (p *PJ) TransFlatCoords(direction Direction, flatCoords []float64, stride, zIndex, mIndex int) error

TransFlatCoords transforms an array of flat coordinates.

func (*PJ) TransGeneric 

func (p *PJ) TransGeneric(direction Direction, x *float64, sx, nx int, y *float64, sy, ny int, z *float64, sz, nz int, m *float64, sm, nm int) error

TransGeneric transforms a series of coordinates.

type PJInfo 

type PJInfo struct {
	ID          string
	Description string
	Definition  string
	HasInverse  bool
	Accuracy    float64
}

A PJInfo contains information about a Proj.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.