Duplicate Tool

With the Duplicate Tool (concept > Concepts > Duplicate Tool) you duplicate a selection of models and/or concept, including uncertainty parameters and model dependencies, and generate a JewelScript from the selected models. The main advantages of using this tool over individually copying models are:

  • You can copy multiple models in one go.
  • If there are dependencies between models, these inter-dependencies are automatically restored.

The Duplicate table on the form is populated either based on a model, or based on a concept, which you select at the top part of the form. From this table, you select one or multiple models to duplicate. The selected models are included in a JewelScript that is also created by the Duplicate Tool. It is recommended to run the JewelScript to make sure that all models are in valid state before you continue working with the duplicated models.

For your convenience, the models that you select for duplication are also shown in a (dependency) graph on the form. For more details, see section below.

Populate the Duplicate Table based on a model

  1. At the top of the form, select Model. The selected option is highlighted in blue. The selection acts as a filter, and the Starting Point section only shows the relevant entry fields.
  2. The Model type selection acts like a filter. If you select All, no filter is applied. If you select a model type from the drop-down list, only models of this type are listed in the Model drop-down list below.
  3. From the Model drop-down list, select the model of interest. If you selected the All option for Model type, then you can also select All here, which will populate the Duplicate table with all models in your solution.
  4. Select which dependency direction you want to use to show related models:
    • Item -> Precedents will populate the Duplicate table with the selected model at the bottom, and all the models that are used as in input above it. 
    • Item -> Dependents will populate the Duplicate table with the selected model at the top of the list, and all the models that use the selected model as input below it.
  5. Now that the Duplicate table is populated, select the checkboxes for the models that you want to duplicate. If you select two models in the table that are 'connected' via other models, these models will be auto-selected and cannot be unselected. This is to make sure that the interdependencies are kept.

    6. Output section

    In the output section you choose a suffix that is added to models name, and you provide a name for the dedicated JewelScript.

  6. You can use the default suffix (- Copy) or enter another suffix. The suffix must be a unique name. The duplicated models will have the name: <name of the selected model><suffix>, and are saved at the same location as the original model (i.e. the JewelExplorer, the Property Calculator or the Property Tool)
  7. Enter a name for the JewelScript that will be created using the selected models.
  8. Click OK to duplicate the models. The duplicated models will have the name: <name of the selected model><suffix>, and are saved at the same location as the original model (i.e. the JewelExplorer, the Property Calculator or the Property Tool). A JewelScript is created and the JewelScript Editor opens with this JewelScript selected. It is recommended to run the JewelScript to make sure that all models are in valid state before you continue working with the duplicated models.

Populate the Duplicate Table based on a concept

Both volumetric and simulation concepts can be selected
  1. At the top of the form, select Concept. The selected option is highlighted in blue. The selection acts as a filter, and the Starting Point section only shows the relevant entry fields.
  2. Select a volumetric scenario from the Volumetric scenario drop-down list. This selection acts as a filter, and only concepts from this model are listed in the Concept drop-down list below.
  3. Select a concept from the Concept drop-down list.
  4. The Model type selection acts like a filter. If you select All, no filter is applied. If you select a model type from the drop-down list, only models of this type are listed in the Model drop-down list below.
  5. From the Model drop-down list, select the model of interest. This will populate the Duplicate table with the model, and all models that use the selected model as input. If you selected the All option for Model type, then you can also select All here, which will populate the Duplicate table with all models in your solution.
  6. Now that the Duplicate table is populated, select the checkboxes for the models that you want to duplicate. If you select a model in the table that is input for another model or for multiple models in the table, these models will be selected for you and cannot be unselected.

    7. Output section

    In the output section you choose a suffix that is used to give the duplicated models a name, and you provide a name for the dedicated JewelScript.

  7. You can use the default suffix (- Copy) or enter another suffix. The suffix must be a unique name. 
  8. Enter a name for the JewelScript that will be created using the selected models.
  9. Click OK to duplicate the models. The duplicated models will have the name: <name of the selected model><suffix>, and are saved at the same location as the original model (i.e. the JewelExplorer, the Property Calculator or the Property Tool). A JewelScript is created as well, and the JewelScript Editor opens with this JewelScript selected. It is recommended to run the JewelScript to make sure that all models are in valid state before you continue working with the duplicated models.

Filtering and searching data in the Duplicate table

