Equipment

Equipment : Import/Export DGN : Import DGN
To run Import-DGN, on the Equipment tab, in the Import group, click DGN to display the window.
Use the AVEVA Everything3D - Import-DGN window to:
The current release of Import-DGN cannot translate some MicroStation Feature Solids. The MicroStation Solid Utilities: Convert to Solid tool can be used to convert these to Smart Solids.
Some dgn files are structured with a highly nested cell structure, with very few top-level elements. Import-DGN uses the top-level elements to help structure the model in the Design macro, so if a large model is composed of a very few cells with complex contents, it is best to use the MicroStation Drop Element tool (using the drop complex option) to drop these until the top-level elements are no more complex than the user wants to put into a single subequipment or substructure element in Design.
Import-DGN (Basic) cannot translate MicroStation Smart Solids, the MicroStation Drop Element tool can be used to drop all Solids to Surfaces.
Import-DGN (Basic) cannot translate some MicroStation Feature Solids. The MicroStation Solid Utilities: Convert to Solid tool can be used to convert these to Smart Solids, and follow the instructions above.
Use the Import-DGN window to choose the input and output files.
Click Clear to remove all files from the list.
Click Browse to select a macro or model file for output
If the Overwrite checkbox is selected, the output file can be overwritten without warning.
To translate a file with Import-DGN (Teigha® facilities), from the Options part of the window, select the DGN V8/V7 (Teigha®), and select the required options in the DGN V8/V7 (Teigha®) tab.
Scale enables the imported geometry to be scaled. A number larger than 1 makes the imported geometry bigger, and a number smaller than one makes the imported geometry smaller. A model can be corrected if the units in the DGN file are wrong, missing, or misinterpreted.
Shift (mm) shifts the whole model in E, N and/or U by the given numbers of millimetres. The a model can be positioned more conveniently, or simulate the MicroStation global origin.
Choose the number of messages to be written to the Output Summary and the Message file. The options available are Brief, Full or Debug. Debug is very verbose, and is primarily intended to help developers to investigate any issues with the translations of particular files.
The Unicode Output check box should normally be selected. Do not use this option if the macro is used in with older versions of PDMS.
Query DGN Info opens each DGN file listed, and writes some summary information about each into the Output Summary.
To translate a dgn7 format file with Import-DGN (Basic) technology, select the DGN V7 (Basic), and select the required options in the DGN V7 (Basic) tab.
Choose a suitable set of units. Query input file units opens the first dgn file listed, and display the units information found in it. Select a matching value from the Units drop-down. The possible choices are mm, cm, Metre, Inch, Foot, Yard.
Choose an output format, the possible values are Equipment (EQUI), Structure (STRU), Volume (VOLM), Review.
Enter or Browse for a file ImPlant - I1.exe commands, for example to set up Steel recognition.
Note:
Cancel is not active in an Import-DGN (Basic facilities) translation.
MicroStation works internally in terms of position units (also known as units of resolution), but also displays master units and sub-units (also known as working units). AVEVA E3D™ and Review work internally in millimetres, but can interact with the user in many other units.
To display the ISFF unit information from a file, use the Q UNITS command. For example, if the file being worked on is called example.dgn type:
In this case, the MicroStation user has chosen to use metres as the master unit, millimetres as the sub-unit, and has one eightieth of a millimetre as the position unit.
The recommended way to set the units is with the UNITS command. If the master unit is one of METRE (or METER), CM, MM, YARD, FOOT or INCH the user should use that keyword. In this case type:
Note:
Text in italic indicates what is being entered by the user.
Open a AVEVA E3D™ MODEL macro file called file1.mac which holds the AVEVA E3D™ commands for importing 3D data taken from the DGN files specified by the next ISFF commands. Every GENERATE command closes down any previous opened files.
Read the file turb1.dgn for 3D data and generate the commands for import to AVEVA E3D™ MODEL. The primitives generated are under the ZONE element called /turb1.dgn as no zone name was specified.
The STRUC command sets the mode so that the ISFF command generates the hierarchy STRUC/SUBST/Geometric primitives (BOX). The EQUIP command sets the mode so that the ISFF command generates the hierarchy ZONE/EQUIPMENT/Geometric primitives (BOX). In EQUIPMENT mode, the primitives are packed into the same EQUI until a MicroStation CELL entity is encountered. Then a new EQUI is generated. If GROUP ON is set in addition to EQUIPMENT mode then a new EQUI is generated for each micro station primitive.
The VOLM command does exactly the same as the EQUIP command but replaces all EQUIPMENT elements with VOLUME elements.
The ATTRIBUTES filename command opens a new attributes file and switches attribute processing on. Opening an attributes file closes any attributes file that is already open. ATTRIBUTES END closes the attributes file. The output of attributes can be toggled on and off.
Note:
Import-DGN maintains cell ownership and Review segments within a cell segment inherit the attributes of the cell segment. In other words, the segments within a cell do not have attribute entries within the AVEVA Attributes file, only significant segments do.
Read all files with extension .str which have been generated by MicroStation and append the primitive records to the Review file file3.model. Standard windows wild-card characters may be used.
Most of the EXCLUDE/INCLUDE options are self-explanatory. However there are some options that describe MicroStation type of primitives/records and others describe 3D type of models as generated by ImPlant - I.exe.
The MESSAGE command specifies an output file where all user commands and output messages can be stored. The MES END command closes the file.
2.
Run ImPlant - I.exe using the REPORTSTEEL ON command for discovering any possible steel structures (include profiles_british.imp and/or profiles_din.imp if appropriate). Import-DGN responds with one or more possible Steel Structure profiles.
There are three commands dealing with profiles: ADDSTEEL, REMSTEEL and REPORTSTEEL.
The ADDSTEEL command has the format:
ADDsteel spec_name
x y              (times number of points)
n
REPortsteel ON           report on possible profiles
REPortsteel OFF         do not report on possible profiles (default)
The STEELTOLERANCE command may be used to change the tolerance used in this matching process.
ImPLANT-I.exe -f 'Macro_file.mac' -o 'std_output.txt'
Refer to Example ImPlant - I.exe Session, for examples of using the main commands.
The ADDSTEEL command defines a steel profile in ImPlant - I.exe. The corresponding profile must be defined in the AVEVA E3D™/Outfitting Catalogue.
Refer to Steel Structures for further information.
The APPROX command sets the curvature approximation (chord tolerance). Values between 1 and 10 are allowed. The default is 5.
The ATTRIBUTES name command opens a new attributes file and switches attribute processing on. Use the ATTRIBUTES text variant if the filename is to contain spaces. Opening an attributes file closes one that is already open. ATTRIBUTES END closes the attribute file. The output of attributes can be toggled on and off. The ATTRIBUTES EXTENSION command allows the file extension of the associated file (by default, drv) to be changed.
The EQUIP command sets the mode so that the ISFF command generates the hierarchy Zone/Equipment/Geometric primitives (Box). In EQUIPMENT mode, the primitives are packed into the same EQUI until a MicroStation CELL entity is encountered. Then a new EQUI is generated. If GROUP ON is set in addition to EQUIPMENT mode, a new EQUI is generated for each micro station primitive.
The alternatives are the VOLM and STRUC commands.
The EXCLUDE command can be used to control which primitives are translated. The user can exclude primitives by type, by colour or by level. Refer to the INCLUDE command for further information.
The EXCLUDE LEVEL command has an extended form not shown in the picture to exclude several levels in one command; for example:
The EXTENSIONS command tells ImPlant - I.exe how to deal with certain non-standard constructions found in some DGN files (refer to ISFF Extensions for further information).
The FINISH command exits from AVEVA ImPlant - I.exe.
The GENERATE command opens a named file for input into Review or AVEVA E3D™. Any previously opened files are closed. The filename can be given as a name (with a leading /) or as text (enclosed in single quotes). If the filename contains spaces the text form must be used. If the supplied filename does not have an extension, ImPlant - I.exe adds .mac for a AVEVA E3D™/Outfitting macro file, or .rvm for a Review model file. AVEVA E3D™ is accepted as an alternative to MACRO for backwards compatibility.
The GROUPPRIMITIVES command affects how ImPlant - I.exe groups the Review and AVEVA E3D™ primitives. GROUPPRIMITIVES should be switched off if attributes are to be output.
The HOLLOW command specifies that DGN surfaces are output as surfaces, and not solids, which is the default.
The INCLUDE command is the opposite of EXCLUDE; that is, excluded options are included for export again. Refer to the notes on EXCLUDE and the example in Example ImPlant - I.exe Session, for further information on primitive types.
The ISFF command reads a named input file and generates a Review model file or a AVEVA E3D™ macro file. The filename can be given as a name (with a leading /) or as text (enclosed in single-quotes). If the filename contains spaces the text form must be used. If the filename does not contain spaces then wildcards can be used to read in several files at once. For example, on Windows:
Specify the name of the AVEVA E3D™ Zone as a name (with a leading /). If a new Zone element is not required, use the CONTINUE option to continue with the current zone. If a Zone without a name is required use the ANONYMOUS option. If no Zone name is given and neither of the other options is specified, then the Zone name is created from the input model filename.
>-- ISFF -- filename --+-- zonename ---.
                       |               |
                       |-- CONtinue ---|
                       |               |
                       |-- ANOnymous --|
                       |               |
                       ‘---------------+-->
