Creating a UDF-based Typical Cross Section and Associated Object Types for Subgrades

You can create a typical cross section that is an input necessary for the subgrade surface creation. You can also create object types of subgrade types that can be reused in the Road/Railway Subgrade command.

For information about object types, see Building and Civil Assemblies User's Guide: Defining Object Types.

To help you find the reference information you need to use the content delivered along with your app, you can consult the 3DEXPERIENCE Native Apps Content User's Guide.

This task shows you how to:

Before you begin: The app optional content is not automatically installed along with the code. Contact your administrator if you must install the files you need. For more information, see Install Optional Content. You can also see Installation and Setup:Install: 3DEXPERIENCE Platform: Installing 3DEXPERIENCE Platform Services for the First Time: Installing Services One-by-One: Native Apps: Installing Native Apps: Installing a Native App.
See Also
About Typical Cross Section
Creating or Splitting the Subgrade Layer of an Infrastructure

Create Typical Cross Section

You can create a typical cross section that is an input necessary for the subgrade surface creation.

Before you begin:

The schema below illustrates the railway structure:

Subgrade layer 1

Subgrade layer 2

Excavation profile

Filling profile

  1. Optional: For each layer to be typed, create an Object Type (Distribution mode) and give it the Subgrade Layer type.
  2. To generate excavation and filling surfaces in layer subgrades, you need to add excavation and filling profiles as outputs of the UDF.

    When you define an UDF as a typical cross section, the UDF must have:

    • A Base Axis System as input. It can have additional inputs.
      Tip: To set a Base Axis System as an input of the UDF, do the following:
      • click Formula from the Tools section of the action bar.
      • Select Axis System in the New Parameter of type list.
      • Click New Parameter of type and Add Formula and, select Axis System. Click Update. The tree is modified accordingly with the f(x) Axis System.
      • In the tree, replace the initial axis system with the Formula axis system.
      • From the Civil Engineering section of the action bar, click User Feature Definition and select Axis System in the Inputs of components panel of the User Feature Definition dialog box.

      The Base Axis System is an input of the UDF.

    • Exposed parameters that will be retrieved in the Subgrade command.
    • Opened or closed curves as outputs.

    Excavation and filling profiles are added to the subgrade cross section.
  3. To type the outputs of the subgrade, type the main result and/or the outputs of the UDF. For this, do the following:
    1. Open the part containing the UDF and click Define Specification from the Civil Engineering section of the action bar.
    2. Optional: Select the Subgrade Layer type and one or several UDF outputs (created layers) in the tree.
    These types are mapped on the subgrade outputs.

    Excavation and filling profiles must be typed as excavation and filling to be detected by the Road/Railway Subgrade command. If so, the command switches to an Earthwork context with additional functionalities.

    Tip: To check if the output is typed, click BIM Attributes from the Civil Engineering section of the action bar.

    A typical cross section is created.

Create a Subgrade Object Type and Attach a Typical Cross Section to This Object Type

You can create a subgrade object type, and attach the above created typical cross section to it. Examples of subgrade cross section are available in the SubgradeTypicalCrossSections.3dxml stored in startup\Civil\Alignment.

  1. Click Add > Content and select Subgrade type.
    A dialog box appears enabling you to create an object type of subgrade type.
  2. Choose a title and select the Adaptive mode for the Product instantiation method.
  3. Click OK.
    The subgrade object type is created.
  4. Double-click Resource table in the tree.
    The Resource Table Management dialog box appears.
  5. In the Cross section Feature-based Design line, right-click the Resource cell and select Choose the assigned resource.
  6. Select the feature defined as Typical Cross Section in the tree and, click OK.
  7. Click OK in the resource table.
  8. Select Share > Save > Save All to save the created object type.

The typical cross section is attached to the subgrade object type.