Icon
Related news and articles
Using
The plugin contains a set of tools to perform an apartment building layout. The tools are presented as tabs in a logical sequence of execution:
- set basic settings
- create or map parameters
- check and correct invalid rooms
- complete the collection of apartments
- calculate areas and apartments typology
- number the apartments
Each tab contains switchable instructions.
The "Functional purpose" parameter, to be completed manually, is used for identification of rooms to be processed.
Example Excel file with the room matrix and apartment types – download.
Settings
Apartment identifier – sets the value of the "Functional purpose" parameter, by which the rooms to be processed will be defined. You can specify multiple apartment identifier values separated by semicolons without spaces. The default value is "Apartment".
Allowed identifiers – the list of values that can be in the "Functional purpose" parameter, but must not be processed by the plugin algorithms.
Take into account typical floors when collecting and calculating apartments – this option allows to copy values of compartment parameters for identical floors from corresponding compartments of a typical floor specified on the Sources tab. This option is duplicated on the Collecting apartment and Calculating apartment tabs – if you enable it on any of the three tabs, it will also be enabled on the others.
Restore hidden instructions – restores hidden instructions on all tabs.
Rounding areas – specifies parameters for rounding the area when calculating. Rounding is taken into account at each step of the calculation (room area is rounded, then the calculated apartment areas are rounded).
When calculating the area with a coefficient, you can choose which area will be multiplied by the factor – rounded or the original area.
Below there are drop-down lists indicating which area – rounded without/by factor – to use for calculating living area, apartment area and total apartment area.
Parameters
This tab contains a list of parameters that are required for the plugin to work. The list specifies the parameter name, parameter data type, and parameter description. On the right side of the list you can specify custom common parameters from the current document (parameter mapping). Parameter mapping data is stored in the document.
Parameter data types – text, area, currency – allow you to work with rooms that are in groups.
Use system parameter "Number" instead of "RM_Room number" parameter – if checked, the room number will be written to the system parameter "Number". In this case, the parameter "Room_Number" may not be added to the project.
Open parameter list in notepad – displays a list of parameters in notepad, allowing you to add parameters to the file of general parameters.
Create missing parameters – creation of all parameters missing from the list in the current document
Save as default – saves the current parameter mapping as default. If you run the plugin in another document that has parameters from the mapping, they will be automatically selected in the list.
All subsequent tabs become available if two conditions are met: all the necessary parameters are present in the document and the apartment identifier is specified in the settings.
Sources
The sources contain the data needed to calculate the areas of the apartments, to determine apartment types and to specify typical floors.
You can create and store in the plugin several source variants (several room matrices and several tables of apartment types and typical floors). The processing will be performed on the current sources. That is, the sources selected in the drop-down lists.
You can export the current sources – the current matrix, the current table of apartment types and the current table of typical floors - to a single Excel file using the Export current sources to Excel button, and you can export all existing sources to a single Excel file using the Export all sources to Excel button.
The table contains the data used for calculating the apartment areas:
- Room Name (the value of the built-in parameter "Name") is the key by which the values below are matched
- Finishing thickness – thickness of rough finish of compartment in millimeters, which enables taking the finishing layer into account without modeling. It is written to the room parameter (AP_ Finishing thickness) and taken into account when calculating the area of the room (AP_Rounded area).
- Room type – drop-down list that specifies room type (Residential/Non-residential/Non-heated). It is written to the room parameter (AP_Room Type).
- Area factor – a decreasing coefficient with a valid value from 0.1 to 1.0. It is written in the room parameter (AP_Area Factor). It is taken into account when calculating the area with a coefficient (AP_Area with factor) and the area of unheated rooms with a coefficient (AP_Non-heated rooms area). It can also be taken into account when calculating the apartment area, living area and total area, if the corresponding option is specified in the settings (tab " Apartment areas").
- Numbering priority – specify the numbering priority within the apartment
Export, Import – export/import of room matrix to/from Excel. When importing, it is possible both to overwrite the current table in full and to supplement it.
The table contains the data used to determine apartment types when calculating the area of apartments according to the following criteria:
- Number of living rooms
- Minimum area – if a value of 0 is specified, will not be taken into account
- Maximum area – if a value of 0 is entered, will not be taken into account
- Contains rooms – the list of rooms that must be present in the apartment. The rooms are to be separated by semicolons. Optional
- Not contains rooms – a list of rooms that are to be absent in the apartment. The rooms are to be separated by semi-colons. Optional
Below the list there is a drop-down list, indicating what kind of area (floor, living area, total area), the value of which is specified in columns "Minimum area" and "Maximum area" must be used when defining the type of apartment.
Export, Import – export/import of apartment types to/from Excel. When importing, it is possible both to overwrite the current table in full and to supplement it.
In the table for repetitive floors it is specified which floor is a typical floor for them. Floors can be defined both by level names and by level elevations.
If a typical floor is specified for a floor, then when collecting and calculating apartments, all parameters of rooms located on the specified floor will be taken from the corresponding rooms located on the typical floor.
The correspondence of a room to the type floor is determined by means of a vertical ray passed through the insertion point of this room. If a room on the standard floor intersects with this ray, they are considered to match.
Export, Import – export/import of typical floors to/from Excel. When importing, it is possible both to overwrite the current table in full and to supplement it.
Initial Check
It includes checking if there are unplaced rooms in the project, checking if the "Functional purpose" parameter is filled in correctly and if the pair of "Functional purpose" + "Name" parameter values correspond to the ones defined in the room matrix.
 |