The MESFIL command controls the message file and related facilities.
The filename (if required) can be given as a name (with a leading /) or as text (enclosed in single quotes). If the filename contains spaces the text form must be used.
To control echoing of commands from a macro to the message file use the ECHO ON and ECHO OFF commands. If using a lengthy standard macro, include an ECHO OFF at the start and an ECHO ON at the end of the macro. The command can be used, for example, in the supplied steel section macros.
To write a message directly to the message file use the MESSAGEFILE PRINT message command. The message must be enclosed in single quotes.
>-- MESsagefile --+-- filename ----------.
                  |                      |
                  |-- COPy -- filename --|
                  |                      |
                  |-- END ---------------|
                  |                      |
                  |-- ECHo --+-- ON -----|
                  |          |           |
                  |          `-- OFF ----|
                  |                      |
                  `-- Print-- message ---+-->
Use the PDMSCOMMAND command to write an AVEVA E3D™ command directly to the AVEVA E3D™ macro file, either at once or at the start of each Equipment. Each command must be enclosed in single quotes. Use two single quotes to represent a single quote within the command. For example:
>-- PDMScommand --+-- command ----------------------.
                  |                                 |
                  `-- EAChequipment --+-- command --|
                                      |             |
                                      `-- OFF ------+-->
Use the QUERY command to query the units used in a MicroStation file. The master units, sub-units and unit-of-resolution are output. The filename can be given as a name (with a leading /) or as text (enclosed in single quotes). If the filename contains spaces the text form must be used.
>-- Query --+-- units -- filename --.
            |                       |
            
