AVEVA Marine Reader

Supported Entities

Entities supported by the AVEVA Marine reader.
  • Plane panels
  • Curved panels
  • Knuckled panels
  • Plane plates
  • Curved plates
  • Pillars
  • Stiffeners (also with sub-flanges)
  • Curved stiffeners
  • Face plates (also with sub-flanges)
  • Flanges
  • Brackets
  • Doubling profiles
  • Hole profiles
  • Marking profiles
  • Seam profiles
  • Swage profiles
  • Tap profiles
When @CreationType = TreeOfComponents, an assembly tree is created and organized as follows:
  • 1 assembly corresponding to the whole ship (1 ship per part).
  • 1 assembly per block.
    • 1 assembly per PlanePanel.
      • 1 component for the detailed contour of the current PlanePanel (with relevant option).
      • 1 component for the simple contour of the current PlanePanel (with relevant option).
      • 1 component per PlanePlateGroup. The material name, material side, thickness and offset are created as metadata. If material data are available, a PSHELL material is created.
        • 1 surface per PlanePlate. The profile existing in the file is used for the external loop. Holes can be added as internal loops (with relevant option).
      • 1 component per PlanePillarGroup.
        • 1 set of trace lines per PlanePillar.
        • 1 surface per web (with relevant option).
      • 1 component per PlaneFlangeGroup.
        • 1 set of trace lines per PlaneFlange.
      • 1 component per PlaneStiffenerGroup.
        • 1 set of trace lines per PlaneStiffener.
        • 1 surface per web and per flange (with relevant option).
      • 1 component per PlaneFaceplateGroup.
        • 1 set of trace lines per PlaneFaceplate.
        • 1 surface per web and per flange (with relevant option).
      • 1 assembly per sub-PlanePanel. The contents correspond to the ones for normal PlanePanels.
      • 1 assembly per PlaneBracketGroup.
        • 1 component per bracket if no sub-elements exist (stiffeners, planeplates, flanges). 1 assembly if sub-elements exist.
          • 1 surface per PlaneBracket. The profile existing in the file is used for the external loop. No holes are allowed by the AVEVA Marine format. If sub-elements are present in the current PlaneBracketGroup, a specific component is created for the surface in order to keep it separate from its sub-elements.
        • 1 component per PlaneStiffenerGroup sub-element (no flanges inside the stiffener group are allowed).
        • 1 component per PlaneFaceplateGroup sub-element (no flanges inside the faceplate group are allowed).
        • 1 component per PlaneFlangeGroup sub-element.
      • 1 assembly per CurvedPanel.
        • 1 component for the simple contour of the current CurvedPanel (with relevant option).
        • 1 component per CurvedPlateGroup.
          • 1 surface per CurvedPlate. The profile existing in the file is used for the external loop. Internal holes are implemented.
        • 1 component per CurvedStiffenerGroup.
          • 1 set of trace lines per CurvedStiffener.
      • 1 assembly per KnuckledPanel.

When @CreationType is “Parts”, a corresponding tree is created but no assembly entities are created, parts are created instead. The components are also created.

When @CreationType is “BOM Only”, a corresponding tree is created with parts as in the previous case, but no components are actually created.

PlanePlates, CurvedPlates and PlaneBrackets are mapped as surfaces. Other objects are imported as curves, lying on the plates. Groups of objects may share similar properties (such as material, material side, thickness and offset). In this case, metadata are added to these objects, and if possible the material description is also created. Holes of curved surfaces are not taken into consideration for this release.

The reader instantiates objects in their nominal position, hence there may be gaps between panels, brackets, and so forth, due to idealizations that do not take thickness into account. Hence, no stitching between surfaces is performed on import.

Available material fields include Young's modulus, Poisson's ratio, expansion coefficient, and density. Yield stress and ultimate stress are not imported. Each material is associated with a unique grade name.

When a thickness is provided, the corresponding value is given to a property.

Objects affected by material/thickness include PlanePlateGroup, PlanePillarGroup, PlaneFlangeGroup, PlaneStiffenerGroup, PlaneFaceplateGroup, PlaneBracketGroup, CurvedPlateGroup and CurvedStiffenerGroup.

Import Options

The AVEVA Marine reader uses the aveva_reader.ini file.
@BodyIdAsMetadata
Value Description
on Assign body identifier as metadata.

BODY_ID
off Do not assign body identifier as metadata (default).
@CleanupTol
Value Description
double A negative value (default) indicates to use the auto cleanup tolerance. A value greater than the calculated auto cleanup tolerance indicates to use that specific tolerance. Refer to the CAD Cleanup Tolerance.
@ColorsAsMetadata
Value Description
integer

