com.agisoft.metashape

Class CoordinateSystem

java.lang.Object

com.agisoft.metashape.CoordinateSystem

public class CoordinateSystem
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	swigCMemOwn

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static boolean	addGeoid(java.lang.String path) Register geoid model.
static Matrix4x4d	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.
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.
Matrix4x4d	localframe(Vector3d point) Returns 4x4 transformation matrix to LSE coordinates at the given point.
CoordinateSystem	makeGeocentric() Construct geocentric coordinate system using coordinate system datum.
CoordinateSystem	makeGeographic() Construct geographic coordinate system using coordinate system datum.
Vector3d	project(Vector3d point) Projects point from geocentric coordinates to projected geographic coordinate system.
static Vector3d	transform(Vector3d point, CoordinateSystem source, CoordinateSystem target) Transform point coordinates between coordinate systems.
static Matrix4x4d	transformationMatrix(Vector3d point, CoordinateSystem source, CoordinateSystem target) Local approximation of coordinate transformation from source to target coordinate system at the given point.
Vector3d	unproject(Vector3d 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

public CoordinateSystem(long cPtr,
                        boolean cMemoryOwn)

CoordinateSystem

public CoordinateSystem()

CoordinateSystem

public CoordinateSystem(CoordinateSystem crs)

Method Detail

getCPtr

public static long getCPtr(CoordinateSystem obj)

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object

delete

public void delete()

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 Vector3d project(Vector3d 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 Vector3d unproject(Vector3d 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 Matrix4x4d localframe(Vector3d 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 CoordinateSystem makeGeographic()

Construct geographic coordinate system using coordinate system datum.

Returns:

Geographic coordinate system, may be null.

makeGeocentric

public CoordinateSystem makeGeocentric()

Construct geocentric coordinate system using coordinate system datum.

Returns:

Geocentric coordinate system, may be null.

datumTransform

public static Matrix4x4d 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 Vector3d transform(Vector3d 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 Matrix4x4d transformationMatrix(Vector3d 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.