TStepJoint

class compas_timber.connections.TStepJoint[source]

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 elements are compatible for the creation of the joint.

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

from_json

Construct an object of this type from a JSON file.

from_jsonstring

Construct an object of this type from a JSON string.

get_face_most_ortho_to_beam

Of all the faces of beam_b, returns the one whose normal is most orthogonal to beam_a.

get_face_most_towards_beam

Of all the faces of beam_b, returns the one whose normal most faces beam_a.

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.