com.agisoft.metashape

Class CoordinateSystem

java.lang.Object

com.agisoft.metashape.CoordinateSystem

All Implemented Interfaces:

java.lang.AutoCloseable

public class CoordinateSystem
extends java.lang.Object
implements java.lang.AutoCloseable

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	swigCMemOwn

Constructor Summary

Constructors

Modifier	Constructor and Description
	CoordinateSystem()
	CoordinateSystem(CoordinateSystem crs)
protected	CoordinateSystem(long cPtr, boolean cMemoryOwn)

Method Summary

Modifier and Type	Method and Description
static boolean	addGeoid(java.lang.String path) Register geoid model.
void	close()
static java.util.Optional<Matrix>	datumTransform(CoordinateSystem source, CoordinateSystem target) Coordinate transformation from source to target coordinate system datum.
void	delete()
protected void	finalize()
java.lang.String	getAuthority() Authority identifier of the coordinate system.
protected static long	getCPtr(CoordinateSystem obj)
java.lang.String	getProj4() Coordinate system definition in PROJ.4 format.
java.lang.String	getWkt() Coordinate system definition in WKT format.
boolean	init(java.lang.String wkt) Initialize projection based on specified WKT definition or authority identifier.
Matrix	localframe(Vector point) Returns 4x4 transformation matrix to LSE coordinates at the given point.
java.util.Optional<CoordinateSystem>	makeGeocentric() Construct geocentric coordinate system using coordinate system datum.
java.util.Optional<CoordinateSystem>	makeGeographic() Construct geographic coordinate system using coordinate system datum.
Vector	project(Vector point) Projects point from geocentric coordinates to projected geographic coordinate system.
static Vector	transform(Vector point, CoordinateSystem source, CoordinateSystem target) Transform point coordinates between coordinate systems.
static Matrix	transformationMatrix(Vector point, CoordinateSystem source, CoordinateSystem target) Local approximation of coordinate transformation from source to target coordinate system at the given point.
Vector	unproject(Vector point) Unprojects point from projected coordinates to geocentric coordinates.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

swigCMemOwn

protected transient boolean swigCMemOwn

Constructor Detail

CoordinateSystem

protected CoordinateSystem(long cPtr,
                           boolean cMemoryOwn)

CoordinateSystem

public CoordinateSystem()

CoordinateSystem

public CoordinateSystem(CoordinateSystem crs)

Method Detail

getCPtr

protected static long getCPtr(CoordinateSystem obj)

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object

delete

public void delete()

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

getAuthority

public java.lang.String getAuthority()

Authority identifier of the coordinate system.

getWkt

public java.lang.String getWkt()

Coordinate system definition in WKT format.

getProj4

public java.lang.String getProj4()

Coordinate system definition in PROJ.4 format.

init

public boolean init(java.lang.String wkt)

Initialize projection based on specified WKT definition or authority identifier.

Parameters:

wkt - WKT definition of coordinate system or authority identifier.

project

public Vector project(Vector point)

Projects point from geocentric coordinates to projected geographic coordinate system.

Parameters:

point - 3D point in geocentric coordinates.

Returns:

3D point in projected coordinates.

unproject

public Vector unproject(Vector point)

Unprojects point from projected coordinates to geocentric coordinates.

Parameters:

point - 3D point in projected coordinate system.

Returns:

3D point in geocentric coordinates.

localframe

public Matrix localframe(Vector point)

Returns 4x4 transformation matrix to LSE coordinates at the given point.

Parameters:

point - Coordinates of the origin in the geocentric coordinates.

Returns:

Transformation from geocentric coordinates to local coordinates.

makeGeographic

public java.util.Optional<CoordinateSystem> makeGeographic()

Construct geographic coordinate system using coordinate system datum.

Returns:

Geographic coordinate system, may be null.

makeGeocentric

public java.util.Optional<CoordinateSystem> makeGeocentric()

Construct geocentric coordinate system using coordinate system datum.

Returns:

Geocentric coordinate system, may be null.

datumTransform

public static java.util.Optional<Matrix> datumTransform(CoordinateSystem source,
                                                        CoordinateSystem target)

Coordinate transformation from source to target coordinate system datum.

Parameters:

source - Source coordinate system.

target - Target coordinate system.

Returns:

Transformation matrix, may be null.

transform

public static Vector transform(Vector point,
                               CoordinateSystem source,
                               CoordinateSystem target)

Transform point coordinates between coordinate systems.

Parameters:

point - Point coordinates.

source - Source coordinate system.

target - Target coordinate system.

Returns:

Transformed point coordinates.

transformationMatrix

public static Matrix transformationMatrix(Vector point,
                                          CoordinateSystem source,
                                          CoordinateSystem target)

Local approximation of coordinate transformation from source to target coordinate system at the given point.

Parameters:

point - Point coordinates.

source - Source coordinate system.

target - Target coordinate system.

Returns:

Transformation matrix.

addGeoid

public static boolean addGeoid(java.lang.String path)

Register geoid model.

Parameters:

path - Path to geoid file.