Volumetric concepts can consist of a large number of domain models, and have their related input properties and co-dependencies with other model inputs. This can make the information in the dependency table very complex to apprehend. With the filtering and search functions on the form, you can view only the relevant information on the form.

Click anywhere in the table and subsequently press CTRL+F to open the search panel on the form, or use the context menu of column headers and select Show Search Panel to display the search panel at the top of the dependency table. After you enter a text, e.g. a model name, in the search panel, the results are immediately filtered and shown in the table below. With the Filter Editor dialog, you can create custom search function expressions with multiple conditions and filters.

The context menu of the column headers has the options to open the Filter Editor dialog and to open the Search Panel to filter information in the Duplicate table.    click to enlarge

Dependencies in Graph format

The graph on the Duplicate Tool shows the models, in the order of execution from top to bottom, that you have selected to duplicate in the table. With the graph format, you can easily see direct and indirect dependencies. Click on a model in the graph to highlight dependent/precedent models. For each model, the model name, the model type and if you selected a concept, the order of execution are listed. For more details, see 'Graph legend' section below.

To interact with the graph, use mouse controls and the options on the right side of the graph (Filter section).

Filters

Click on the filter icon to show or hide the filter section. All models that can be displayed in the graph are listed with checkboxes. You can use the model section to filter your graph based on model types. If a model type is selected in the Duplicate table, the checkbox of that model type is active. If a model type is not selected in the Duplicate table, the checkbox for that model type is grayed out. Upon opening, by default, Show all is selected. This way, all model types that are selected in the Duplicate table are automatically displayed in the graph. After closing the Duplicate Tool, changed settings are reset to the default option.

Graph Settings

Rebuild graph - If the checkbox is checked, any interaction you do with the graph is updated immediately. If you have many models this can take a long time, and in that case it is advised to uncheck this option. If the checkbox is unchecked, changing the settings will only hide or unhide models in the graph if the selected model types were already selected for display in the graph. Checking an extra model type in the filter section that was not already selected when the checkbox was unchecked, will not be shown.

Hide common parent connections - This option is checked by default, only the longest 'chain' of connections between two models is shown. All direct arrows are hidden, unless this is the only connection between models. If this option is unchecked, all connections between models are shown in the graph.

Levels - The number you enter here, determines how many 'levels' of dependents or precedents show their relationship, and are highlighted in the graph, with the model you select in the graph.

Dependents - If selected, all models that are derived from the selected model are highlighted in black.

Precedents - If selected, all models that are input to the selected model are highlighted in black.

Mouse controls

  • CTRL key plus mouse wheel to zoom in and out.
  • Double click in the gray title bar of the form to expand the form to the size of your screen.
  • Left or right mouse click on a model to select it, it is highlighted in gray.
  • CTRL + left or right mouse click to multiselect models (selected models are highlighted in dark blue).
  • Left or right mouse click and drag to activate a rectangle to multiselect models (selected models are highlighted in dark blue).
  • Left or right mouse click and drag a selected model or selected models to a new location in the graph.

Abstract example of dependencies for a volumetric concept displayed in 'Graph' format.    click to enlarge

Graph legend

Arrow indicating that there is a direct dependency between the two models.
Arrow that shows the relationship from the selected model to all dependent or precedent models (adhering to the graph settings), always pointing in the order of execution. The dependent or precedent models are highlighted in dark gray.
Arrow indicating that with the current settings there is a model in between the two models that is filtered out.
Arrow indicating that with the current settings there is a model in between the two models that is filtered out. It also shows the relationship from the selected model to all dependent or precedent models (adhering to the graph settings), pointing in the order of execution. The dependent or precedent models are highlighted in dark gray,
Input model for the concept, selected on the Assign Models form, that is selected for duplication.
Property Calculator model that is selected for duplication.
Function Property Model that is selected for duplication.
Model that is selected for duplication.
Indicates that this model has uncertain parameters. Hover over the model to show a tool-tip with more details.
Important  Known limitations:
  • Fluid Model property names are not updated in the JewelScript if you only duplicate the fluid model, and not the 3D grid the properties are mapped to. You have to manually assign the duplicated fluid properties to the 3D grid in the JewelScript.
  • When you select Concept as input mode, Property Calculator expressions that refer to Property Calculator Functions, e.g. LogValueAtDepth("all", "por"), are not duplicated. You have to manually assign them to the JewelScript.