Read color attributes of geometric entities as metadata with integer values.

COLOR_RGB
on

Read color attributes of geometric entities as metadata.

COLOR_RGB
off Do not read color attributes (default).
@CreationType
Value Description
Parts Generate a full part-based hierarchy.
BOMOnly Generate an empty part-based hierarchy.
TreeOfComponents Generate an assemblies/components based hierarchy.
PackIntoSinglePart Consolidate hierarchy into a single part.
@CurvedPlateColor
Value Description
string A RGB description of the color to use for curved plates, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonCurvedPlateColor is corresponding to this option and still supported.
@CurvedSimpleContourColor
Value Description
string A RGB description of the color to use for curved simple contours, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonCurvedSimpleContourColor is corresponding to this option and still supported.
@CurvedStiffenerColor
Value Description
string A RGB description of the color to use for curved stiffeners, with values ranging from 0.0 to 1.0 (e.g. "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonCurvedStiffenerColor is corresponding to this option and still supported.
@DoNotMergeEdges
Value Description
on Preserve the original geometry edges, instead of merging them together during the import cleanup phase.
off Merge edges together during the import cleanup phase (default).
@ExtendSurfaces
Value Description
on The imported surfaces are extended to match neighbor surfaces (default).
off The imported surfaces are not extended.
@FlangeColor
Value Description
string A RGB description of the color to use for flanges, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonFlangeColor is corresponding to this option and still supported.
@ImportCutoutProfiles
Value Description
on Import cutout profiles.
off Do not import cutout profiles (default).
@ImportDoublingProfiles
Value Description
on Import doubling profiles.
off Do not import doubling profiles (default).
@ImportFaceplatesAsSurfaces
Value Description
on Import faceplates as surfaces if the surface description is present in the file, otherwise import as curves (default).
off Import faceplates as curves.
@ImportHoleProfiles
Value Description
on Import hole profiles.
off Do not import hole profiles (default).
@ImportHoles
Value Description
on Create holes (default).
off Do not create create holes.
@ImportMarkingProfiles
Value Description
on Import marking profiles.
off Do not import marking profiles (default).
@ImportNotchProfiles
Value Description
on Import notch profiles.
off Do not import notch profiles (default).
@ImportPanelProfiles
Value Description
on Create curves along the panel profiles.
off Do not create curves along the panel profiles (default).
@ImportPillarsAsSurfaces
Value Description
on Import pillars as surfaces if the surface description is present in the file, otherwise import as curves (default).
off Import pillars as curves.
@ImportSeamProfiles
Value Description
on Import seam profiles.
off Do not import seam profiles (default).
@ImportStiffenersAsSurfaces
Value Description
on Import stiffeners as surfaces if the surface description is present in the file, otherwise import as curves (default).
off Import stiffeners as curves.
@ImportSwageProfiles
Value Description
on Import swage profiles.
off Do not import swage profiles (default).
@ImportTapProfiles
Value Description
on Import tap profiles.
off Do not import tap profiles (default).
@ImportUnboundedCurvedPlates
Value Description
on Import curved plates lacking boundary descriptions (default).
off Do not import curved plates lacking boundary descriptions.
@ImprintStiffeners
Value Description
on Stiffener lines are projected onto close surfaces and create corresponding topological modifications to these surfaces (default).
off No projection is performed.
@LegacyHierarchyAsMetadata
Value Description
on Generate metadata with the original CAD hierarchy within the part.

LEGACY_HIERARCHY
off Do not generate metadata with the original CAD hierarchy within the part (default).
@MetadataPrefix
Value Description
string The string is prefixed to all metadata names. No prefix is used by default.

See CAD Metadata Naming for more details.
@PlaneBracketColor
Value Description
string A RGB description of the color to use for plane brackets, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlaneBracketColor is corresponding to this option and still supported.
@PlaneCutoutColor
Value Description
string A RGB description of the color to use for plane cutouts, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlaneDetailedContoursColor
Value Description
string A RGB description of the color to use for plane detailed contours, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlaneDetailedContoursColor is corresponding to this option and still supported.
@PlaneDoublingColor
Value Description
string A RGB description of the color to use for plane doublings, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlaneFaceplateColor
Value Description
string A RGB description of the color to use for plane faceplates, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlaneFaceplateColor is corresponding to this option and still supported.
@PlaneFlangeColor
Value Description
string A RGB description of the color to use for plane flanges, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlaneFlangeColor is corresponding to this option and still supported.
@PlaneHoleColor
Value Description
string A RGB description of the color to use for plane hole profiles, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlaneMarkingColor
Value Description
string A RGB description of the color to use for plane marking profiles, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlaneNotchColor
Value Description
string A RGB description of the color to use for plane notch profiles, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlanePillarColor
Value Description
string A RGB description of the color to use for plane pillars, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlanePillarColor is corresponding to this option and still supported.
@PlanePlateColor
Value Description
string A RGB description of the color to use for plane plates, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlanePlateColor is corresponding to this option and still supported.
@PlaneSeamColor
Value Description
string A RGB description of the color to use for plane seam profiles, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlaneSimpleContourColor
Value Description
string A RGB description of the color to use for plane simple contours, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlaneSimpleContourColor is corresponding to this option and still supported.
@PlaneStiffenerColor
Value Description
string A RGB description of the color to use for plane stiffeners, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonPlaneStiffenerColor is corresponding to this option and still supported.
@PlaneSwageColor
Value Description
string A RGB description of the color to use for plane swage profiles, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PlaneTapColor
Value Description
string A RGB description of the color to use for plane tap profiles, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized.
@PreferDetailed
Value Description
on When multiple representations of a AVEVA Marine object are available, import the most complex one (default).
off When multiple representations of a AVEVA Marine object are available, import the least complex one.
@ScaleFactor
Value Description
double Define the model scaling factor during import.

Default is 1.0.
@SplitComponents
Value Description
Part Generate part-based component (only allowed value if CreationType=Parts).
General Keep component as in CAD (only allowed value if CreationType=TreeOfComponents).
@StitchEdges
Value Description
on Edges of close surfaces are stitched together (default).
off Edges of close surfaces are not stitched together.
@SubFaceplateColor
Value Description
string A RGB description of the color to use for sub-faceplates, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonSubFaceplateColor is corresponding to this option and still supported.
@SubStiffenerColor
Value Description
string A RGB description of the color to use for sub-stiffeners, with values ranging from 0.0 to 1.0 (for example "0.1,0.5,0.4"). If not specified, default color management will be utilized. The obsolete @TribonSubStiffenerColor is corresponding to this option and still supported.
@TargetUnits
Value Description
CAD units Keep the units of the CAD files (default for GUI).
MKS [m kg N s] Convert to the corresponding units system.
MMKS [mm kg N s] Convert to the corresponding units system.
MPA [mm t N s] Convert to the corresponding units system.
CGS [cm g dyn s] Convert to the corresponding units system.
MMKNMS [mm kg kN ms] Convert to the corresponding units system.
MMGNMS [mm g N ms] Convert to the corresponding units system.
IPS Std [in pounds lbf s] Convert to the corresponding units system.
IPS Grav [in slinch lbf s] Convert to the corresponding units system.
FPS Std [ft pounds lbf s] Convert to the corresponding units system.
FPS Grav [ft slug lbf s] Convert to the corresponding units system.
Scale factor Apply the corresponding scale factor (default for no GUI to allow supporting legacy scripts).

Supported Metadata

Metadata generated from the AVEVA Marine reader.
AVEVA_OBJECT_TYPE
Type Entities Description
string comps, assems if hierarchy as Assemblies; parts if hierarchy as Parts The value is a string indicating the role of the object. Currently created values include:
  • Block
  • CurvedPanel
  • CurvedPlateGroup
  • CurvedStiffenerGroup
  • DetailedPlanePanelBoundary
  • KnuckledPanel
  • KnuckledSubpanel
  • Planebracket
  • PlaneBracketGroup
  • PlaneBracketFaceplateGroup
  • PlaneBracketFlangeGroup
  • PlaneBracketStiffenerGroup
  • PlaneComplexBracket
  • PlaneCutoutGroup
  • PlaneDoublingGroup
  • PlaneFaceplateGroup
  • PlaneFlangeGroup
  • PlaneHoleGroup
  • PlaneMarkingGroup
  • PlaneNotchGroup
  • PlanePanel
  • PlanePillarGroup
  • PlanePlateGroup
  • PlaneSeamGroup
  • PlaneStiffenerGroup
  • PlaneSwageGroup
  • PlaneTapGroup
  • Ship
  • SimpleCurvedPanelBoundary
  • SimplePlanePanelBoundary
BEAM_SECTION
Type Entities Description
entity parts Stiffener groups might contain this metadata which points the corresponding BEAMSECTION entity.
BEND_TYPE
Type Entities Description
string comps, assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the BendingRadius attribute for a plane faceplate group, a plane flange group, a plane pillar group, or a plane stiffener group. Possible values are:
  • Straight
  • Curved
  • Knuckled
BENDING_RADIUS
Type Entities Description
string comps, assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the BendingRadius attribute for a plane flange group.
BODY_ID
Type Entities Description
string
  • points
  • lines
  • surfs
 Identifier of the CAD body containing the entity.

Generated when @BodyIDAsMetadata=on
COLOR_RGB
Type Entities Description
string comps, assems if hierarchy as Assemblies; parts if hierarchy as Parts

Three RGB values, ranging from 0 to 255, indicating the color for the object.

Generated when the corresponding @Tribon<object>Color option is used.
COMP_ID
Type Entities Description
string surfs The value of the CompId attribute for a plate or bracket.
DATA_TYPE
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the DataType attribute for a panel.
EXTENT_MAX
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the maximum extent of a block or panel, as retrieved from the Max attribute of the object.
EXTENT_MIN
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the minimum extent of a block or panel, as retrieved from the Min attribute of the object.
FORCE_UNITS
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the ForceUnits attribute for a ship units object.
FUNCTIONAL_PROPERTY
Type Entities Description
string assems The value of the FunctionalProperty attribute for a panel or a group of sub-objects of a panel.
HEIGHT
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the Height attribute for a plane flange group.
INCLINATION
Type Entities Description
double array assems An array of 6 double values is added to each line belonging to pillars, flanges, stiffeners, and faceplates. Each line is provided with two triplets of inclination values to form 2 unit vectors. The vectors indicate the inclinations at the endpoints of the lines in the absolute reference system.
INSTANCE
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts Two possible values: AsDefined or Reflected, to indicate if the object is on the same side as its definition data, or if it has been reflected.
LEGACY_HIERARCHY
Type Entities Description
string
  • points
  • lines
  • surfs
 Hierarchy of an entity within a part.

Generated when @LegacyHierarchyAsMetadata=on
LENGTH_UNITS
Type Entities Description
string assems if hierarchy as Assemblies; parts if heirarchy as Parts The value of the LengthUnits attribute for a ship units object.
MATERIAL
Type Entities Description
entity parts Plate groups and stiffener groups might contain this metadata which points to the corresponding MATERIAL entity.
MATERIAL_DIRECTION
Type Entities Description
string faces The value of the MaterialDirection attribute for a flange, curved panel or knuckled panel.
MATERIAL_SIDE
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the material side data for a plate group or bracket group.
MODELUNIT
Type Entities Description
integer comps if hierarchy as Assemblies; parts if hierarchy as Parts Model units specified in the CAD file.
  • 1 = inches
  • 2 = millimeters
  • 4 = feet
  • 5 = miles
  • 6 = meters
  • 7 = kilometers
  • 8 = mils
  • 9 = microns
  • 10 = centimeters
  • 11 = microinches
  • 12 = decimeters
  • 13 = yards

This is always generated.
OBJECT TYPE
Type Entities Description
string parts A string given to parts to indicate their role in the ship organization. Supported types include:
  • Block
  • CurvedPanel
  • CurvedPlateGroup
  • CurvedStiffenerGroup
  • DetailedPlanePanelBoundary
  • KnuckledPanel
  • KnuckledSubpanel
  • PlaneBracket
  • PlaneBracketFaceplateGroup
  • PlaneBracketFlangeGroup
  • PlaneBracketGroup
  • PlaneBracketStiffenerGroup
  • PlaneComplexBracket
  • PlaneFaceplateGroup
  • PlaneFlangeGroup
  • PlanePanel
  • PlanePlateGroup
  • PlanePillarGroup
  • PlaneStiffenerGroup
  • Ship
  • SimpleCurvedPanelBoundary
  • SimplePlanePanelBoundary
OFFSET
Type Entities Description
string assems if heirarchy as Assemblies; parts if hierarchy as Parts The value of the offset data for a plate group.
PLATE_T
Type Entities Description
double assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the thickness attribute for any object having a material whose description includes a thickness.
RENDERING_TYPE
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the Type attribute for a ship rendering object.
RootSystemID
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts Generated for root system assemblies. Its value is the XML field OID.
THICKNESS
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the Thickness attribute for a plane flange group.
TIGHTNESS
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the Tightness attribute for a panel. Allowed values include:
  • NonTight
  • WaterTight
  • Undefined
VERSION
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the Version attribute for a ship.
WEIGHT_UNITS
Type Entities Description
string assems if hierarchy as Assemblies; parts if hierarchy as Parts The value of the WeightUnits attribute for a ship units object.