molding/feature_recognizer/feature_recognizer.java

Refer to the Molding Feature Recognizer Example

feature_group.java

// ****************************************************************************
//
// Copyright (C) 2008-2014, Roman Lygin. All rights reserved.
// Copyright (C) 2014-2026, CADEX. All rights reserved.
//
// This file is part of the Manufacturing Toolkit software.
//
// You may use this file under the terms of the BSD license as follows:
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
// * Redistributions of source code must retain the above copyright notice,
//   this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright notice,
//   this list of conditions and the following disclaimer in the documentation
//   and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
//
// ****************************************************************************
 
import cadex.*;
import cadex.mtk.*;
 
import java.text.DecimalFormat;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.Map;
import java.util.TreeMap;
import java.util.function.Consumer;
 
class FeatureComparator implements Comparator<MTKBase_Feature> {
    @Override
    public int compare(MTKBase_Feature theA, MTKBase_Feature theB) {
        MTKBase_FeatureComparator aComparator = new MTKBase_FeatureComparator();
        boolean anALessThanB = aComparator.Apply(theA, theB);
        if (anALessThanB) {
            return -1;
        }
        boolean aBLessThanA = aComparator.Apply(theB, theA);
        if (aBLessThanA) {
            return 1;
        }
        return 0;
    }
}
 
class Pair {
    public Pair(double theFirst, double theSecond) {
        this.First = theFirst;
        this.Second = theSecond;
    }
 
    public String toString() {
        return String.format("%f x %f", First, Second);
    }
 
    public double First;
    public double Second;
}
 
class Dimension {
    public Dimension(double theL, double theW, double theD) {
        this.L = theL;
        this.W = theW;
        this.D = theD;
    }
 
    public String toString() {
        return String.format("%f x %f x %f", L, W, D);
    }
 
    public double L;
    public double W;
    public double D;
}
 
class Direction {
    public Direction(double theX, double theY, double theZ) {
        this.X = theX;
        this.Y = theY;
        this.Z = theZ;
    }
 
    public String toString() {
        return "(" + FormattedString(X) + ", " + FormattedString(Y) + ", " + FormattedString(Z) + ")";
    }
 
    private String FormattedString(double theValue) {
        DecimalFormat aDF = new DecimalFormat("0.00");
        return aDF.format(theValue);
    }
 
    public double X;
    public double Y;
    public double Z;
}
 
class FeatureMap extends TreeMap<MTKBase_Feature, Long> {
    public FeatureMap() {
        super(new FeatureComparator());
    }
}
 
class FeatureGroupManager {
    public FeatureGroupManager() {
        myGroups = new ArrayList<FeatureGroup>();
    }
 
    public void AddFeature(String theGroupName, String theSubgroupName, boolean theHasParameters, MTKBase_Feature theFeature) {
        //find or create
        int aRes = -1;
        for (int i = 0; i < myGroups.size(); ++i) {
            FeatureGroup aGroup = myGroups.get(i);
            if (aGroup.myName == theGroupName) {
                aRes = i;
                break;
            }
        }
        if (aRes == -1) {
            myGroups.add(new FeatureGroup(theGroupName, theSubgroupName, theHasParameters));
            aRes = myGroups.size() - 1;
        }
 
        //update
        FeatureGroup aGroup = myGroups.get(aRes);
        FeatureMap aSubgroups = aGroup.myFeatureSubgroups;
        if (aSubgroups.containsKey(theFeature)) {
            aSubgroups.put(theFeature, aSubgroups.get(theFeature) + 1);
        } else {
            aSubgroups.put(theFeature, 1L);
        }
    }
 
    public void Print(String theFeatureType, Consumer<MTKBase_Feature> thePrintFeatureParameters) {
        Collections.sort(myGroups, new FeatureGroupComparator());
 
        long aTotalCount = 0;
        for (FeatureGroup aGroup : myGroups) {
            long aFeatureCount = aGroup.FeatureCount();
            aTotalCount += aFeatureCount;
 
            System.out.format("    %s: %d\n", aGroup.myName, aFeatureCount);
 
            if (!aGroup.myHasParameters) {
                continue;
            }
 
            String aSubgroupName = aGroup.mySubgroupName;
            for (Map.Entry<MTKBase_Feature, Long> aFeatureSubgroup : aGroup.myFeatureSubgroups.entrySet()) {
                System.out.format("        %d %s with\n", aFeatureSubgroup.getValue(), aSubgroupName);
                thePrintFeatureParameters.accept(aFeatureSubgroup.getKey());
            }
        }
 
        System.out.format("\n    Total %s: %d\n", theFeatureType, aTotalCount);
    }
 