– deleting of selected rooms in the "Unplaced rooms" table |
 |
– deletion of all rooms in the table "Unplaced rooms" |
 |
– in line: highlighting and zooming in a non-invalid room. To the right of the table - highlighting and zooming in all non-invalid rooms in the current view |
Note: if a invalid room has the problem "Functional purpose parameter has invalid value", but the value of this parameter is necessary for current project, this value should be added to the list " Allowed identifiers" on the tab "Settings".
Note: Checking of unenclosed rooms is not performed at this stage.
LOCKED APARTMENTS
Displays the apartments whose rooms have been locked. Locked rooms will be ignored when collecting apartments, regardless of the "Functional purpose" parameter value. The locking of apartments is done on the "Collecting apartments" tab.
To unlock the apartments, select the apartments and press the 
button.
Collecting apartments
Automated collection of apartments, which is made through geometrical characteristics of rooms, taking into consideration the connection of rooms through doors and room dividers.
If the window has zero Sill Height and the Head Height more than 2m, then it is considered a door.
During apartment collection all rooms belonging to one apartment are assigned a common value in parameter "AP_Apartment ID". The value of the parameter can change when collecting apartments again.
Apartment collection can be performed on the current view, on the entire project, or on selected rooms.
If the option Take into account typical floors is enabled, the collection of apartments is performed on the typical floors, and the information from the typical floor is copied for the floors corresponding to the typical floors:
- if apartment areas are collected in the project, then the typical floors are processed first. Then, if the floor is assigned a typical floor, the rooms on the typical floor are searched for by means of a vertical beam check and, if they match, the parameters are copied from the typical floor. If the floor is not assigned a typical floor, the standard processing of rooms is performed.
- If the collection is performed on the current view or if the selected rooms and the current floor are assigned to a typical floor, the properties are copied without any check. If the type floor is not collected in advance, the parameter values will be zero on the current floor.
The collection of apartments allows to identify unenclosed rooms, rooms without openings, as well as spaces without rooms in the project. Such rooms will be displayed in the list of "Invalid rooms". They can be manually added to the apartment selected above using the 
.
Several apartments can be merged into one. To do this, select the apartments in the list and click 
button to the right of the list. If the selected apartments are on different levels, they will not be merged.
Apartments can be locked. The rooms of the locked apartments will be ignored during the next apartment collection, regardless of the value of the "Functional purpose" parameter. To lock the apartments, select the apartments in the list and press the 
button. The locked apartments will be removed from the current list and added to the list on the "Blocked" tab.
Note: it is recommended to perform a visual inspection of this stage by means of color schemes.
Calculate apartments
Apartment calculation includes: filling in the data from the "Room matrix" source, calculating the apartment areas, numbering the rooms in the apartment, taking into account the numbering priority, and defining the apartment type from the "Apartment types" source. All obtained values are assigned to the parameters of compartments included in the apartment.
When calculating the apartment areas, the "AP_Apartment tag" parameter is also filled in: the room of the apartment with the largest area is filled in with "1" value, the other rooms are filled in with "0" value.
Apartment calculation can be performed on the current view, on the entire project, or on selected rooms.
If the option Take into account typical floors is enabled, the calculation of apartments is performed on the typical floors, and the information from the typical floor is copied for the floors corresponding to the typical floors:
- if apartment areas are calculated in the project, then the typical floors are processed first. Then, if the floor is assigned a typical floor, the rooms on the typical floor are searched for by means of a vertical beam check and, if they match, the parameters are copied from the typical floor. If the floor is not assigned a typical floor, the standard processing of rooms is performed.
- If the calculation is performed on the current view or if the selected rooms and the current floor are assigned to a typical floor, the properties are copied without any check. If the type floor is not calculated in advance, the parameter values will be zero on the current floor.
Apartment editor
The apartment editor allows you to make manual changes to the values of the apartment areas, as well as to merge multilevel apartments. When merging multilevel apartments, the areas are recalculated and the value of the "AP_Levels count" parameter is filled in.
If in one file there are several sections with different level marks and multilevel apartments in them, you should use the room filter by parameters. With its help you can filter apartments located only in one section and merging multilevel apartments. In order to obtain correct results when merging apartments, it is necessary to use parameters in the filter whose values are the same for all rooms of the apartment.
IMPORTANT: When recalculating apartments on a particular level, the parameter values of rooms belonging to the multilevel apartment, but located on another level, will not be recalculated.
Numbering
Numbering can be done by grouping the apartments by Housings and/or Sections by enabling the corresponding options and by specifying the parameter names from which to take the value of the Housing and/or Sections. In this case, it is considered that the sections are subgroups for the housings. The End-to-end numbering property means that the numbering in the next group will continue, not start from the value set in the Initial number property.
If you select the Point option in the Start of numbering property, then you will have to select the room determining from which apartment the numbering will start for each group of apartments:
If you enable the Reset numbering for each level (non-directional numbering) option, then at each level the numbering will start from the value specified in the Initial number property.
If the Parameter value to number option is enabled, a prefix with the specified parameter value (if any), separated by by Delimiter, is added to the apartment number. If the Housing to number and Section to number options are enabled, the same prefixes will be added, according to the parameters specified in the grouping. All values are added in the sequence "Housing-Section-Parameter-Number".
You can number the apartments in the current view or in the whole project.
Numbering by curve – allows to number the apartments, along the curve that crosses the apartments. The curve can be a Detail line or a Model line. When numbering by curve, the grouping by Housings and Sections, as well as the Numbering direction and Start of numbering are not taken into account. When numbering throughout the project, the selected curve will be used on all floors.
The number of the apartments is set to the specified Target parameter.
Views of apartments
Creating apartment views is done by duplicating the current view, followed by cropping along the contour of the apartment. First of all, an attempt is made to create a crop contour considering the thickness of the enclosing walls (only for Revit 2020 and higher). If unsuccessful, an attempt is made to create a crop contour taking into account the thickest of the enclosing walls. If the crop contour is not created, the apartment contour obtained from the room boundaries will be used. If the option "Try to use apartment type as view name" is enabled, the created views will be given a name of the type "LEVEL_NAME - Apartment APARTMENT_TYPE".
AUTO CALCULATION
Command to operate the automatic recalculation service that:
- performs apartment area recalculation and apartment type definition when the geometry of the rooms included in the apartment changes
- performs full recalculation (completion according to the room matrix, area calculation, calculation of number of living rooms, numbering of rooms, defining the type of apartment) after deletion of rooms, included in the apartment
The automatic recalculation service does not take into account typical floors. If the service is enabled, the parameters will be recalculated for apartments of all floors when geometry changes or rooms are removed.
The automatic recalculation service only processes rooms with a filled in " AP_Apartment ID" parameter.
The automatic recalculation service works even after the license validity period has expired, as long as the rooms have a full " AP_Apartment ID" parameter.
The automatic recalculation service only processes apartments whose functional purpose is equal to the current "Apartment identifier". For example, if the function purpose of the apartment is "Office" and the current identifier in the settings is " Apartments", the apartment will not be recalculated.