Studio UG Tutorial - Naming Conventions

Specifying how schedule activities will be named

Underground Planning Tutorial - Naming Conventions

Naming Conventions are used to modify the attributes, properties and names associated with project data; this enables Studio UG to be tailored to the individual requirements of your projects. Conventions are comprised of a filter to define the scope of data over which the convention will be applied (e.g. all FXS data, derived activities, wireframes etc.) and the naming convention itself.

These filters reference attributes which will be present in your design data.

The convention is the specification of the string used to name the activity that is generated from the filtered design data.

In this section, you'll set up four naming conventions; two will be applied to distinct groups of fixed cross-sectional data (for this tutorial, the filter that differentiates which FXS data gets which convention is determined by the DESC field of each of the specified string files), one for wireframe activities and one for derived activities.

  1. Set up your attributes.
  2. Define your convention which references those attributes.
  3. Define the filter to be used to isolate the data to which your convention applies.
  4. Complete the assignment by linking the filter to the convention.

This is achieved using the Settings panel, and tools found in the Naming Convention Assignments group.

Your project requires three naming conventions. Two require custom filters to define the scope of data to which they will be applied. The other one is applied using system filters (the same convention is assigned to two groups of data (derived activities and wireframe data) using two separate filters.

All four conventions are defined using a similar process and the general principles described here apply to all naming convention scenarios.

Prerequisites

Exercises in this section

This section contains the following exercises:

  1. Naming Convention Attributes Setup
  2. Naming Convention Setup
  3. Naming Convention Filters Setup
  4. Complete Naming Conventions Assignment

Exercise 1: Naming Convention Attributes Setup

Before you define a naming convention, you need to define the attribute(s) that will be referenced within it. In this detailed example, the convention will be used to label activities with the structure type (e.g. "decline"), level elevation (e.g. "840") and the region in which the activity exists (e.g. "INFR").

Attributes are set up using the Edit Attributes panel, which can be accessed from the Edit Naming Conventions panel (it can be accessed from various parts of your planning system).

  1. In the Naming Convention Assignments panel, click Edit Naming Conventions:

  2. In the Edit Naming Conventions panel, click "+" on the left to add a new convention to the (empty) list:

  3. "NewNamingConvention" is added to the list, and a table appears on the right (ignore the warning for now):


  4. Double-click the default description and edit it to read "INFR" - this convention will be used to denote a particular region of the mine.
  5. This convention will be used to set up an activity name of the following format:

    [Structure type]_[Region Description]

    An example activity name could be "Cubby_EAST". Two attributes are needed to define this convention (DESC and REGION respectively), and they don't exist in the Studio UG database yet.

    You need to define them. Click Edit Attributes to open the Edit Attributes panel:

  6. The only attributes listed are system attributes required by Studio UG. These are locked and not editable. Defining attributes can either be done manually, or by extracting them from a Datamine file, which can often save time.

    The tutorial data already includes the attributes and data definitions that you need, so in this case, you can generate them. Click Generate.

  7. The file fxs_decline.dm contains attributes you will need for your convention, so select it in the browser and click Open.
  8. In the Field Selector dialog, select all of the Use check boxes (not all attributes will be used for naming convention purposes - it's just easier to define them all for later exercises now).
  9. Click OK.
  10. Your attributes are now transferred to the Attributes panel, and are defined for your project.

    Click OK in the Attributes panel to return to the Naming Conventions panel and continue defining your first convention.

Exercise 2: Naming Convention Setup

Now that you have defined the attributes you wish to use in your naming convention assignments, you can start to define the actual convention used to construct an activity name.

  1. In the Edit Naming Conventions panel, edit the contents of the table on the right so they read:

    Type: Attribute
    Text: (not editable for the selected Type - blank)
    Attribute: DESC (this is the attribute that will be used to define the design types later on)
    From Index: 1
    To Index: 8
    Padding Type: Right
    Character:_ (underscore)

    This defines the first element of the "INFR" naming convention; a string, 8 characters long based on the DESC field value of the FXS design data, followed by an underscore.
  2. The second element of the naming convention for "INFR" is a reference to the region of the mine to which the activity relates. In this case, the REGION field contains this information.

    Click the "+" sign above the table on the right and add the following information to the table:

    Type: Attribute
    Text: (not editable for the selected Type - blank)
    Attribute: REGION
    From Index: 1
    To Index: 4
    Padding Type: None
    Character:(blank)

    Your table now looks like this and is complete for the INFR naming convention.

  3. Two more conventions are needed for your project; one to name activities relating to stoping and the other to reference development activities.
  4. Add a new convention using the "+" icon on the left of the panel. Rename this convention to "Development".
  5. Use the tools on the right to set the table up for "Development" like this:



    This sets up convention in this format: [Structure Type]_[Level number]_[Region Description]

    An example activity name could be "Cubby_200_EAST"
  6. Similarly, create another convention called "Stopes" and set it up like this:



    Stope activity names are set up for this project in the following format: [Design Definition Type]_0[Stope Sequence Number]_[Level number]_[Region Description]

    An example activity name could be "DECLINE_0144_200_EAST"
  7. Click OK to return to the Setup panel.

Exercise 3: Naming Convention Filters Setup

You also need to specify the scope of data to which your naming convention will apply. This is done using a Filter. A Filter is a one or multi-component rule that describes a subset of your design data.

Your first filter will be used to define a naming convention that will be applied to a specific set of structures, each of which needs to be easily identifiable in the resulting schedule.

  1. To get started, click Edit Filters:

  2. The Edit Filters panel is used to define the name and rules for your filter. Select the green "+" icon on the left to add a [NewFilter] item to menu list below (the list already contains some default filters - these are always present and not editable):

  3. Double-click the [NewFilter] field and enter the description "FXS_NAMING1". This will be the convention that applies to the first set of activities relating to your fixed cross sectional data.
  4. On the right of the panel, a warning has appeared in the Field Name cell. This is because you haven't defined an attribute that will used to filter your design data:

  5. You're going to set up a filter so that only design data that has specific values for the DESC attribute will be subject to a particular naming convention (which you'll finalize shortly).

    The first FXS naming convention will be used where the DESC value for the design data matches any of the following values:

    DECLINE
    DEC_MNVR
    INT_RSE
    SHAFT_EX
    SHAFT_IN
    INT_ACC


    For now set up the first row of the table so that it matches the image below:

  6. Click "+" to add another condition to the filter. This will be an "OR" condition, meaning data will pass the filter if it matches the definition, regardless of other filter elements.
  7. Importantly, change the [And] to read [Or], then populate the second row like this:

  8. Complete the filter expression for the "FXS_NAMING1" convention by adding the following filter elements:



    That's the first filter complete; it defines a group of structures within the project that will carry a specific naming convention (in this case, it will be the "INFR" convention you defined earlier).
  9. The remaining filters for your project can be loaded from an XML file downloaded earlier.

    One more naming convention filter is needed, but others are needed for dependency configuration later.

    To import filter information, click Import in the top right corner of the panel:

  10. Navigate to and open the file "Filters.xml" that is found in the "XML" sub-folder of your current directory.
  11. All remaining filters and definitions are added to the Edit Filters panel.

    Have a look at them to get an idea of how they are constructed (particularly "FXS_NAMING2") then click OK to close the Edit Filters panel.

Exercise 4: Complete Naming Conventions Assignment

Assigning a convention requires a Filter and a Naming Convention to be defined. You've already done this for your project, so the final step is to associate the two elements.

  1. In the Setup panel (Naming Convention Assignments group), click the associated "+" icon.
  2. Edit the Filter name by selecting [FXS_NAMING1] from the drop-down list.
  3. In the Naming Convention cell, select [INFR]

    This naming convention will be applied to all infrastructure activities throughout the mine, and will use the "INFR" convention you set up manually in a previous exercise.
  4. For the second convention assignment, click "+" and define [FXS_NAMING2] (a filter imported from XML earlier) and the [Development] Naming Convention.
  5. The last two conventions use the same convention ("Stopes"): assign the [*WFM] system filter to the [Stopes] Naming Convention.
  6. Finally, assign the [*DER] Filter to the same [Stopes] Naming Convention (you want to use it for both wireframe and derived activities).

    Your table should look like this:

  7. Save your planning settings using the Save button at the top of the panel:

Your naming conventions are now set up for your project. In the next exercise you'll set up your block model and its interrogation rules.

Move onto the next section...