    public static <T> void PrintFeatureParameter(String theName, T theValue, String theUnits) {
        System.out.format("          %s: %s %s\n", theName, theValue, theUnits);
    }
 
    private class FeatureGroup {
        public FeatureGroup(String theName, String theSubgroupName, boolean theHasParameters) {
            myName = theName;
            mySubgroupName = theSubgroupName;
            myHasParameters = theHasParameters;
            myFeatureSubgroups = new FeatureMap();
        }
 
        public long FeatureCount() {
            long aCount = 0;
            for (Map.Entry<MTKBase_Feature, Long> aFeatureSubgroup : myFeatureSubgroups.entrySet()) {
                aCount += aFeatureSubgroup.getValue();
            }
            return aCount;
        }
 
        public String myName;
        public String mySubgroupName;
        public boolean myHasParameters;
        public FeatureMap myFeatureSubgroups;
    }
 
    private class FeatureGroupComparator implements Comparator<FeatureGroup> {
        @Override
        public int compare(FeatureGroup theA, FeatureGroup theB) {
            String anAName = theA.myName;
            String aBName = theB.myName;
            if (anAName == aBName) {
                return 0;
            }
 
            FeatureMap anAFeatureSubgroups = theA.myFeatureSubgroups;
            FeatureMap aBFeatureSubgroups = theB.myFeatureSubgroups;
            if (anAFeatureSubgroups.isEmpty() || aBFeatureSubgroups.isEmpty()) {
                return anAName.compareTo(aBName);
            }
 
            MTKBase_Feature anAFeature = anAFeatureSubgroups.firstKey();
            MTKBase_Feature aBFeature = aBFeatureSubgroups.firstKey();
 
            FeatureComparator aFeatureComparator = new FeatureComparator();
            return aFeatureComparator.compare(anAFeature, aBFeature);
        }
    }
 
    private ArrayList<FeatureGroup> myGroups;
}

shape_processor.java

// ****************************************************************************
//
// Copyright (C) 2008-2014, Roman Lygin. All rights reserved.
// Copyright (C) 2014-2026, CADEX. All rights reserved.
//
// This file is part of the Manufacturing Toolkit software.
//
// You may use this file under the terms of the BSD license as follows:
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
// * Redistributions of source code must retain the above copyright notice,
//   this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright notice,
//   this list of conditions and the following disclaimer in the documentation
//   and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
//
// ****************************************************************************
 
import cadex.*;
import cadex.mtk.*;
import cadex.ModelData.*;
import cadex.Collections.*;
 
abstract class ShapeProcessor extends ModelElementVoidVisitor {
    public void Apply(Part thePart) {
        String aPartName = thePart.Name().IsEmpty() ? "noname" : thePart.Name().Data();
        BodyList aBodyList = thePart.Bodies();
        for (int i = 0; i < aBodyList.size(); ++i) {
            Body aBody = aBodyList.get(i);
 
            ShapeIterator aShapeIt = new ShapeIterator(aBody);
            while (aShapeIt.HasNext()) {
                Shape aShape = aShapeIt.Next();
 
                if (aShape.Type() == ShapeType.Solid) {
                    System.out.format("Part #%d [\"%s\"] - solid #%d has:\n", myPartIndex, aPartName, i);
                    ProcessSolid(Solid.Cast(aShape));
                } else if (aShape.Type() == ShapeType.Shell) {
                    System.out.format("Part #%d [\"%s\"] - shell #%d has:\n", myPartIndex, aPartName, i);
                    ProcessShell(Shell.Cast(aShape));
                }
            }
        }
 
        ++myPartIndex;
    }
 
    public abstract void ProcessSolid(Solid theSolid);
 
    public abstract void ProcessShell(Shell theShell);
 
