Tekla.ExtensionMethods 1.0.0.2

What is this?

Extension methods for Tekla's Open API.

But why?

The old way

ModelObjectSelector Selector = model.GetModelObjectSelector();

// The Old Way
foreach (ModelObject MO in Selector)
{
            Beam B = MO as Beam;
            if (B != null)
            {
            Solid solid = B.GetSolid();
            }
}   

The New Way:

            List<Solid> solids = Selector.GetAllObjects().ToTeklaList<Beam>().Select(b => b.GetSolid()).ToList();

The Ability To Transform via Matrices:

CoordinateSystem cs1 = getCoordinateSystem1();
CoordinateSystem cs2 = getCoordinateSystem2();

// move by operation
Beam beam1_moved_by_operation = beamFactory(startPointFactory(), endPointFactory(), "1"); // we need factory methods because the same points mutate
beam1_moved_by_operation.Insert();
Operation.MoveObject(beam1_moved_by_operation, cs1, cs2);
beam1_moved_by_operation.Select(); // gray       

But who wants to formulate a transformation by hand via coordinate system changes in your head.

What you really want to do is apply a matrix:

Beam beam2manuallyTransformed = beamFactory(startPointFactory(), endPointFactory(), "2"); // orange class string            
beam2manuallyTransformed.Insert();

Matrix final = BeamExtensions.FromObjectToObjectTransformationMatrix(cs1, cs2);
beam2manuallyTransformed.TransformByMutation(final);  // apply a matrix transformation
beam2manuallyTransformed.Modify();
beam2manuallyTransformed.Select(); // update memory                        
model.CommitChanges();

But you could apply any transformation that you wanted!

Matrix Extensions

Helper methods like so

Matrix m = new Matrix().RotateBy(Math.PI / 2, VectorExtensions.YAxis) 		    	              
                       .ThenDisplaceBy(new Vector().ToXaxisWCS());     // curry matrix operations

Point origin = new Point(1,0,0).Transform(m);

Did you catch that? You can apply the transformation to the point, rather than the point to the matrix:

Point newPoint = new Matrix().Transform(new Point(1,0,0));

// but I prefer calling the point, rather than the matrix e.g.
origin.Transform(m);

Ever wanted a simple projection?

 Vector diagonal = new Vector(1, 1, 0);
 Vector xVector = new Vector(1, 0, 0);

 Vector projectionVector = diagonal.ProjectOnto(xVector);

.... and a whole host of other helpers, particularly if you want to use matrices to transform objects.

Further handy helpers if you want to use text strings from users, in order to create grid lines.

Enjoy!

Documentation

Installation

// .net CLI
dotnet add package Tekla.ExtensionMethods

// PMC (Package Manager Console)
NuGet\Install-Package Tekla.ExtensionMethods 

Contributions

Contributions welcome!

If required, add a test.

Notes fo the Maintainer: Packing Instructions

• Build the solution
• Update: the assembly version in the csproj file.
• Update:

In Powershell:

D:\\Documents\\repositories\\TeklaProjects\\Tekla.ExtensionMethods\\Tekla.ExtensionMethods> nuget pack -Symbols -SymbolPackageFormat snupkg