Scribd
Upload
9 views

Synopsis: ST - Affine ST - Rotatey ST - Rotatez

This document contains sections about three PostGIS functions - ST_RotateX, ST_RotateY, and ST_RotateZ. Each section provides the synopsis, description, availability notes, and examples for rotating geometries around the X, Y, or Z axis by a given number of radians. Rotations are performed using affine transformations. The functions support 3D geometries and were renamed from RotateX/Y/Z to ST_RotateX/Y/Z in version 1.2.2 of PostGIS.

Uploaded by

Mathias Eder
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
9 views

Synopsis: ST - Affine ST - Rotatey ST - Rotatez

This document contains sections about three PostGIS functions - ST_RotateX, ST_RotateY, and ST_RotateZ. Each section provides the synopsis, description, availability notes, and examples for rotating geometries around the X, Y, or Z axis by a given number of radians. Rotations are performed using affine transformations. The functions support 3D geometries and were renamed from RotateX/Y/Z to ST_RotateX/Y/Z in version 1.2.2 of PostGIS.

Uploaded by

Mathias Eder
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 2

PostGIS 1.5.

1 Manual
131 / 315

Synopsis
geometry ST_RotateX(geometry geomA, float rotRadians);

Description
Rotate a geometry geomA - rotRadians about the X axis.
Note

ST_RotateX(geomA, rotRadians) is short-hand for ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0).

Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2


This function supports 3d and will not drop the z-index.

Examples
--Rotate a line 90 degrees along x-axis
SELECT ST_AsEWKT(ST_RotateX(ST_GeomFromEWKT(LINESTRING(1 2 3, 1 1 1)), pi()/2));
st_asewkt
--------------------------LINESTRING(1 -3 2,1 -1 1)

See Also
ST_Affine, ST_RotateY, ST_RotateZ

7.5.17 ST_RotateY
Name
ST_RotateY Rotate a geometry rotRadians about the Y axis.

Synopsis
geometry ST_RotateY(geometry geomA, float rotRadians);

Description
Rotate a geometry geomA - rotRadians about the y axis.
Note

ST_RotateY(geomA, rotRadians) is short-hand for ST_Affine(geomA, cos(rotRadians), 0,


sin(rotRadians), 0, 1, 0, -sin(rotRadians), 0, cos(rotRadians), 0, 0, 0).

Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2


This function supports 3d and will not drop the z-index.

PostGIS 1.5.1 Manual


132 / 315

Examples
--Rotate a line 90 degrees along y-axis
SELECT ST_AsEWKT(ST_RotateY(ST_GeomFromEWKT(LINESTRING(1 2 3, 1 1 1)), pi()/2));
st_asewkt
--------------------------LINESTRING(3 2 -1,1 1 -1)

See Also
ST_Affine, ST_RotateX, ST_RotateZ, Rotate around Point, Create Ellipse functions

7.5.18 ST_RotateZ
Name
ST_RotateZ Rotate a geometry rotRadians about the Z axis.

Synopsis
geometry ST_RotateZ(geometry geomA, float rotRadians);

Description
Rotate a geometry geomA - rotRadians about the Z axis.
Note

ST_RotateZ(geomA, rotRadians) is short-hand for SELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0,
0).

Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2

Note
Prior to 1.3.4, this function crashes if used with geometries that contain CURVES. This is fixed in 1.3.4+

This function supports 3d and will not drop the z-index.


This method supports Circular Strings and Curves

Examples

You might also like