    private long myPartIndex = 0;
}
 
abstract class SolidProcessor extends ModelElementVoidVisitor {
    public void Apply(Part thePart) {
        String aPartName = thePart.Name().IsEmpty() ? "noname" : thePart.Name().Data();
        // Looking for a suitable body
        BodyList aBodyList = thePart.Bodies();
        for (int i = 0; i < aBodyList.size(); ++i) {
            Body aBody = aBodyList.get(i);
 
            ShapeIterator aShapeIt = new ShapeIterator(aBody);
            while (aShapeIt.HasNext()) {
                Shape aShape = aShapeIt.Next();
 
                if (aShape.Type() == ShapeType.Solid) {
                    System.out.format("Part #%d [\"%s\"] - solid #%d has:\n", myPartIndex, aPartName, i);
                    ProcessSolid(Solid.Cast(aShape));
                }
            }
        }
 
        ++myPartIndex;
    }
 
    public abstract void ProcessSolid(Solid theSolid);
 
    private long myPartIndex = 0;
}
 
abstract class SolidAndMeshProcessor extends ModelElementVoidVisitor {
    public void Apply(Part thePart) {
        String aPartName = thePart.Name().IsEmpty() ? "noname" : thePart.Name().ToString();
 
        myShapeIndex = 0;
        BodyList aBodyList = thePart.Bodies();
        for (Body aBody : aBodyList) {
            if (MeshBody.CompareType(aBody)) {
                ProcessMeshBody(MeshBody.Cast(aBody), aPartName);
            } else if (SolidBody.CompareType(aBody)) {
                 System.out.format("Part #%d [\"%s\"] - solid #%d has:\n", myPartIndex, aPartName, myShapeIndex);
                 ProcessSolid(SolidBody.Cast(aBody).Solid(), aPartName);
                 myShapeIndex++;
            }
        }
 
        ++myPartIndex;
    }
 
    public abstract void ProcessSolid(Solid theSolid, String thePartName);
    public abstract void ProcessITS(IndexedTriangleSet theITS, String thePartName);
 
    private void ProcessMeshBody(MeshBody theMeshBody, String thePartName) {
        MeshShapeList aShapeList = theMeshBody.Shapes();
        for (MeshShape aMeshShape : aShapeList) {
            if (IndexedTriangleSet.CompareType(aMeshShape)) {
                System.out.format("Part #%d [\"%s\"] - ITS #%d has:\n", myPartIndex, thePartName, myShapeIndex);
                ProcessITS(IndexedTriangleSet.Cast(aMeshShape), thePartName);
                myShapeIndex++;
            }
        }
    }
 
    protected long myPartIndex = 0;
    protected long myShapeIndex = 0;
}

feature_recognizer.java

// ****************************************************************************
//
// Copyright (C) 2008-2014, Roman Lygin. All rights reserved.
// Copyright (C) 2014-2026, CADEX. All rights reserved.
//
// This file is part of the Manufacturing Toolkit software.
//
// You may use this file under the terms of the BSD license as follows:
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
// * Redistributions of source code must retain the above copyright notice,
//   this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright notice,
//   this list of conditions and the following disclaimer in the documentation
//   and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
//
// ****************************************************************************
 
import cadex.*;
import cadex.mtk.*;
import cadex.ModelData.*;
 
import java.util.HashMap;
import java.util.function.Consumer;
 
public class feature_recognizer {
    static {
        try {
            System.loadLibrary("MTKCore");
        } catch (UnsatisfiedLinkError e) {
            System.err.println("Native code library failed to load.\n" + e);
            System.exit(1);
        }
    }
 