|-- SETtings -----------|
            |                       |
            `-- TOLerances ---------+-->
The REMSTEEL command disables the matching of profiles while in ImPlant - I.exe. The command removes the matching of all previously defined profiles. Refer to the ADDSTEEL command for further information.
The REPSTEEL command controls reporting on possible profiles. Reporting can be restricted to profiles with fixed length.
>-- SHIft -- x -- y -- z -->
The SOLID command specifies that ISFF surfaces are output as solids, which is the default. To specify that surfaces should be used to produce hollow primitives, use the HOLLOW command.
use the STEELFILTER command to selectively include or omit elements recognised, or not recognised, as catalogue sections (refer to STEELFILTER Command for further information).
Use the STEELTOLERANCE command to set the tolerance (in mm) used when matching steel sections.
The STRUC command sets the mode so that the ISFF command generates the hierarchy STRUC/SUBST/Geometric primitives (Box). The alternatives are the EQUIP and VOLM commands.
The TOLERANCE command is provided for the rare cases when altering the tolerances can improve the translation.
TOLERANCE DEFAULT restores the recommended values.
TOLERANCE QUERY displays the current tolerance values (equivalent to QUERY TOLERANCE).
TOLERANCE FACTOR scales all the tolerances in proportion, and should be the first option to try if tolerances are to be adjusted. A factor of 1.0 is the same as DEFAULT, a factor of 2.0 loosens the tolerances, and a factor of 0.5 tightens them.
>-- TOLerance --+-- DEFault -----------.
                |                      |
                |-- Query -------------|
                |                      |
                |-- FACtor --
factor --|
                |                      |
                |-- NUMber -- value ---|
                |                      |
                |-- ANGle -- value ----|
                |                      |
                |-- VECtor -- value ---|
                |                      |
                |-- POInt -- value ----|
                |                      |
                |-- POLygon -- value --|
                |                      |
                `-- NORmal -- value ---+-->
The VOLM command sets the mode so that the ISFF command generates the hierarchy Zone/VOLuMe/Geometric primitives (Box). In VOLuMe mode, the primitives are packed into the same VOLM until a MicroStation CELL entity is encountered, when a new VOLM is generated. If GROUP ON is set in addition to VOLuMe mode, a new VOLM is generated for each micro station primitive.
Other alternatives are the EQUIP and STRUC commands.
keyword <blank>{<blank><attLink><blank>text<blank>{<attVal><attVal>
Details of this output, particularly at full and debug levels of detail are likely to change significantly from release to release to provide more useful information for support calls.

1974 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.
AVEVA Logo