Structure to parameter

Developed in collaboration with

1022

Structure to parameter

It's a free plugin!

  • Transferring the structure of a multilayer type to a multiline parameter
    About files with the extension .mpif
    The file with the .mpif extension is a special installation file of the ModPlus (ModPlus Install File).
    These files allow you to install and update all ModPlus components using the auto-update module in case you do not have access to the internet or modplus.org

    Icon

    32x32px 16x16px dark 32x32px dark 16x16px

    Related news and articles


    Using

    The plugin window at first startup:

    1

    When you start, go to the settings window by clicking "k" in the upper right corner of the window, and make the preliminary settings of the plugin.

    SETTINGS

    2

    In the first block of plugin settings, you must specify the following parameters:

    • Template – required parameter with the data type "Multiline Text". This parameter specifies the template of the result formation using the structure wildcard (described below)
    • Result – required parameter with the data type "Multiline Text". The numbered list of layers of the structure is written to this parameter, taking into account the specified line formats and numbering settings
    • Variable thickness – optional parameter with the "Text" data type. This parameter specifies a custom variable thickness value that can be used in the string format for a variable thickness layer

    All three parameters must be parameters of type with category "Common". The parameters must be applied to the element categories for which it will be necessary to transfer information about the layer structure to the parameter (e.g. categories "Roofs", "Walls", "Floors", etc.).

    For the correct operation of the plugin as the above parameters should not be specified system parameters. For example, you cannot use the parameter "Structure".

    In the second settings block there is a field for entering the Structure wildcard (by default "@"). This is the character that is specified in the template and is replaced by the formatted list of structure layers as a result.

    The Structure Layer Numbering settings consist of a drop-down list with Numbering options and a field that specifies the Number Format – a character or group of characters that separates the sequence number of a layer from its description. For example, if you want the string to look like "1. Concrete..." select the Numbering: 1, 2, 3, ..., and in the Number format field put a dot and a space. 

    The String Format block configures templates for strings containing information about the structure layers, which will be written to the parameter “Result”. String Format is set for three types of layers:

    • Standard layer – a layer of material with a constant non-zero thickness
    • Zero-thickness layer – a layer of material with a thickness equal to zero
    • Variable thickness layer – a layer of material with variable thickness

    You must use wildcards in the string format template: {0} - for inserting the material name, {1} - for inserting the layer thickness and {2} - for inserting the variable thickness from the parameter "Variable thickness". For example, if you write the value "{0} - {1} mm" for the standard layer, the result will look like "Concrete - 175 mm".

    The option Take material name from material parameter allows you to specify a material parameter whose value will be used as the material name - {0}.

    On subsequent runs of the plugin, all the settings you have made are saved.

    MAIN WINDOW

    The main plugin window consists of the elements of Type filtering and searching, a table of Types and their parameters, and a status bar and control buttons in the lower part of the window.

    3

    When you run the plugin, the table displays all the model Types for the multilayer element categories (e.g. categories "Roofs", "Walls", "Floors", etc.).

    For convenience and faster processing of Types, you can use the following settings at the top of the plugin window:

    Category – drop-down list, where you can select one category of elements to display in the table of Types or all categories simultaneously

    Search by Type or material name – the field for quick search in the Type table, is register insensitive

    Show only Types with required parameters – when on, the table shows only Types with the required "Template" and "Result" parameters

    Show only used Types – option that, when checked, shows only the Types used in at least one element in the model

    The list of Types and their parameters is presented in the form of a table with the following columns:

    Category – category of elements to which the Type belongs

    Type – contains the name of the Type and number of instances in the model with this Type

    Structure – layer-by-layer structure of the Type. Each row contains the following values:

    • layer material
    • layer thickness (a variable thickness is indicated by a red dot)
    • the number of material uses in other Types loaded to the plugin, including the current one. When you click (select) a row in the list of materials, rows with this material in all Types are highlighted in green.

    Template – a required parameter. To output the list of structure layers, you must specify the structure wildcard in the “Result” parameter in the cell. The field can be edited in the plugin window. You can also specify additional information before and/or after the structure wildcard in the template. 

    For example, the Finish Floor is defined by a Floor, the structure of which will be taken from the Type, but it is necessary to specify also the Flooras a part of the Finish Floor. To do this, enter "Concrete slab" after the structure wildcard and get the following value:

    4

    Var. thick – user variable thickness value that can be specified for a layer that has a variable thickness, if necessary. The field can be edited in the plugin window

    To quickly fill the Template or Var. thick field with the same value, you should select several rows (with Ctrl or Shift) and type or paste the value you want in the cell of any selected row.

    Current result – value of the "Result" parameter at the moment the plugin starts

    New Result – a numbered list of the structure layers, taking into account the specified line formats and numbering settings, which will be written to the "Result" parameter when you press Accept

    Update – option for selecting the Types, in the parameter of which it is necessary to write the layer structure. In order to check multiple Types it is necessary to select the rows (with Ctrl or Shift) and check any of the selected cells in the column. The option is available if the Type contains both required parameters.

    The contents of all columns (except the Structure column) can be sorted by clicking on the column name.

    The following conditions must be met for the layer structure to be entered in the Type parameter:

    1. The Type contains the required parameters "Template" and "Result" 
    2. The column "Template" contains a structure wildcard
    3. The content in the columns "Current Result" and "New Result" has a difference
    4.  The “Update” checkbox is checked

    The first cell of each row is highlighted in one of the four colors in order to assess whether the Types meet the above conditions:

    • no color – no change, the Type parameters will not be updated
    • red – the required parameters "Template" and "Result" are missing or they have not been defined in the plugin settings
    • orange – the new result value is different from the current result value. The Type parameters will not be updated, because the Update checkbox is not checked
    • green – the new result value is different from the current result value. The Type parameters will be updated, because the Update checkbox is checked

    When the first cells of the rows of the required Types are green, you must click the Accept to update the parameter values in the model.  Note that only the visible green positions will be processed (for example, if the Type in the "Walls" category was checked and then the filter for the "Floors" category was enabled, then the Type in the "Walls" category will not be updated).

    To close the plugin window, press Cancel or press Esc.

    The status bar displays information about the number of Types in the table corresponding to the different conditions.

  • Change history for
    Year

    2023 Year

    Revit: Structure to parameter 1.1.1.0 (13.07.2023)

    Fix
    Fixed a bug that caused material names not to be displayed in the layer list.

    Revit: Structure to parameter 1.1.0.0 (12.07.2023)

    New
    Added the ability to specify the material parameter from which the material name will be taken.
  • Комментарии для сайта Cackle

ModPlus 2015-2023