    public static void main(String[] args) {
        if (args.length != 1) {
            System.out.println("Usage: " + " <input_file>, where:");
            System.out.println("    <input_file> is a name of the file to be read");
            System.out.println("");
            System.exit(1);
        }
 
        String aKey = MTKLicenseKey.Value();
 
        // Setup the runtime key
        if (!LicenseHelper.SetupRuntimeKey()) {
            System.exit(1);
        }
 
        try {
            LicenseManager.Activate(aKey);
        } catch (LicenseError theException) {
            LicenseManager.Deactivate();
            System.out.println("Failed to activate Manufacturing Toolkit license: " + theException.what());
            System.exit(1);
        }
 
        String aSource = args[0];
 
        Model aModel = new Model();
        ModelReader aReader = new ModelReader();
 
        // Reading the file
        if (!aReader.Read(new UTF16String(aSource), aModel)) {
            LicenseManager.Deactivate();
            System.out.println("Failed to read the file " + aSource);
            System.exit(1);
        }
        System.out.println("Model: " + aModel.Name() + "\n");
 
        PartProcessor aPartProcessor = new PartProcessor();
        ModelElementUniqueVisitor aVisitor = new ModelElementUniqueVisitor(aPartProcessor);
        aModel.Accept(aVisitor);
 
        LicenseManager.Deactivate();
    }
 
    static class PartProcessor extends SolidProcessor {
        public PartProcessor() {
        }
 
        public void ProcessSolid(Solid theSolid) {
            // Set up recognizer
            Molding_FeatureRecognizerParameters aRecognizerParameters = new Molding_FeatureRecognizerParameters();
            aRecognizerParameters.SetMaxRibThickness(30.0);
            aRecognizerParameters.SetMaxRibDraftAngle(0.2);
            aRecognizerParameters.SetMaxRibTaperAngle(0.1);
 
            Molding_FeatureRecognizer aRecognizer = new Molding_FeatureRecognizer(aRecognizerParameters);
            MTKBase_FeatureList aFeatureList = aRecognizer.Perform(theSolid);
            Report.PrintFeatures(aFeatureList);
        }
    }
 
    static class Report {
        public static void PrintFeatures(MTKBase_FeatureList theFeatureList) {
            FeatureGroupManager aManager = new FeatureGroupManager();
 
            //group by parameters to provide more compact information about features
            for (long i = 0; i < theFeatureList.Size(); ++i) {
                MTKBase_Feature aFeature = theFeatureList.Feature(i);
                if (Molding_ScrewBoss.CompareType(aFeature)) {
                    Molding_ScrewBoss aScrewBoss = Molding_ScrewBoss.Cast(aFeature);
                    aManager.AddFeature("Boss(es)", "Screw Boss(es)", true, aScrewBoss);
                } else if (MTKBase_Boss.CompareType(aFeature)) {
                    MTKBase_Boss aBoss = MTKBase_Boss.Cast(aFeature);
                    aManager.AddFeature("Boss(es)", "Boss(es)", true, aBoss);
                } else if (Molding_Rib.CompareType(aFeature)) {
                    Molding_Rib aRib = Molding_Rib.Cast(aFeature);
                    aManager.AddFeature("Rib(s)", "Rib(s)", true, aRib);
                }
            }
 
            Consumer<MTKBase_Feature> PrintFeatureParameters = (theFeature) ->
            {
                if (Molding_ScrewBoss.CompareType(theFeature)) {
                    Molding_ScrewBoss aScrewBoss = Molding_ScrewBoss.Cast(theFeature);
                    FeatureGroupManager.PrintFeatureParameter("outer radius", aScrewBoss.OuterRadius(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("inner radius", aScrewBoss.InnerRadius(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("draft angle", ToDegrees(aScrewBoss.DraftAngle()), "deg");
                } else if (MTKBase_Boss.CompareType(theFeature)) {
                    MTKBase_Boss aBoss = MTKBase_Boss.Cast(theFeature);
                    FeatureGroupManager.PrintFeatureParameter("length", aBoss.Length(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("height", aBoss.Height(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("width", aBoss.Width(), "mm");
                } else if (Molding_Rib.CompareType(theFeature)) {
                    Molding_Rib aRib = Molding_Rib.Cast(theFeature);
                    FeatureGroupManager.PrintFeatureParameter("length", aRib.Length(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("height", aRib.Height(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("thickness", aRib.Thickness(), "mm");
                    FeatureGroupManager.PrintFeatureParameter("draft angle", ToDegrees(aRib.DraftAngle()), "deg");
                }
            };
            aManager.Print("features", PrintFeatureParameters);
        }
 
        static double ToDegrees(double theAngleRad) {
            return theAngleRad * 180 / Math.PI;
        }
    }
}