compas.geometry.Shear

class compas.geometry.Shear(matrix=None)[source]

Bases: compas.geometry.transformations.transformation.Transformation

Create a shear transformation.

A point P is transformed by the shear matrix into P” such that the vector P-P” is parallel to the direction vector and its extent is given by the angle of P-P’-P”, where P’ is the orthogonal projection of P onto the shear plane.

Parameters

matrix (4x4 matrix-like, optional) – A 4x4 matrix (or similar) representing a shear transformation.

Raises

ValueError – If the default constructor is used, and the provided transformation matrix is not a shear matrix.

Examples

>>>

Methods

concatenate(other)	Concatenate another transformation to this transformation.
concatenated(other)	Concatenate two transformations into one Transformation.
copy()	Returns a copy of the transformation.
decomposed()	Decompose the Transformation into its Scale, Shear, Rotation, Translation and Projection components.
from_angle_direction_plane(angle, direction, …)	Parameters angle (float) – The angle in radians.
from_change_of_basis(frame_from, frame_to)	Computes a change of basis transformation between two frames.
from_data(data)	Creates a Transformation from a data dict.
from_entries(shear_entries)	Creates a Shear from the 3 factors for x-y, x-z, and y-z axes.
from_euler_angles(euler_angles[, static, …])	Construct a transformation from a rotation represented by Euler angles.
from_frame(frame)	Computes a transformation from world XY to frame.
from_frame_to_frame(frame_from, frame_to)	Computes a transformation between two frames.
from_json(filepath)	Construct an object from serialized data contained in a JSON file.
from_jsonstring(string)	Construct an object from serialized data contained in a JSON string.
from_list(numbers)	Creates a Transformation from a list of 16 numbers.
from_matrix(matrix)	Creates a Transformation from a 4x4 matrix-like object.
inverse()	Returns the inverse transformation.
invert()	Invert this transformation.
inverted()	Returns the inverse transformation.
to_data()	Convert a Transformation object to a data dict.
to_json(filepath[, pretty])	Serialize the data representation of an object to a JSON file.
to_jsonstring([pretty])	Serialize the data representation of an object to a JSON string.
transpose()	Transpose the matrix of this transformation.
transposed()	Create a transposed copy of this transformation.
validate_data()	Validate the object’s data against its data schema (self.DATASCHEMA).
validate_json()	Validate the object’s data against its json schema (self.JSONSCHEMA).

Attributes

DATASCHEMA	The schema of the data of this object.
JSONSCHEMA	The schema of the JSON representation of the data of this object.
basis_vectors	The basis vectors from the rotation component of the transformation matrix.
data	Return a Transformation object’s to a data dict.
determinant	The determinant of the matrix of the transformation.
dtype	The type of the object in the form of a “2-level” import and a class name.
guid	The globally unique identifier of the object.
list	Flattens the 4x4 transformation matrix into a list of 16 numbers.
name	The name of the object.
projection	The projection component of the transformation matrix.
rotation	The rotation component of the transformation matrix.
scale	The scale component of the transformation matrix.
shear	The shear component of the transformation matrix.
translation	The translation component of the transformation matrix.
translation_vector