TStepJoint

class compas_timber.connections.TStepJoint

Bases: Joint

Represents an T-Step type joint which joins two beams, one of them at it’s end (main) and the other one along it’s centerline (cross). Two or more cuts are is made on the main beam and a notch is made on the cross beam to fit the main beam.

This joint type is compatible with beams in T topology.

Please use TStepJoint.create() to properly create an instance of this class and associate it with a model.

Parameters:

main_beamBeam

First beam to be joined.

cross_beamBeam

Second beam to be joined.

step_shapeint

Shape of the step feature. 0: step, 1: heel, 2: double.

step_depthfloat

Depth of the step cut. Combined with a heel cut it generates a double step cut.

heel_depthfloat

Depth of the heel cut. Combined with a step cut it generates a double step cut.

tapered_heelbool

If True, the heel cut is tapered.

tenon_mortise_heightfloat

Height of the tenon (main beam) mortise (cross beam) of the Step Joint. If None, the tenon and mortise featrue is not created.

Attributes:

main_beamBeam

First beam to be joined.

cross_beamBeam

Second beam to be joined.

step_shapeint

Shape of the step feature. 0: step, 1: heel, 2: double.

step_depthfloat

Depth of the step cut. Combined with a heel cut it generates a double step cut.

heel_depthfloat

Depth of the heel cut. Combined with a step cut it generates a double step cut.

tapered_heelbool

If True, the heel cut is tapered.

tenon_mortise_heightfloat

Height of the tenon (main beam) mortise (cross beam) of the Step Joint. If None, the tenon and mortise featrue is not created.

Methods

add_extensions	Calculates and adds the necessary extensions to the beams.
add_features	Adds the required trimming features to both beams.
check_elements_compatibility	Checks if the cluster of beams complies with the requirements for the TStepJoint.
restore_beams_from_keys	After de-serialization, restores references to the main and cross beams saved in the model.
set_step_depths	Sets the default step and heel depths based on the joint type if they are not provided.

Inherited Methods

ToString	Converts the instance to a string.
copy	Make an independent copy of the data object.
create	Creates an instance of this joint and creates the new connection in model.
element_count_complies	Checks if the number of elements complies with the joint's requirements.
from_json	Construct an object of this type from a JSON file.
from_jsonstring	Construct an object of this type from a JSON string.
promote_cluster	Creates an instance of this joint from a cluster of elements.
promote_joint_candidate	Creates an instance of this joint from a joint candidate.
sha256	Compute a hash of the data for comparison during version control using the sha256 algorithm.
to_json	Convert an object to its native data representation and save it to a JSON file.
to_jsonstring	Convert an object to its native data representation and save it to a JSON string.
validate_data	Validate the data against the object's data schema.