4D Automation

The 4D Automation App allows users to assign objects to the schedule based on BIM and 4D data. The user controls the assignment of objects with mappings. Each mapping is comprized of various classification mappings that inform how objects should be assigned to tasks.

The 4D automation menu is opened using the associated button in the 4D Toolbox.

To create a new mapping open the 4D Automation app with a task selected. If the 4D Automation App is already open use the + New Mapping button to create a new mapping.

When a mapping is created, 4D Data associated with the selected task is exposed to the user. This information includes the task name and names of any direct or indirect parent in WBS.

Only a single task is required to create a given mapping. However, one mapping can be used to filter data to many tasks.

Mappings are comprised of various classification mappings that allow the user to match a given keyword in the 4D data to BIM data associated with objects in the project.

A Keyword is specified by selecting text in the 4D data. When selected, a drop down menu appears allowing the user to select which classification mapping to create. Classifications mappings that can be created are similar to the rules that can be used by filters.

For basic mappings, objects that meet the parameters of the classification mappings are assigned to a task that contains the given keyword.

4D automation uses filters to apply objects to tasks. When a mapping is applied associated filters are created and automatically applied. A mapping is applied using the red or green circle button in the Mapping List.

Filters created by mappings function the same as normal filters, and can be used for Objects Status, Cinematic Legends, Color Highlights, and to select objects. However, when a maping is changed and reapplied these filters are recreated and will not retain associated settings.

Editing and viewing automatically generated filters is a great way to verify the integrity of a mapping.

• A Document classification mapping allows the user to select a document. Document classification mappings will filter the mapping to only consider objects that exist within a specific file. Available options include any separate file loaded into fuzor. This includes linked Revit models as well as separate model appended to a Navisworks composite.

• A Zone classification mapping allows the user to select a zone, or specify a formula for multiple zones.

• A Level classification mapping allows the user to select a specific level, or specify a formula for multiple levels.

• A Location classification mapping allows the user to clearly define an existing level classification mapping. Location Classification Mappings are used when the level contains additional data that needs to be matched to another keyword.

• A Parameter classification mapping allows the user to select specific data from the BIM properties of objects that can be used to either filter the available results or specify a formula for multiple values.

Mulitple parameter classification mappings can be added to the same mapping. Other classification mappings can only be used once per mapping. When using multiple Parameter Mappings it is important to understand using Combination of Parameters.

The Repeat column toggles whether the parameter is a Repeating Classification Mapping.

the Keyword column displays the keyword that is associated with 4D Data. This is generated when selecting data from the task. If a keyword formula is iterative it will be displayed here with a $ instead of the numeral.

The Classification column displays the type of the classification mapping. when using a parameter classification mapping the the drop down menu is used to select and display the name of the associated BIM parameter.

The Operator allows the user to control whether the classification mapping needs an exact match: ‘Equal to'. Or to look for any value that contains the given text: 'Contains’.

The Value allows the user to select a value to filter by in the BIM data. repeatable value formula are displayed with a $ instead of a numeral.

The Offset allows the user to denote an offset. this is used for repeating parameters which contain data that may be slightly offset from the task data.

Deletes the associated Classification Mapping.

The Mappings List is used to apply a mapping and to manage the mappings in the project. Each Mapping in the list has an indicator that denotes the status of the mapping. When selected the BIM and 4D data is processed and objects that meet the criteria are assigned to tasks.

The mapping has not been applied.

The mapping failed to assign any objects to tasks.

The mapping has been modified, changes have not been applied.

The mapping has been applied and objects have been assigned to tasks.

When objects are already assigned to the schedule the indicator applies or reapplies the mapping. Additionaly filters are removed and recreated, objects associated with the filter are unassigned and new objects are assigned.

Deletes the mapping. Also deletes associated filters and unassigns objects associated with the mappings.

Many mappings can be created and managed separately. To edit a different mapping select the mapping in the Mappings List. When selected classification mappings associated with the mapping are displayed and can be edited.

For each mapping there are two separate lists of classification mappings. The lists display and allow the user to control how parameter classification mappings function.

The Repeateable Location Level and Associated Parameters list contains all level, zone, document and explicit or repeating parameter classification mappings. All objects must match the rule defined by the classification mappings that appear in this list.

The Combination of Parameters list contains a list of parameter classification mappings for which all object must match at least one of the classifications defined.

