Add HDF5 Composite CAE import and export methods (#646)

Add methods for importing from / exporting to the HDF5 Composite CAE format.

Nested messages in the API are defined as dataclasses. The alternative would be to expose them in a flat way, but I think the same reasoning for nesting them as in the API applies here: The nested structure is slightly easier to parse.

Closes #598.

.flake8

@@ -3,5 +3,5 @@ exclude = venv, __init__.py, doc/_build
 select = W191, W291, W293, W391, E115, E117, E122, E124, E125, E225, E231, E301, E303, E501, F401, F403
 count = True
 max-complexity = 10
-max-line-length = 110
+max-line-length = 115
 statistics = True

doc/source/api/enum_types.rst

@@ -34,6 +34,8 @@ Enumeration data types
     LayupMappingRosetteSelectionMethod
     LinkedObjectHandling
     LookUpTable3DInterpolationAlgorithm
+    HDF5CompositeCAEImportMode
+    HDF5CompositeCAEProjectionMode
     LookUpTableColumnValueType
     MeshImportType
     NodalDataType

doc/source/api/index.rst

@@ -15,6 +15,7 @@ and attributes.
     linked_object_definitions
     material_property_sets
     enum_types
+    other_types
     plot_utils
     other_utils
     workflow

doc/source/api/other_types.rst

@@ -0,0 +1,14 @@
+Other types
+-----------
+
+.. currentmodule:: ansys.acp.core
+
+.. autosummary::
+    :toctree: _autosummary
+
+    CoordinateTransformation
+    ImportedSolidModelExportSettings
+    ShellMappingProperties
+    SolidMappingProperties
+    SolidModelExportSettings
+    DropOffSettings

doc/source/api/tree_objects.rst

@@ -14,7 +14,6 @@ ACP objects
     CutOffGeometry
     CutoffSelectionRule
     CylindricalSelectionRule
-    DropOffSettings
     EdgeSet
     ElementSet
     ExtrusionGuide
@@ -26,7 +25,6 @@ ACP objects
     ImportedModelingPly
     ImportedProductionPly
     ImportedSolidModel
-    ImportedSolidModelExportSettings
     InterfaceLayer
     LayupMappingObject
     LookUpTable1D
@@ -47,7 +45,6 @@ ACP objects
     SnapToGeometry
     SolidElementSet
     SolidModel
-    SolidModelExportSettings
     SphericalSelectionRule
     Stackup
     SubLaminate

src/ansys/acp/core/__init__.py

@@ -52,6 +52,7 @@
     ButtJointSequence,
     CADComponent,
     CADGeometry,
+    CoordinateTransformation,
     CutOffGeometry,
     CutOffGeometryOrientationType,
     CutoffMaterialHandling,
@@ -87,6 +88,8 @@
     GeometricalSelectionRule,
     GeometricalSelectionRuleElementalData,
     GeometricalSelectionRuleNodalData,
+    HDF5CompositeCAEImportMode,
+    HDF5CompositeCAEProjectionMode,
     IgnorableEntity,
     ImportedAnalysisPly,
     ImportedModelingGroup,
@@ -146,11 +149,13 @@
     SectionCutType,
     Sensor,
     SensorType,
+    ShellMappingProperties,
     SnapToGeometry,
     SnapToGeometryOrientationType,
     SolidElementSet,
     SolidElementSetElementalData,
     SolidElementSetNodalData,
+    SolidMappingProperties,
     SolidModel,
     SolidModelElementalData,
     SolidModelExportFormat,
@@ -205,6 +210,7 @@
     "CADComponent",
     "CADGeometry",
     "ConnectLaunchConfig",
+    "CoordinateTransformation",
     "CutOffGeometry",
     "CutOffGeometryOrientationType",
     "CutoffMaterialHandling",
@@ -231,6 +237,7 @@
     "ElementSetNodalData",
     "ElementTechnology",
     "example_helpers",
+    "ExportSettings",
     "ExtrusionGuide",
     "ExtrusionGuideType",
     "ExtrusionMethod",
@@ -247,6 +254,8 @@
     "get_directions_plotter",
     "get_dpf_unit_system",
     "get_model_tree",
+    "HDF5CompositeCAEImportMode",
+    "HDF5CompositeCAEProjectionMode",
     "IgnorableEntity",
     "ImportedAnalysisPly",
     "ImportedModelingGroup",
@@ -313,11 +322,13 @@
     "SectionCutType",
     "Sensor",
     "SensorType",
+    "ShellMappingProperties",
     "SnapToGeometry",
     "SnapToGeometryOrientationType",
     "SolidElementSet",
     "SolidElementSetElementalData",
     "SolidElementSetNodalData",
+    "SolidMappingProperties",
     "SolidModel",
     "SolidModelElementalData",
     "SolidModelExportFormat",

src/ansys/acp/core/_tree_objects/__init__.py

@@ -118,7 +118,18 @@
 from .lookup_table_3d import LookUpTable3D
 from .lookup_table_3d_column import LookUpTable3DColumn
 from .material import Material
-from .model import FeFormat, IgnorableEntity, MeshData, Model, ModelElementalData, ModelNodalData
+from .model import (
+    FeFormat,
+    HDF5CompositeCAEImportMode,
+    HDF5CompositeCAEProjectionMode,
+    IgnorableEntity,
+    MeshData,
+    Model,
+    ModelElementalData,
+    ModelNodalData,
+    ShellMappingProperties,
+    SolidMappingProperties,
+)
 from .modeling_group import ModelingGroup
 from .modeling_ply import ModelingPly, ModelingPlyElementalData, ModelingPlyNodalData, TaperEdge
 from .oriented_selection_set import (
@@ -161,6 +172,7 @@
     TubeSelectionRuleElementalData,
     TubeSelectionRuleNodalData,
 )
+from .utils import CoordinateTransformation
 from .variable_offset_selection_rule import (
     VariableOffsetSelectionRule,
     VariableOffsetSelectionRuleElementalData,
@@ -181,6 +193,7 @@
     "ButtJointSequence",
     "CADComponent",
     "CADGeometry",
+    "CoordinateTransformation",
     "CutOffGeometry",
     "CutOffGeometryOrientationType",
     "CutoffMaterialHandling",
@@ -217,6 +230,8 @@
     "GeometricalSelectionRule",
     "GeometricalSelectionRuleElementalData",
     "GeometricalSelectionRuleNodalData",
+    "HDF5CompositeCAEImportMode",
+    "HDF5CompositeCAEProjectionMode",
     "IgnorableEntity",
     "ImportedAnalysisPly",
     "ImportedModelingGroup",
@@ -279,11 +294,13 @@
     "SectionCutType",
     "Sensor",
     "SensorType",
+    "ShellMappingProperties",
     "SnapToGeometry",
     "SnapToGeometryOrientationType",
     "SolidElementSet",
     "SolidElementSetElementalData",
     "SolidElementSetNodalData",
+    "SolidMappingProperties",
     "SolidModel",
     "SolidModelElementalData",
     "SolidModelExportFormat",