...
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 comprised 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 If a task is selected a new mapping open is created when the 4D Automation app with a task selectedis opened. 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 parents 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 Classification mappings that can be created are similar to the rules that can be used by filters Object 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 appliedobjects that meet the rules of the filter are assigned to the proper tasks. A mapping is applied using the red or green circle button indicator in the Mapping List. | |||||||||||||||||
Filters | created by mappings function the same as normal filters, and associated with 4D auotmation mappings appera in the Generated Filter Group and can easily be identified. Like other filters, generated filters can be used for Objects Status, Cinematic Legends, Color Highlights, and to select objects. However, when a | maping mapping 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. |
Classification Mappings
This section provides general information about different classification mappings that can be added to mappings.
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 parameter classification mappings it is important to understand using a Combination of Parameters. | |||||||
The Repeat Counter column toggles whether the parameter is a Repeating Countable Classification Mapping and to specify which value in the Keyword is used. 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 countable value formula are displayed with a $ instead of a numeral. The Offset allows the user to denote an offset. this is used for repeating countable parameters which contain data that may be slightly offset from the task data. | |||||||
Deletes the associated Classification Mapping. |
Mapping Managment
Learn how to manage multiple mappings and apply an existing mappings mapping to the project and evaluate status.
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 Countable Location Level and Associated Parameters list contains all level, zone, document and explicit or repeating countable 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 countable it is automatically moved to the Repeatable Countable 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 Countable 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 non countable parameter classification mapping needs to be added that is not repeating yet the user needs to all objects where objects need 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 Countable 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 ‘Cols and Walls’ Walls’ keyword |
...
Scroll pagebreak |
---|
Countable Classification Mappings
Anchor | ||||
---|---|---|---|---|
|
Learn how repeating countable classification mappings can greatly reduce the amount time it takes to assign objects to the schedule.
A Repeating Countable Classification Mapping is a specific type of classification mapping that relies on sequentail data. For example, the levels in a building. An repeating A countable classification mapping has the ability to iterate over read 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:as a countable classification mapping.
| |||||||
To create a repating countable classification mapping a keyword needs to be selected that contains a formula with a repeatable countable numeral. Possible numerals that are repeatable countable for keywords are:
| |||||||
For example, if “3rd floor” is selected as a to create a keyword. “3rd” will be read as an repeatable countable numeral. the generated Keyword is “$ Floor”. $ always represents an repeatable countable value in the formula. In order for the repeatable countable value to be used, a counterpart repeatable countable formula must be selected as the model parameter. For Example, if “$ - Floor” is selected, the mapping will repeat count through any level values that match that formula: “1st-Floor”, “2nd-Floor”, “3rd-Floor” The value of parameters and levels do not need to match the task data exactly. While the task data needs ot contain a number the level and parameter values may contain a phonetic number. The following numerals are countable levels and parameters.
|
Advanced Counter Settings
Learn how to utilize offsets and keywords with mulitple countable values
In some cases a keyword may need to be selected that has multiple values that the AI system identifies as “Countable”. It is possible to use a keyword with multiple countable values with a Parameter Classification Mapping. After the classification mapping is created the user must select which value read as countable is the desired counter. The Count / ID option specifies that the first value in the keyword is the counter | |||||||
The ID / Count option specifies that the second value in the keyword is the counter. The value that is not the counter is used as part of the general identifier. | |||||||
In some cases a |
countable 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 |
offset of 1 objects on level 4 will be filtered to Level 3. |
Location Classification Mappings
Anchor | ||||
---|---|---|---|---|
|
This section provides detailed infor,mation information regarding advanced configuration of Level and Location Classification Mappings.
A Location Classification Mapping can be used in conjunction with a level and parameter classification mapping mappings when level data the value 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 countable 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 defaultWhen using a level with this data a location classification mapping is needed. 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. |
...
Custom Counter Classification Mappings
Anchor | ||||
---|---|---|---|---|
|
Learn how to create custom counters to match unusual level names
In some cases parameter data values may contain values that are not read as countable values but match task names. For example, task names and the level parameter may refer to a ‘Ground Floor’, or ‘Entry Level.' Setting up a Custom Counter allows the user to specify which values should be countable and matched to task data. A Custom Counter Classification Mapping is similar a parameter classification mapping. However instead of a value the user specifies a Custom Counter to count through the values and match objects to tasks. | |||||||
Before using a custom counter classification mapping a custom counter must be created using the Custom Counter Settings menu. The Custom Counter button opens the Custom Counter settings Menu. | |||||||
The Custom Counter Settings menu contains a list of all custom counters in the project. | |||||||
The Add button creates a new custom counter. When a custom counter is selected associated values appear in the Custom Value Setup List. The user must populate the Custom Value List with each possible match. | |||||||
Custom Counters may contain both custom values and countable custom mappings. The Add Custom Mapping button adds a new custom mapping to the custom counter. | |||||||
Custom mappings allow users to count over sequentail parameter and schedule data using the custom counter. | |||||||
For non sequential data the user needs to specify what value needs to be contained in both the task and parameter data to be used in a custom counter. | |||||||
The Add Custom Value button addes a new custom value to the custom counter. A custom value needs to be contained by both task and parameter data in order to match objects to tasks. |
Compound Keywords
Learn how to enable 4D automation to assign each object to multiple tasks
Generally speaking mappings do not apply the same objects to more than one task. In some situations the user may want to add the same objects to multiple tasks using 4D automation. An additional task can be added to the mapping if it has the same parent as the task that was used to create it. The task name of the added task is appended to the existing 4D Data. | |||||||
The image shows the task Set Brace, and Install Rebar included in the same mapping. | |||||||
Adds an additional task to the currently selected Mapping. | |||||||
Additional classification mappings need to be created in order to specify which keyword in the new task name should be used to filter the objects to the task. In the Example Below Walls are assigned to tasks with both the “Set Brace” and the “Install Rebar” keywords. | |||||||
When using compound keywords it is important to understand that any classification mappings contained in the countable Location, Level and Associated Parameters list must meet all tasks that objects are assigned to. A safe way to ensure that all tasks meet the criteria is by using keyword that exist in thier shared parents. |
4D Automation Database
Learn best practices for creating a 4D Automation Database using
Mappings can be exported and reused on other projects. When exported, mappings are stored in XML format. Import and Export buttons are located at the bottom of the 4D automation window. The Export button exports all mappings existing in the project. The Import button imports mappings from an XML When imported into a project mappings are automatically applied to the project. However, some mappings may be missing information that is required to utilize thier classifications. These mappings will not apply objects to tasks. Users may edit the mappings after adding necessary information. | |||||||
If data associated with an imported mapping does not match a task in the schedule it will not have a status indicator. Mappings that match schedule data may have different statuses. depending on the status a different action may be required for the mapping to be applied. | |||||||
The mapping did not apply because it is missing zones, levels, or parameters that do not exist in the project as defined by the classification mapping. | |||||||
The mapping did not apply because, with the given configuration, it failed to assign any objects to tasks. | |||||||
Objects are successfully assigned to tasks. | |||||||
Statuses that do not apply are always unchanged if rexported. This allows the user to build a database of mappings that are associated with different file and schedule structures. |
Scroll pagebreak |
---|