The first parameter that is added to a given mapping is always added into the Combination of Parameters list. For any single parameter classification mapping all objects still need to contain the specified BIM data. If the parameter is set as repeatable it is automatically moved to the Repeatable Location Level and Associate Parameters List.

When additional parameter classification mappings are added the user is allowed to select Parameter-AND or Parameter-OR.

The Parameter - OR option places the newly created parameter classification mapping into the Combination of Parameters list.

The Parameter - AND option places the newly create parameter classification maping into the Repeateable Location Level and Associated Parameters list

The Combination of Parameters list allows the user to specify multiple inclusive classifications to filter objects. If a given object meets the criterium of the mapping if it contains the BIM data values that are specified in any of the classifications.

The image below shows two parameter classification mappings using the category parameter. In this example both walls and structural columns are assigned to tasks with the keyword ‘Cols and Walls'.

In some cases an additional parameter classification mapping needs to be added that is not repeating yet the user needs to all objects to meet its criterium. For example we could expand on the previous mapping to include a workset that all the columns and walls need to be part of. This parameter classification mapping needs to be added to the Repeateable Location Level and Associated Parameters list.

The Parameter - AND option is used to create a parameter classification mapping that specifies BIM data that all objects need to contain.

In the above example all structural columns and walls in the structure workset are assigned to tasks with the ‘Cols and Walls’ keyword

A Repeating Classification Mapping is a specific type of classification mapping that relies on sequentail data. For example, the levels in a building. An repeating classification mapping has the ability to iterate over multiple different values and create a separate filter for each match between the schedule and BIM data.

Creating the most powerful mapping requires a strong understanding of the BIM and 4D data in the project. The following classification mapping types can be used iteratively:

• A Level classification mapping can iterate through each level.

• A Zone classification mapping can iterate through each zone.

• A Parameter classification mapping can iterate through each value of a given parameter.

To create a repating classification mapping a keyword needs to be selected that contains a formula with a repeatable numeral. Possible numerals that are repeatable are:

• Integer : 1, 2, 3, 4… OR 01, 02, 03 ,04…

• Phonetic : One, Two, Three, Four…

• Ordinal : 1st, 2nd, 3rd, 4th

• Ordinal and Phonetic : First, Second, Third, Fourth

• Alphabetical : A, B, C, D

For example, if “3rd floor” is selected as a to create a keyword. “3rd” will be read as an repeatable numeral. the generated Keyword is “$ Floor”. $ always represents an repeatable value in the formula. In order for the repeatable value to be used, a counterpart repeatable formula must be selected as the model parameter. For Example, if “$ - Floor” is selected, the mapping will repeat through any level values that match that formula: “1st-Floor”, “2nd-Floor”, “3rd-Floor”

In some cases a repeating classification mapping may need to be slightly offset. For example, the ceilings on level 2 may fit better if constructed by tasks with the level 3 Parent. Or instead of a level the user is using a revit parameter like “top constraint” which is ussually a level higher than the level the object is on.

An offset can be used to ensure that objects are assigned to a different level. when using an offest of 1 objects on level 4 will be filtered to Level 3.

A Location Classification Mapping can be used in conjunction with a level classification mapping when level data includes information about the location of the object as well as the level it is on. For example, if a building has multiple wings and the information regarding which wing the object exists in is located in the level BIM data a compound repeating mapping is most effective.

A level classification mapping must be created first with a specific type of value in order to add a location classification mapping. A level and location classification mapping will work together to properly assign objects to the schedule.

The level classification mapping should be created using a keyword that only contains the level number.

A level with two numerals needs to be selected for the pameter value of the level mapping. Each numeral will be displayed as a separate $. This mapping will not work by default.

When a level with two numerals is selected the level list is regenerated creating two additional options that allow the user to distinguish between the level and the location for the given level value. By default the option where first numeral in the formula denotes the level is selected.

If the second number in the formula contains the level data. Select the drop down menu again to pick between the available options. The two choices are displayed using either a '[NUMBER]' or a '$' to denote each numeral. The value formula for a level classification mapping should display the level as a $ and the location as [NUMBER].

To complete the classification mapping a location classification mapping must be added and an associated keyword must be selected. For example BLDG 2 can be selected.

The location classification mapping is only available when a level classification mapping is created as described above and it its automatically assinged to the associated Level with the opposite formula. The value formula for a location classification mapping should display the Location as a $ and the Level as [NUMBER].

The above mapping is extremely powerful. Assuming that other tasks in the schedule follow the same structure objects on all levels and in different buildings can be assigned with a single Mapping.