0% found this document useful (0 votes)

48 views

ImPLANT-I Installation and User Guide

Uploaded by

peyman

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

48 views

ImPLANT-I Installation and User Guide

Uploaded by

peyman

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 60

ImPLANT-I

Installation and User Guide

AVEVA Solutions Limited

Disclaimer
1.1 AVEVA does not warrant that the use of the AVEVA software will be uninterrupted, error-free or free from
viruses.

1.2 AVEVA shall not be liable for: loss of profits; loss of business; depletion of goodwill and/or similar losses; loss of
anticipated savings; loss of goods; loss of contract; loss of use; loss or corruption of data or information; any
special, indirect, consequential or pure economic loss, costs, damages, charges or expenses which may be
suffered by the user, including any loss suffered by the user resulting from the inaccuracy or invalidity of any data
created by the AVEVA software, irrespective of whether such losses are suffered directly or indirectly, or arise in
contract, tort (including negligence) or otherwise.

1.3 AVEVA's total liability in contract, tort (including negligence), or otherwise, arising in connection with the
performance of the AVEVA software shall be limited to 100% of the licence fees paid in the year in which the user's
claim is brought.

1.4 Clauses 1.1 to 1.3 shall apply to the fullest extent permissible at law.

1.5 In the event of any conflict between the above clauses and the analogous clauses in the software licence under
which the AVEVA software was purchased, the clauses in the software licence shall take precedence.

Copyright
Copyright and all other intellectual property rights in this manual and the associated software, and every part of it
(including source code, object code, any data contained in it, the manual and any other documentation supplied
with it) belongs to, or is validly licensed by, AVEVA Solutions Limited or its subsidiaries.

All rights are reserved to AVEVA Solutions Limited and its subsidiaries. The information contained in this document
is commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without
the prior written permission of AVEVA Solutions Limited. Where such permission is granted, it expressly requires
that this copyright notice, and the above disclaimer, is prominently displayed at the beginning of every copy that is
made.

The manual and associated documentation may not be adapted, reproduced, or copied, in any material or
electronic form, without the prior written permission of AVEVA Solutions Limited. The user may not reverse
engineer, decompile, copy, or adapt the software. Neither the whole, nor part of the software described in this
publication may be incorporated into any third-party software, product, machine, or system without the prior written
permission of AVEVA Solutions Limited, save as permitted by law. Any such unauthorised action is strictly
prohibited, and may give rise to civil liabilities and criminal prosecution.

The AVEVA software described in this guide is to be installed and operated strictly in accordance with the terms
and conditions of the respective software licences, and in accordance with the relevant User Documentation.
Unauthorised or unlicensed use of the software is strictly prohibited.

Copyright 2008 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved. AVEVA shall not
be liable for any breach or infringement of a third party's intellectual property rights where such breach results from
a user's modification of the AVEVA software or associated documentation.

AVEVA Solutions Limited, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom.

Trademark
AVEVA and Tribon are registered trademarks of AVEVA Solutions Limited or its subsidiaries. Unauthorised use of
the AVEVA or Tribon trademarks is strictly forbidden.

AVEVA product/software names are trademarks or registered trademarks of AVEVA Solutions Limited or its
subsidiaries, registered in the UK, Europe and other countries (worldwide).

The copyright, trademark rights, or other intellectual property rights in any other product or software, its name or
logo belongs to its respective owner.
ImPLANT-I Installation and User Guide

Revision Sheet

Date Version Comments / Remarks

January 2012 Copyright added to all pages.
June 2013 2.3 Using AVEVA Licensing System (ALS).
ImPLANT-I Installation and User Guide
ImPLANT-I Installation and User Guide

ImPLANT-I Installation and User Guide

Contents Page

ImPLANT-I
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
How to Use This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1

Installing ImPLANT-I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1

Basic Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1
.NET Framework Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1
AVEVA Licensing System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2
Running in a Command Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2
Electronic Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2
Testing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2

Running ImPLANT-I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1

Modes of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1
ImPLANT-I Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1
ImPLANT-I 2 Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2
ImPLANT-I 1 Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2
ImPLANT-I 1 or ImPLANT-I 2?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2
Preparing a DGN File for Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:3
Preparing for an ImPLANT-I 2 Technology Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:3
Preparing for an ImPLANT-I 1 Technology Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:4
Choosing the Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:4
Select One or More DGN Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:5
Select an Output File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:5

© Copyright 2008 to current year. i 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide

Choose a Message File (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:5

ImPLANT-I 2 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:5
ImPLANT-I 1 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:7
Running the Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:8
Defaults and Persistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:8
Using the ImPLANT-I Generated Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:9
Worked Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:9
ImPLANT-I 2 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:10
ImPLANT-I 1 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:11

Scripting ImPLANT-I 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Scripting ImPLANT-I 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1
Default Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:2
Units in ImPLANT-I.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:2
Example ImPLANT-I.exe Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:3
Notes on the Example Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:5
Steel Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:7
ImPLANT-I.exe Profile Macro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:7
ADDSTEEL Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:8
REMSTEEL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:9
REPORTSTEEL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:9
STEELFILTER Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:9
Recognising Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:9
ISFF Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:10
Command Line Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:10
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:11
Attribute Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:21

Limitations, Warnings and Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1

General Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1
PDMS/Marine Outfitting Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1
Review Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1
ImPLANT-I 2 Technology Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1
ImPLANT-I 1 Technology Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:2

© Copyright 2008 to current year. ii 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide

Geometry Transfer Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:2

ImPLANT-I 2 Warnings and Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:3
ImPLANT-I 2 Translation Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:3
ImPLANT-I2.exe Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:4
ImPLANT-I Dialog Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:5
ImPLANT-I 1 Warnings and Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:5
Warning Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:5
Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:6
Other Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:7

© Copyright 2008 to current year. iii 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide

© Copyright 2008 to current year. iv 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Introduction

1 Introduction

AVEVA ImPLANT-I is an application for translating dgn files (as used in MicroStation and
other applications) into DESIGN macro files suitable for input into AVEVA PDMS or AVEVA
Marine Outfitting.
Dgn version 7 format files can also be translated into Review model files, and if associated
Design Review (drv) files are available then these can be transferred to Review in AVEVA
Attribute File Format.
This release is the second release of ImPLANT-I to support version 8 of the dgn file format
(as written by MicroStation V8 and V8i), and not all the facilities of ImPLANT-I 1.7 for
translating dgn7 format files are available for dgn8 format files, however more dgn7 files are
well handled by the ImPLANT-I 2 facilities in this release.
Refer to ImPLANT-I 1 or ImPLANT-I 2? for advice on choosing whether to use ImPLANT-I 1
or ImPLANT-I 2 facilities (both are included in this release).
Before you can use AVEVA ImPLANT-I, it must have been installed and tested, as described
in Installing ImPLANT-I.

1.1 How to Use This Manual

The ImPLANT-I Installation and User Guide is divided into the following sections

Introduction a brief description of what ImPLANT-I does and some of its

background details.

Installing ImPLANT-I provides the installation instructions.

Running ImPLANT-I tells you how to use ImPLANT-I interactively.

Scripting ImPLANT-I 2 tells you how you to use ImPLANT-I with typed commands.

Scripting ImPLANT-I 1 provides a brief description of how to call ImPLANT-I as a batch

process.

Limitations, Warnings tells you about the limitations of ImPLANT-I, how you can work
and Errors round some of them, and explains the warning and error
messages you may see when using ImPLANT-I.

© Copyright 2008 to current year. 1:1 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Introduction

© Copyright 2008 to current year. 1:2 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Installing ImPLANT-I

2 Installing ImPLANT-I

ImPLANT-I is supplied on DVD or CD. The disk contains the installer, and an installable
version of Microsoft's .NET Framework. Also on the disk is a folder containing the
Installation instructions and user documentation, and it is recommended that you carefully
read all of the Installation instructions before installing the software.

2.1 Basic Installation

To install ImPLANT-I first insert the disk in your Workstation's DVD drive, click for Contents,
then select a product, and then follow the Installer instructions.
If the disk does not start, click Start > Run, and then browse for the Start.htm file.
During the installation sequence, follow the on-screen instructions as they appear. You will
be given a choice between two levels of installation:
• Standard installation:
Installs all available product components in the default location.
• Advanced installation:
Presents you with a list of all available product components from which you can select
those to be installed, and allows you to choose the Installation folder.
It is recommended that you use the default settings for folder paths etc. unless you have
good reasons for doing otherwise.

Note: The default installation disk may be set to the largest disk, and this is not always
appropriate. This can be checked and if necessary changed by clicking the
Advanced button on the installer.

The process needs at least 20Mb of free disk space for a full installation of all options.
When the process is complete, select Start > All Programs > AVEVA Plant > Design >
ImPLANT-I 2.3 or Start > All Programs > AVEVA Marine > Design > ImPLANT-I 2.3 to
reach the program and this documentation.

Note: If the installer detects an existing installation, it will display a set of options for
modifying/repairing/removing these existing files in place of the standard installation
options.

2.2 .NET Framework Installation

ImPLANT-I requires that an appropriate version of Microsoft's .NET Framework be installed.
If the installer is started from setup.exe, then the .NET Framework is installed automatically,
if required.

© Copyright 2008 to current year. 2:1 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Installing ImPLANT-I

2.3 AVEVA Licensing System

You must install and set up the AVEVA Licensing System before launching the installed
software. This will usually be done only on the server. Refer to the AVEVA Licensing System
Guide. News and update information is also available for AVEVA Licensing System on the
AVEVA support web-site.

2.4 Running in a Command Window

In order to make ImPLANT-I available as a command in a command window, the ImPLANT-I
installation folder may be added to the PATH environment variable. For detailed instructions
on how to do this refer to Windows Help.

2.5 Electronic Manuals

Electronic versions of the ImPLANT-I Manuals are available on the CD-ROM/DVD as .pdf
files. In order to display these Manuals you must have the Adobe Acrobat Reader software
installed on your PC. This software is also included on the CD-ROM/DVD. Installing this
software will enable you to view and print the ImPLANT-I Manuals.

2.6 Testing the Installation

Some example dgn files are supplied with ImPLANT-I. You will find all the required testing
material below the test subfolder of the installation folder (by default
C:\AVEVA\Plant\Design\ImPLANT-I2.3 or C:\AVEVA\Marine\Design\ImPLANT-I2.3). This
includes:

dgn8example.dgn A dgn8 format file.

tank1.dgn / tank2.dgn / Three dgn7 format files which can form a single model.
tank3.dgn

run_tests.bat A Windows batch file which runs ImPLANT-I.exe and

ImPLANT-I2.exe to translate the above dgn files.

E1_pdms.txt A macro file for ImPLANT-I.exe to translate tank1.dgn,

tank2.dgn & tank3.dgn to Design macro files.

E1_review.txt A macro file for ImPLANT-I.exe to translate tank1.dgn,

tank2.dgn & tank3.dgn to Review model files.

input_tests_to_PDMS.txt A macro to be run from the command-line of the Monitor

module, which switches into Design in non-graphics mode
and runs the macros produced by run_tests.bat.

test_report.txt The warnings produced when these tests are run, with
some explanation of them.

© Copyright 2008 to current year. 2:2 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Installing ImPLANT-I

You can run these tests with the ImPLANT-I GUI (refer to Worked Examples) or with the
run_tests.bat batch file. When this in run, it creates the following files:

dgn8example.mac A design macro created from dgn8example.dgn.

dgn8example_log.txt The messages produced alongside dgn8example.mac.

tank1.mac / tank2.mac / Design macros created from the three tank dgn files.
tank3.mac

E1_pdms_log.txt The messages produced alongside the three tank macro-

files.

tank1.rvm / tank2.rvm / Review model files created from the three tank dgn files.
tank3.rvm

E1_review_log.txt The messages produced alongside the three tank model-

files.

If ImPLANT-I has been installed in a folder where you do not have write permission, you will
need to modify the examples as appropriate.

© Copyright 2008 to current year. 2:3 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Installing ImPLANT-I

© Copyright 2008 to current year. 2:4 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3 Running ImPLANT-I

3.1 Modes of Operation

3.1.1 ImPLANT-I Dialog

The usual way to run ImPLANT-I is with the Graphical User Interface (GUI).

The GUI allows you to:

• choose the input and output files
• choose whether to use ImPLANT-I 2 or ImPLANT-I 1 translation technology
• set any options you need
• run the translation
• review the output messages.
See later in this chapter for further details.

© Copyright 2008 to current year. 3:1 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3.1.2 ImPLANT-I 2 Command Line

If you wish to run the ImPLANT-I 2 technology from the windows command line, or from a
script such as a Windows .bat file, a perl program, or from PML using the SYSCOM
command, you can use the ImPLANT-I2.exe program from the ImPLANT-I installation folder
(by default C:\AVEVA\Plant\Design\ImPLANT-I2.3 or C:\AVEVA\Marine\Design\ImPLANT-
I2.3).
All the options for ImPLANT-I2.exe are supplied as command-line arguments.
Refer to Scripting ImPLANT-I 2.

3.1.3 ImPLANT-I 1 Command Line

If you wish to run the ImPLANT-I 1 technology from the windows command line, or from a
script such as a Windows .bat file, a perl program, from PML using the SYSCOM command,
you can use the ImPLANT-I.exe program from the ImPLANT-I installation folder (by default
C:\AVEVA\Plant\Design\ImPLANT-I2.3 or C:\AVEVA\Marine\Design\ImPLANT-I2.3).
Refer to Scripting ImPLANT-I 1.

3.2 ImPLANT-I 1 or ImPLANT-I 2?

This release of ImPLANT-I improves the new technology for translating dgn8 format files.
Not all the facilities of previous versions of ImPLANT-I are currently available with this
technology and so the previous ImPLANT-I 1 technology is also included in the release. This
section describes which facilities are supported by which technology, and in some case
work-rounds or suggestions.
Future releases of ImPLANT-I may change some of this behaviour.

ImPLANT-I 2 technology ImPLANT-I 1 technology

Read dgn version 7 format Yes Yes
files
Read dgn version 8 format Yes No (it is possible in MicroStation
files to save as MicroStation V7 DGN
files)

Create Design macros Yes Yes

Create Review model Files No (it is possible to import the Yes

model to a Design database, and
export a Review model

Recognise Steel sections No Yes (with the same limitations

as previous releases)

Translate B-Spline Surfaces Yes No

Translate Smart Solids Yes No

Translate Feature Solids No (in some cases a partial No

translation will be made, and
MicroStation has a "Convert to
Solid" option which can convert a
Feature Solid to a Smart Solid).)

Translate Shared Cells Yes No

© Copyright 2008 to current year. 3:2 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

Make use of the MicroStation No (a 3D shift may be applied Yes

"Global Origin" during the translation to achieve
the same effect)

Exclude certain elements by No Yes

type, colour or level

There are some cases where the translation of MicroStation geometry differs between
ImPLANT-I 1 and ImPLANT-I 2. ImPLANT-I 2 does a more complete job but can translate
somewhat fewer types of geometry into standard primitives. For example, some elements
recognised as extrusions by ImPLANT-I 1 may be translated as a facetted polyhedron in
ImPLANT-I 2. However, it does translate others to a more compact and faster
representation.
AVEVA welcomes examples where users feel the translation could be improved. These will
be considered when planning future releases and are best submitted through the usual
support channels. (Small and simple dgn files are best, for example a single pipe or
structural element copied out of a larger model).
Refer to Limitations, Warnings and Errors.

3.3 Preparing a DGN File for Translation

MicroStation dgn files can contain a very wide range of models - from a single small
component up through a complete building and its contents. ImPLANT-I makes some
assumptions as it translates the model, and so it sometimes possible to improve the
translation by making changes to it.

3.3.1 Preparing for an ImPLANT-I 2 Technology Translation

Select the Model

ImPLANT-I 2 currently imports only the currently selected model in a dgn8 file. Make sure
that this is set correctly.

Units
Check that the dgn file units are set correctly.
ImPLANT-I 2 attempts to extract the units information from the dgn files and is usually
successful. In some cases, particularly when reading a dgn7 format file, ImPLANT-I does
not make the same assumptions as MicroStation. In these cases you can either adjust the
scale factor to correct the translation, or use MicroStation to upgrade the file to dgn8 format,
and ensure that the working units are set correctly.

Global Origin
ImPLANT-I 2 (unlike ImPLANT-I) currently ignores the Global Origin set in the dgn file. Shifts
can be applied to the model produced to position it in the appropriate position in space.

Large Cells
Some dgn files are structured with a highly nested cell structure, with very few top-level
elements. ImPLANT-I 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 tool (using the drop complex option) to drop these until the

© Copyright 2008 to current year. 3:3 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

top-level elements are no more complex than you would wish to put into a single
subequipment or substructure element in Design.

Feature Solids
The current release of ImPLANT-I cannot translate some MicroStation Feature Solids. The
MicroStation Solid Utilities: Convert to Solid tool can be used to convert these to Smart
Solids.

3.3.2 Preparing for an ImPLANT-I 1 Technology Translation

Units
ImPLANT-I 1 does not attempt to interpret the unit settings automatically. It is worth
checking the settings in MicroStation to understand what ImPLANT-I units setting is
appropriate.

Large Cells
Some dgn files are structured with a highly nested cell structure, with very few top-level
elements. ImPLANT-I 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 you would wish to put into a single
subequipment or substructure element in Design.

Shared Cells
ImPLANT-I 1 cannot translate shared cells. It MicroStation you can use the Drop Element
tool to drop all Shared Cells to Geometry. (This may need to be done more than once, in the
case where shared cells are nested).

Smart Solids
ImPLANT-I 1 cannot translate MicroStation Smart Solids. The MicroStation Drop Element
tool can be used to drop all Solids to Surfaces.

Feature Solids
ImPLANT-I 1 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.

File Format
If you are using MicroStation V8 or newer, use "Save As" on the file menu to save in
"MicroStation V7 DGN files" format.

3.4 Choosing the Files

The top-left area of the ImPLANT-I dialog allows you to choose the input and output files.

© Copyright 2008 to current year. 3:4 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3.4.1 Select One or More DGN Files

• Add one or more files to the DGN File(s) list using the Browse button
• You may, if you wish, remove files from the list by clicking on them to select them, and
then clicking Remove.
• The Clear button removes all files from the list.

3.4.2 Select an Output File

• You can use the Browse button to select a macro or model file for output.
• If the folder displayed is what you want, you may instead type a file name directly, but it
must not be the same as the message file, if any.
• If the Overwrite box is checked, the program will allow you to overwrite the output file
without warning you.

3.4.3 Choose a Message File (Optional)

If you wish, you can choose a file for the output messages. This works in the same way as
selecting the output file.

3.5 ImPLANT-I 2 Options

To translate a file with ImPLANT-I 2 technology, select the Version radio-button, and choose
the options you want in the Version Options Tab, at the bottom left of the dialog.

© Copyright 2008 to current year. 3:5 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

• The Scale Factor option lets you scale the imported geometry. A number larger than 1
makes the imported geometry bigger, and a number smaller than one makes the
imported geometry smaller. This can be used to correct a model if the units in the DGN
file are wrong, missing, or misinterpreted.
• The Shift (mm) option lets you shift the whole model in E, N and/or U by the given
numbers of millimetres. This can be used to position a model more conveniently, or
simulate the MicroStation global origin.
• You can choose a Design database element name to be wrapped around the translated
contents of each dgn file. The possibilities are ZONE, EQUIPMENT, STRUCTURE,
VOLMODEL or no element.
• If you choose to have a top-level element for each file you may choose to have that
element given a name based on the dgn filename.
• You can choose a Design database element name to be wrapped around the translated
contents group of top-level MicroStation elements. The possibilities are EQUIPMENT,
SUBEQUIPMENT, STRUCTURE, SUBSTRUCTURE, VOLMODEL, SVOLMODEL or
no element. Note that certain combinations are invalid, e.g. a STRUCTURE cannot
own SUBEQUIPMENTS.
• You can choose the number of top-level MicroStation elements to put in each lower-
level Design element. If the dgn file contains a large number of simple elements, then
you may prefer to group them together into Design elements, but if there are fewer
more significant elements, e.g. Cells, you may prefer to have each top level element in
a separate Design element.
• You may choose the number of messages to be written to the Output Summary and the
Message file. The possibilities are Brief, Full or Debug. The last is very verbose, and is
primarily intended to help AVEVA developers to investigate any issues with the
translations of particular files.
• You may choose to vary the tolerances used when translating some of the DGN
geometry. Coarse tolerance will give you a smaller, faster, but less precise model. Not
all DGN geometry is affected by this setting.
• If you are using a unicode-enabled version of PDMS/Outfitting (12.1.1 or above) you
may select the "Unicode Output" option. This will not normally be necessary, but if you

© Copyright 2008 to current year. 3:6 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

wish to use the "with name" option on files with non-ASCII names it may make the
element names and any error messages better. Do not use this option with older
versions of PDMS/Outfitting.
• The Query DGN Info button opens each DGN file listed, and writes some summary
information about each into the Output Summary.

3.6 ImPLANT-I 1 Options

To translate a dgn7 format file with ImPLANT-I 1 technology, select the Version 1.7 radio-
button, and choose the options you want in the Version 1.7 Options Tab, at the bottom left of
the dialog.

• You must choose a suitable set of units. The query input file units button will open the
first dgn file listed, and display the units information found in it. You must then select a
matching value from the Units drop-down. The possible choices are mm, cm, Metre,
Inch, Foot, Yard.
• You must choose an output format, the possible values are PDMS Equipment (EQUI),
PDMS Structure (STRU), PDMS Volume (VOLM), Review. (The PDMS options are
compatible with Marine Outfitting).
• You may, if you wish, enter or browse for a file ImPLANT-I1.exe commands, for
example to set up Steel recognition. Refer to Scripting ImPLANT-I 1 for details.
• Such commands may also be typed or pasted directly into the Extra Commands box.

© Copyright 2008 to current year. 3:7 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3.7 Running the Translation

The Status Bar at the bottom shows what the program needs before it can run a translation
- in this case it has all the information it needs, so all you need to do is click the Create
button.
When an ImPLANT-I 2 translation is running, the status bar shows an estimate of the
progress through the translation of the current file, and the Cancel button is active (but
sometimes takes rather a long time to respond), and various items of information are listed
to the Output Summary. (The Cancel button is not active in an ImPLANT-I 1 translation).

3.8 Defaults and Persistence

The first time the ImPLANT-I dialog is run, it will choose reasonable default values.
After being used, the ImPLANT-I dialog will remember most of the settings you have
chosen, including the folders used for files, but not the filenames themselves.

© Copyright 2008 to current year. 3:8 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3.9 Using the ImPLANT-I Generated Macros

The Design macro files generated by ImPLANT-I are text files, and can be examined and
edited in a text editor, if you wish.
The macro files can be very big and slow to import into design, particularly if the dgn files is
large, or contains many elements which translate into polygons or polyhedra. Importing the
macro files from the command line without graphics or tracing can make the process faster.
There is an example of this in the test folder installed with ImPLANT-I (by default
...\ImPLANT I2.3\Test\input_tests_to_PDMS.txt). This macro should be run from the
Monitor Command line:
dev tty
design
trace off
/*
new site /test_implanti
setstar
$m /dgn8example.mac
$m /tank1.mac
$m /tank2.mac
$m /tank3.mac
monit

3.10 Worked Examples

Refer to Testing the Installation for a non-interactive way to run these tests.

© Copyright 2008 to current year. 3:9 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3.10.1 ImPLANT-I 2 Example

© Copyright 2008 to current year. 3:10 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

3.10.2 ImPLANT-I 1 Example

© Copyright 2008 to current year. 3:11 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Running ImPLANT-I

© Copyright 2008 to current year. 3:12 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 2

4 Scripting ImPLANT-I 2

If you wish to run the ImPLANT-I 2 technology from the windows command line, or from a
script such as a Windows .bat file, a perl program, from PML using the SYSCOM command,
you can use the ImPLANT-I2.exe program from the ImPLANT-I installation folder (by default
C:\AVEVA\Plant\Design\ImPLANT-I2.3 or C:\AVEVA\Marine\Design\ImPLANT-I2.3).
All the options for ImPLANT-I2.exe are supplied as command-line arguments, for example.
ImPLANT-I2.exe -i "OldTestBed/V8-tank1.dgn" -o Shape.mac
There are several possible options. Most of them correspond to features available in the
dialog interface, but there are some others, primarily intended to help automated testing.

-h Print brief help

-i [path] The Input DGN file. You may enclose the path in double-quote
characters (for example to include spaces), e.g.
-i "C:\new examples\tank1.dgn"
-o [path] The Output Macro file. You may enclose the path in double-quote
characters (for example to include spaces). If you do not include a -o
option, the messages are sent to standard output, e.g.
-o Shape.mac
-m [path] the Messages (log) file. You may enclose the path in double-quote
characters (for example to include spaces). If you do not include a -d
option, the messages are sent to standard output, e.g.
-m Shape.lo
-scale N.M multiply the size of the model by N.M. A scale greater than 1 makes
the imported geometry bigger, and a scale less than 1 makes it
smaller, e.g.
-scale 0.25
-shift X Y Z shift the model by X Y Z mm, e.g.
-shift 1000 200 -250
-summary print summary information instead of translating the model.
-brief print brief messages - this is the default.
-full print full messages.
-filezone wrap all the output in a ZONE element (default).
-fileequi wrap all the output in an EQUIPMENT element.

© Copyright 2008 to current year. 4:1 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 2

-filestru wrap all the output in an STRUCTURE element.

-filevolm wrap all the output in an VOLMODEL element.
-filebare do not wrap all the output in an element.
-equi wrap top-level DGN elements in EQUIPMENT element(s) (default).
-sube wrap top-level DGN elements in SUBEQUIPMENT element(s).
-stru wrap top-level DGN elements in STRUCTURE element(s).
-subs wrap top-level DGN elements in SUBSTRUCTURE element(s).
-volm wrap top-level DGN elements in VOLMODEL element(s).
-svolm wrap top-level DGN elements in SVOLMODEL element(s).
-nocontainer do not wrap top-level DGN elements in element(s).
-limit N translate up to N top-level DGN elements into each container (the
default is 1, 0 means 'no limit').
-skip N skip N top-level DGN elements before starting translating.
-process N translate only N top-level DGN elements.
-debug print verbose messages useful to AVEVA development.
-named name the outermost element from the DGN file.
-tolfactor N.M multiply the default tolerances by the given number. 10.0 is a coarse
setting, 0.1 is a fine setting, and the default value is 1.0.
-unicode create unicode output files (utf-8 encoding with a byte-order mark).
This option must only be used with PDMS/Outfitting 12.1.1 and
above.

© Copyright 2008 to current year. 4:2 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

5 Scripting ImPLANT-I 1

The ImPLANT-I 1 facilities are available from the command line, either interactively or
scripted by using ImPLANT-I.exe, which can be found in the installed ImPLANT-I folder (by
default C:\AVEVA\Plant\Design\ImPLANT-I2.3 or C:\AVEVA\Marine\Design\ImPLANT-I2.3).
If ImPLANT-I.exe is run from a Windows command prompt without arguments, an
interactive "command-processor" session is started, but as an alternative several
command-line arguments are available, refer to Command Line Arguments.
When using ImPLANT-I.exe it is driven via the AVEVA Command Processor. You must
specify the type of file to be generated (PDMS or Review - for Marine Outfitting select
PDMS) and the names of the DGN Files whose graphics are to be translated.
A number of engineering items may be stored in one DGN file. When transferring data to
PDMS/Outfitting, AVEVA ImPLANT-I.exe will transfer all the engineering items into a single
database element. The database element will typically either be a ZONE (containing a
number of EQUIpment or VOLuMe elements) or a STRUCTURE element. ImPLANT-I will
allow you to specify the PDMS element type (EQUIPMENT, VOLM or STRUCTURE) and its
name (if any).
More than one DGN file can be input for each PDMS/Outfitting or Review output file, and
more than one PDMS/Outfitting or Review file can be generated within one ImPLANT-I.exe
session.
ImPLANT-I.exe has a macro-processing facility that enables you to create a file of
commands (called a macro) using a standard editor, and then ask ImPLANT-I.exe to
process the commands in that file. Therefore, you do not have to enter all commands
interactively every time.
An alternative approach is to generate the ImPLANT-I.exe script automatically with, for
example, a Visual Basic program, or a Perl script. ImPLANT-I.exe includes several
commands designed for use in such scripts.

5.1 Overview
A typical session using ImPLANT-I.exe can be divided into the following stages:
1. Start up ImPLANT-I.exe
2. You must specify the following:
• The distance units used in the DGN file.
3. You can optionally specify the following:
• How the MicroStation primitives are going to be grouped in PDMS/Outfitting/
Review.
• The curvature coarseness (or arc tolerance).
• A shift factor for the model, in millimetres.

© Copyright 2008 to current year. 5:1 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

• Which parts of the DGN model to exclude from the transfer.

• How surfaces will be imported into PDMS/Outfitting or Review (that is, hollow or
solid).
• Steel profile parameters.
• Whether you want commands and/or messages stored in a file.
• Whether a separate Equipment or VOLM is to be generated for each primitive.
4. You specify the Attribute Filename for output (if required). The output of attributes can
be toggled on and off for each DGN file processed.
5. You specify either the Design macro or the Review model filename.
6. You specify the DGN filename whose 3D graphics are to be translated. ImPLANT-I.exe
reads the DGN file and appends the appropriate data to the current output file (that is
the Design macro file or the Review model file), according to the parameters set at
Stage 2.
7. You can either finish the session or repeat the process from Stage 2 to export more
files.

5.2 Default Operation

By default ImPLANT-I.exe does the following:
1. By default, all the primitives generated will be under an EQUIPMENT element.
Normally, all DGN entities are grouped under the same EQUI. However, when a CELL
is encountered in the DGN file, a new EQUI is generated. When the import of the CELL
is complete, the elements that follow in the DGN file are grouped below another new
EQUI, and so on. To generate a separate equipment element for each primitive, you
can use the GROUPPRIMITIVES OFF command. You may also use the
GROUPPRIMITIVES command to limit the number of primitives in each EQUIPMENT,
VOLM or STRUCTURE.
2. You can specify the name of the PDMS/Outfitting element to create using the ISFF
command. If you do not specify a name, the filename is used instead. You may
alternatively indicate that the element should be anonymous, or that no top-level
element should be created.
3. The curved lines in the MicroStation surfaces are approximated into straight segments
and the curved surfaces around a projected curved surface are approximated to
convex planar faces. You can control the way the curved parts are approximated into a
number of straight segments or planar faces using the APPROX value which ranges
from 1 (very coarse, less faces/segments) to 10 (very smooth, more faces/segments).
The default is 5.
4. ImPLANT-I.exe will output all DGN surfaces as SOLID primitives by default.
5. The default is to INCLUDE ALL the primitives for export.
6. Attributes will not be output by default.
7. ImPLANT-I.exe has no default units.

5.3 Units in ImPLANT-I.exe

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). PDMS and
Review work internally in millimetres, but can interact with the user in many other units.
In order to successfully translate a DGN file for PDMS or Review it is necessary to convert
the units in the DGN file into millimetres. The DGN file contains two-letter abbreviations of

© Copyright 2008 to current year. 5:2 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

the names of the master unit and the sub-unit, but these abbreviations are not standardised,
and so the translation is not automatic.
To display the ISFF unit information from a file, use the Q UNITS command. For example, if
the file you are working on is called example.dgn you should type:
Q UNITS /example.dgn
This will produce a message like:
Master Units : ME
Sub-Units : MM
Resolution:
1000 : MM per ME
80 : Pos Units Per MM
Global Origin : 0.000000 0.000000 0.000000
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 you should use that keyword. In
this case you would type:
UNITS METRE
If the master unit is not one of these, you should supply the length of a master unit in
millimetres. In this case you could type:
UNITS 1000
as a metre is one thousand millimetres, but UNITS METRE is recommended.

5.4 Example ImPLANT-I.exe Session

The following example shows a typical session using ImPLANT-I.exe. References are made
to the stages described in Basic Installation at the appropriate points. Some of the
commands in the example are described in detail in Notes on the Example Session.
Text in italic indicates what the user is typing.

© Copyright 2008 to current year. 5:3 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

© Copyright 2008 to current year. 5:4 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

5.4.1 Notes on the Example Session

The commands used in the example are described in detail below:
GENERATE PDMS /file1
Open a PDMS DESIGN macro file called file1.mac which will hold the PDMS/Outfitting
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.
ISFF /turb1.dgn
Read the file turb1.dgn for 3D data and generate the PDMS commands for import to PDMS
DESIGN. The PDMS primitives generated will be under the PDMS ZONE element called /
turb1.dgn as no zone name was specified.
SOLID
After giving this command, any DGN surfaces will be output as solids. This command
should be used, for example, when exporting pipes, so that tubes or bends are exported as
cylinders and circular toruses and not as faceted models. The SOLID command is the
default and produces solid models.
UNITS METRE
Units in ImPLANT-I.exe
STRUC (or EQUIP or VOLM)
By default, all generated PDMS/Outfitting elements will be of type EQUIPMENT. To change
this to STRUCTURE use the STRUC command and the VOLM command to change to
VOLUME elements.
The STRUC command sets the mode so that the ISFF command generates the PDMS/
Outfitting hierarchy STRUC/SUBST/Geometric primitives (BOX etc.). The EQUIP command
sets the mode so that the ISFF command generates the hierarchy ZONE/EQUIPMENT/
Geometric primitives (BOX etc.). 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.
Note that the STRU and ZONE PDMS elements take the name of the DGN file supplied,
unless otherwise specified.
The VOLM command does exactly the same as the EQUIP command but replaces all
EQUIPMENT elements with VOLUME elements.
APPROX 3
Change the curvature approximation to 3 (more coarse than the default value of 5).
GROUPPRIMITIVES
Stops primitives being grouped into arbitrary hierarchies. This is important if attributes are
being output.
ATTRIBUTES /file3.att
For all geometry files processed by following ISFF commands, process the corresponding
attribute files with the same names and output the results in an AVEVA Attributes file named
file3.att. The attribute files normally have the file extension .drv, and their format is shown
in Attribute Translation.

© Copyright 2008 to current year. 5:5 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

The ATTRIBUTES filename command opens a new attributes file and switches attribute
processing on. Opening an attributes file will close any attributes file that is already open.
ATTRIBUTES END closes the attributes file. The output of attributes can be toggled on and
off.

Note: ImPLANT-I 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.

ISFF /*.str /BUILD

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.
If you wish to use file names which include spaces, or certain other characters, you must
use single-quotes around the name.
EXCLUDE BOX
From now on do not export boxes. To include them back again in this example the
commands INCLUDE ALL or INCLUDE BOX can be used.
EXCLUDE COL 0
After this command has been given, primitives with colour 0 will not be exported. To include
primitives with colour 0 again, the commands INCLUDE ALL or INCLUDE COL 0 can be
used. Note that sometimes MicroStation users use colour 0 to create a face that they
subsequently use to create a projected surface, or surface of revolution object with a
different colour. In this case there will be a clash of colour between the construction face
colour (that is 0) and the object's colour as they occur in the same place. To avoid this clash
of colours, in Review export only, exclude colour 0 from the model.
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 MicroStation types of primitives/records are described in the MicroStation
documentation and these are: CELL, TRUNCATED CONE, CAPPED SURFACE,
SURFACE, SURFACE OF REVOLUTION.
Other element types referenced by the EXCLUDE command:
CURVED SOLID Any solid that has been recognised as curved and which does not fit into
the standard curved primitives such as circular torus, rectangular torus
etc.
PLANAR SOLID Any solid that does not have curved parts and does not fit into the standard
primitives such as box, pyramid etc.
SHIFT 2000.0 3000.0 0.0
The SHIFT command specifies a shift in millimetres for the model.
MESSAGE /message
MES END
The MESSAGE command specifies an output file where all user commands and output
messages can be stored. The MES END command closes the file.

© Copyright 2008 to current year. 5:6 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

5.5 Steel Structures

ImPLANT-I comes with a facility for transferring steel structures from MicroStation Design
files to PDMS/Outfitting through the PDMS catalogue mechanism, using the Structure/
Framework/ Section hierarchy of PDMS. This involves the following stages:

Note: Steps 2 and 3 are not necessary if you know which profiles are used.

1. ImPLANT-I.exe is supplied with two macro files defining the British Standard and DIN
profiles included in the standard PDMS Catalogue Database:
profiles_british.imp
profiles_din.imp
These may be passed to ImPLANT-I.exe by the usual command processor $m
mechanism; for example:
$m/profiles_british.imp
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). ImPLANT-I responds with one or more possible Steel Structure profiles.
3. Look at the shapes of the reported profiles and decide if they match existing profiles
held in the catalogue. If some profiles do not exist, you may create corresponding
Catalogue components in the Catalogue database by, for example, using the
PARAGON module. If you choose not to create corresponding Catalogue components,
ImPLANT-I.exe will still import the objects, but not as Sections.
4. Create a macro containing the corresponding data that defines the profiles included in
the Catalogue.
5. Rerun ImPLANT-I.exe and this time run the macro created by Step 4 (and any standard
macro required). For PDMS transfers this will generate less data and so will speed up
the process.
6. The Design macro file created can be entered into PDMS/Outfitting through the
DESIGN module.
Note: The user will need to create the Catalogue components and the corresponding
Profile macro file once only. You can then use this file again when necessary.

5.5.1 ImPLANT-I.exe Profile Macro

Profiles of sections are entered in ImPLANT-I.exe through a series of commands, together
with the necessary data. These commands are in standard Command Processor format.
The typical way of entering these commands is through the macro facility; that is, you
prepare a macro file corresponding to the necessary commands, and then run the macro file
to process the commands. For example:
$m /<filename>
$m '<filename>'
This will run the commands you have entered into the macro called filename.
There are three commands dealing with profiles: ADDSTEEL, REMSTEEL and
REPORTSTEEL.

© Copyright 2008 to current year. 5:7 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

5.5.2 ADDSTEEL Command

The ADDSTEEL command has the format:
ADDsteel spec_name
n
xy (times number of points)
PARAM/ETERS END
where:
spec_name is the database name of the corresponding SPCO/CATR catalogue
element
n is the number of points defining the 2D profile
xy are the co-ordinates of the points defining the 2D profile
(Some additional options are permitted in the command, for compatibility with previous
versions of ImPLANT-I.exe, but these are now ignored.)
For example, consider the following I shape:

The following sequence of commands is an example describing the I-shape. For this, the
program computes the origin to be the average of all the points.
ADD /GENP1
12
92550.00 16450.00
92550.00 16415.00
92690.74 16415.00
92690.74 15585.00
92550.00 15585.00
92550.00 15550.00
92850.00 15550.00
92850.00 15585.00
92709.24 15585.00
92709.24 16415.00
92850.00 16415.00
92850.00 16450.00
PARAM END

© Copyright 2008 to current year. 5:8 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

The corresponding I-shape catalogue component has to be defined.

5.5.3 REMSTEEL Command

To disable the matching of profiles while in ImPLANT-I.exe, use the following command:
REMsteel
This command removes the matching of all previously defined profiles.

5.5.4 REPORTSTEEL Command

To control reporting on possible profiles, use the following commands:
REPortsteel ON report on possible profiles
REPortsteel OFF do not report on possible profiles (default)

5.5.5 STEELFILTER Command

To control whether elements recognised as Sections should be included in the output file,
use the following commands:
STEELFILTER SECtions ON
include recognised Sections in the output (default)
STEELFILTER SECtions OFF
do not include recognised Sections in the output
To control whether elements not recognised as Sections should be included in the output
file, use the following commands:
STEELFILTER NONSECtions ON
include non-Sections in the output (default)
STEELFILTER NONSECtions OFF
do not include non-Sections in the output

Note: Element types that are never Sections, such as cylinders and boxes, are not affected
by these commands.

(You might use these commands to see how much of a model is being transferred as
identified Sections and how much as geometrical primitives).

5.5.6 Recognising Profiles

The ImPLANT-I.exe program stores the definition of the profiles as read by the program
through the Profile macro file as described in a previous section.
For each DGN projected surface, the program will compare the profile of the surface with
the profiles stored. If it finds a match, the program then generates Framework and Section
elements. The Section element provides the SPRE, POSS, POSE, BANG, DRNS and
DRNE attributes (refer to the Design Reference Manual for definitions of these attributes).
The attribute SPRE is set to the spec_name as given in the Profile file.

© Copyright 2008 to current year. 5:9 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

To match a profile of a surface with a predefined profile the program checks:

1. That the number of points in each profile is the same.
2. That the total length of each profile is the same (within a tolerance).
3. That the area of each profile is the same (within a tolerance).
4. That the lengths of each span of each profile match (within a tolerance).
5. That the angles between each span of each profile match.
Note: Circular or curved steel sections are not considered for matching.

Note: There may be circumstances in which a profile is matched even though the projected
surface did not represent a steel section.

The STEELTOLERANCE command may be used to change the tolerance used in this
matching process.

5.6 ISFF Extensions

Some programs create DGN files that are not standard. ImPLANT-I.exe can be configured
to accept some of these extensions.
ImPLANT-I.exe normally requires that surfaces made by using rules, such as capped
surfaces, shall have their caps classified as PRIMARY and their rules as PRIMARY RULES.
To allow ImPLANT-I.exe to accept such surfaces, in which there is always exactly one
element in each cap and both the caps and the rules are classified as PRIMARY, type the
command:
EXTENSION RULES PRIMARY ON
To allow ImPLANT-I.exe to accept surfaces where the rules are classified as
CONSTRUCTION RULES, type the command:
EXTENSION RULES CONSTRUCTION ON
Some previous versions had the first extension always enabled for certain surfaces, but not
the second. The default behaviour is now for neither extension to be enabled.
To restore this default behaviour, type the command:
EXTENSION OFF

5.7 Command Line Arguments

-f <macro-filename> Process the specified macro file (Refer to ImPLANT-I.exe

Profile Macro)

-c <macro-filename> Process the specified macro file, suppressing the console

banner

© Copyright 2008 to current year. 5:10 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

-o <filename> Redirect the standard output to the specified file, i.e. create a
message file.

-w lines Set the output window size. If the number of lines is negative
the window will appear minimised. If lines equals 0 the window
will not appear.

Example:
Macro_file.mac
units metre
STRUC
$m/scriptfiles/profiles_din.imp
gen pdms /results/example.mac
isff /dgnfiles/inputfile1.dgn
isff /dgnfiles/inputfile2.dgn
fin

From the command line:

ImPLANT-I.exe -f 'Macro_file.mac' -o 'std_output.txt'
This will generate a .mac file called example.mac that can be loaded into DESIGN and a
report file called std_output.txt that can be read into any text editor, e.g. notepad.

5.8 Command Syntax

The following graphs describe the sequence of commands that you can use with ImPLANT-
I.exe.
Refer to Example ImPLANT-I.exe Session, for examples of using the main commands.

ADDSTEEL
The ADDSTEEL command defines a steel profile in ImPLANT-I.exe. The
corresponding profile must be defined in the PDMS/Outfitting Catalogue.

where:
spec_name is the name of the corresponding SPCO/CATR catalogue element
n the number of points defining the 2D profile
xy the co-ordinates of the points defining the 2D profile

© Copyright 2008 to current year. 5:11 2.3

AVEVA Solutions Limited and its subsidiaries.
All rights reserved.
ImPLANT-I Installation and User Guide
Scripting ImPLANT-I 1

(Some extra options are accepted by the program, for compatibility with previous
versions, but are now ignored.)
For more information, refer to Steel Structures.

APPROX
The APPROX command sets the curvature approximation (chord tolerance). Values
between 1 and 10 are allowed. The default is 5.
>-- APProximate -- val -->

ATTRIBUTES
The ATTRIBUTES name command opens a new attributes file and switches attribute
processing on. Use the ATTRIBUTES text variant if you want to use a filename
containing spaces. Opening an attributes file will close 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 you to change the file
extension of the associated file (by default, drv).

>-- ATTributes --+-- name ------------------.

| |
|-- text ------------------|
| |
|-- ON --------------------|
| |
|-- OFF -------------------|
| |
|-- END -------------------|
| |
`-- EXTension --+-- name --|
| |
`-- text --+-->

EQUIP
The EQUIP command sets the mode so that the ISFF command generates the
hierarchy Zone/Equipment/Geometric primitives (Box etc.). 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.
>-- EQUIPment -->

EXCLUDE
The EXCLUDE command can be used to control which primitives are translated. You
can exclude primitives by type, by colour or by level. Refer to the INCLUDE command.
The EXCLUDE LEVEL command has an extended form not shown in the picture to
exclude several levels in one command; for example:
EXCLUDE LEVEL 3,4-6,8

EXTENSIONS
The EXTENSIONS command tells ImPLANT-I.exe how to deal with certain non-
standard constructions found in some DGN files (refer to ISFF Extensions).
>-- EXTensions --+-- OFF -------------------------------------.
| |
|-- DEFault ---------------------------------|
| |
'-- RULes --+-- CONstruction --+-- ON -------|
| | |
| |-- OFF ------|
| | |
| '-- DEFault --|
| |
'--PRImary --------+-- ON -------|
| |
|-- OFF ------|
| |
'-- DEFault --+-->

FINISH
The FINISH command exits from AVEVA ImPLANT-I.exe.
>-- FINish -->

GENERATE
The GENERATE command opens a named file for input into Review or PDMS. Any
previously opened files will be closed. The filename can be given as a name (with a
leading /) or as text (enclosed in single quotes). If the filename contains spaces you
must use the text form. If the filename you supply does not have an extension,
ImPLANT-I.exe will add .mac for a PDMS/Outfitting macro file, or .rvm for a Review
model file.
>-- GENerate --+-- PDMS -----.
| |
‘—- REVIEW --+-- filename -->

GROUPPRIMITIVES
The GROUPPRIMITIVES command affects how ImPLANT-I.exe groups the Review
and PDMS primitives. GROUPPRIMITIVES should be switched off if attributes are to
be output.
For import to PDMS/Outfitting, all the primitives generated will be under a
EQUIPMENT element. Normally, all DGN entities are grouped under the same EQUI.
However, when a CELL is encountered in the DGN file, a new EQUI is generated.
When the import of the CELL is complete, the elements that follow in the DGN file are
grouped below another new EQUI, and so on. To generate a separate equipment for
each primitive, you can use the GROUPPRIMITIVES OFF command.

You may alternatively supply a maximum number of primitives to group under an

equipment. Under normal conditions hundreds of primitives per equipment will give
acceptable performance, but thousands of primitives per equipment may not. This
does however depend on the precise geometry involved.

>-- GROUPPrimitives --+-- ON ---.

| |
|-- OFF --+
| |
‘-- int --+-->

HOLLOW
The HOLLOW command specifies that DGN surfaces will be output as surfaces, and
not solids, which is the default. Note that drawing will be slower than for solids. To
change back to importing solids, use the SOLID command.
>-- HOLlow -->

INCLUDE
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 more information on primitive types.

ISFF
The ISFF command reads a named input file and generates a Review model file or a
PDMS/Outfitting command file. Any previously opened files will be closed. The
filename can be given as a name (with a leading /) or as text (enclosed in single-

quotes). If the filename contains spaces you must use the text form. If the filename
does not contain spaces then you may use wildcards to read in several files at once.
For example, on Windows:
ISFF 'someFolder\*.dgn'
You can specify the name of the PDMS Zone as a name (with a leading /). If you do
not want a Zone element to be created use the CONTINUE option to continue with the
current zone. If you want a Zone without a name use the ANONYMOUS option. If no
Zone name is given and neither of the other options is specified, then the Zone name
will be created from the input model filename.
>-- ISFF -- filename --+-- zonename ---.
| |
|-- CONtinue ---|
| |
|-- ANOnymous --|
| |
‘---------------+-->

MESFIL
The MESFIL command controls the message file and related facilities.
To send messages only to a message file use MESSAGEFILE filename.
To send messages both to the standard output and to a message file use
MESSAGEFILE COPY filename.
To send messages only to the standard output use MESSAGEFILE END.
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 you must use the text
form.
To control echoing of commands from a macro to the message file use the ECHO ON
and ECHO OFF commands. If you use a lengthy standard macro, you may wish to
include an ECHO OFF at the start and an ECHO ON at the end of the macro. This is
done, 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 ---+-->

PDMSCOMMAND
The PDMSCOMMAND command allows you write a PDMS command directly to the
PDMS 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 'NEW SITE \mySite'

PDMSCOMMAND EACHEQUIPMENT 'DESCRIPTION ''July 2008'''
>-- PDMScommand --+-- command ----------------------.
| |
`-- EAChequipment --+-- command --|
| |
`-- OFF ------+-->

QUERY
The QUERY command allows you to query the units used in a MicroStation file. The
master units, sub-units and unit-of-resolution will be output. The filename can be given
as a name (with a leading /) or as text (enclosed in single quotes). If the filename
contains spaces you must use the text form.
You can also query the current ImPLANT-I settings and the current tolerances.
>-- Query --+-- units -- filename --.
| |
|-- SETtings -----------|
| |
`-- TOLerances ---------+-->

REMSTEEL
The REMSTEEL command disables the matching of profiles while in ImPLANT-I.exe.
This command removes the matching of all previously defined profiles. Refer to the
ADDSTEEL command.
>-- REMsteel -->

REPORTSTEEL
The REPSTEEL command controls reporting on possible profiles. Reporting can be
restricted to profiles with fixed length.
>-- REPortsteel --+-- ON --+-----------------.
| | |
| `-- FIXedlength --|
| |
‘-- OFF -------------------+-->

SHIFT
The SHIFT command specifies a shift in millimetres for the model.
>-- SHIft -- x -- y -- z -->

SOLID
The SOLID command specifies that ISFF surfaces will be output as solids, which is
the default. To specify that surfaces should be used to produce hollow primitives, use
the HOLLOW command, but note that drawing will be slower than for solids.
>-- SOLid -->

STEELFILTER
The STEELFILTER command allows you to selectively include or omit elements
recognised, or not recognised, as catalogue sections (refer to STEELFILTER
Command).
>-- STEELFILTER --+-- SECtions -----+-- ON ---.
| | |
| ‘-- OFF --+
| |
‘-- NONSECtions --+-- ON ---|
| |
‘-- OFF --+-->

STEELTOLERANCE
The STEELTOLERANCE command lets you set the tolerance (in mm) used when
matching steel sections.
>-- STEELTOLerance -- tolerance -->

STRUC
The STRUC command sets the mode so that the ISFF command generates the
hierarchy STRUC/SUBST/Geometric primitives (Box etc.). The alternatives are the
EQUIP and VOLM commands.
>-- STRucture -->

TOLERANCE
ImPLANT-I.exe uses several geometric tolerances when translating primitives; for
example, to decide whether two points are coincident. We recommend that under
most circumstances you use the default settings, as these have been chosen to be
suitable for a wide range of DGN files.
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 you want to adjust the tolerances. 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.

The other tolerance options affect individual tolerances used in various

circumstances. These should very rarely need individual adjustment, and will not be
further explained here.
>-- TOLerance --+-- DEFault -----------.
| |
|-- Query -------------|
| |
|-- FACtor -- factor --|
| |
|-- NUMber -- value ---|
| |
|-- ANGle -- value ----|
| |
|-- VECtor -- value ---|
| |
|-- POInt -- value ----|
| |
|-- POLygon -- value --|
| |
`-- NORmal -- value ---+-->

UNITS
Specifies the size of a MicroStation master unit, by name or in millimetres, refer to
Units in ImPLANT-I.exe.
>-- UNITs --+-- MM -----.
| |
|-- CM -----|
| |
|-- MEtre --|
| |
|-- METEr --|
| |
|-- INch ---|
| |
|-- FOot ---|
| |
|-- YArd ---|
| |
‘-- val ----+-->

VOLM
The VOLM command sets the mode so that the ISFF command generates the
hierarchy Zone/VOLuMe/Geometric primitives (Box etc.). 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.
>-- VOLM -->

5.9 Attribute Translation

ImPLANT-I.exe assumes the following format for the attribute files that it reads in using the
ATTRIBUTE command:
keyword <blank>{<blank><attLink><blank>text<blank>{<attVal><attVal>
...
...
<attVal><blank>}<blank>}
or
<blank>}<blank>}
where:
<blank> is zero or more spaces.
<attLink> is four integer values separated by a space.
<attVal> is an attribute pair separated by a colon : . Any attribute pair that does not
contain a : is ignored and a warning given.

6 Limitations, Warnings and Errors

6.1 General Limitations

• Drawing annotation elements are ignored. This includes elements such as fonts, text,
2D data, dimensions etc, patterns and line-styles, raster data
• Most 3D elements which are not solid are ignored, including 3D lines and point-strings
• Most representation data, such as colours and levels and group data are ignored.
• Element Names are not transferred.

6.2 PDMS/Marine Outfitting Limitations

• Attribute data from .drv files is not transferred to the Design database.
• The data generated can be clash-checked in DESIGN. However, the DGN data cannot
be thoroughly checked for clashes within itself unless you create a separate
EQUIpment, VOLuMe or STRUcture for each primitive.
• Large amounts of data are generated for both PDMS/Outfitting and Review. This is
because neither PDMS/Outfitting nor Review can store non-standard primitive shapes
economically. This, for example, may cause problems with the DRAFT module. This
module can not cope with a large number of primitives under a significant element
(such as an Equipment, Volume, Structure, Polyhedron etc). There is a limit of 4096,
but performance will be severely degraded with more than 500. You may use the
GROUPP command to limit the number of primitives in an element in PDMS.
• Specifically, you are advised to read large Design macros by entering DESIGN in dev
tty mode and then use the TRACE OFF command before you run the design macro.
• Attribute data from .drv files is not transferred to the Design model.

6.3 Review Limitations

• The surfaces of an open surface of revolution are not smooth shaded.
• Cell Hierarchy is not transferred.

6.4 ImPLANT-I 2 Technology Limitations

Refer to ImPLANT-I 1 or ImPLANT-I 2? and Preparing for an ImPLANT-I 2 Technology
Translation for more details.
• ImPLANT-I 2 does not support output to review at this release.
• Steel sections cannot be recognised as such.
• Some feature solids cannot be translated unless they are first converted to Smart
Solids.
• Shared cells are expanded to geometry; they are not transferred as referenced items.

• The MicroStation Global Origin is not applied.

• Elements cannot be excluded by type, colour or level.
• Some elements are, at this release, translated as Polygons or Polyhedra instead of
simple primitives.

6.5 ImPLANT-I 1 Technology Limitations

Refer to ImPLANT-I 1 or ImPLANT-I 2? and Preparing for an ImPLANT-I 1 Technology
Translation for more information.
• Dgn8 format files are not supported.
• Any messages produced by the Command Processor are not stored in the message
file, e.g. syntax errors.
• Circular or curved steel sections are not considered for recognition.
• There may be circumstances that a steel profile is matched although that model was
not meant to be a steel structure.

6.5.1 Geometry Transfer Limitations

1. The following elements have not been implemented:
B-spline Pole (Type 21)
B-spline Surface Header (Type 24)
B-spline Surface Boundary (Type 25)
B-spline Knot (Type 26)
B-spline Curve Header (Type 27)
B-spline Weight Factor (Type 28)
2. The Curve element (Type 11) and Conic element (Type 13) are treated as a series of
straight segments and not as curves.
3. The translator does not deal with warped surface (double curved surfaces, typically
defined by B-Splines or other curves) and volumes defined by boundary elements
within the Surface Header (Type 18) or Solid Header (Type 19).
Type of Surface

0=Surface of projection implemented

1=Bounded Plane non implemented
2=Unbounded Plane not implemented
3=Right Circular cylinder implemented
4=Right Circular cone implemented
5=Tabulated cylinder not implemented
6=Tabulated cone not implemented
7=Convolute implemented
8=Surface of revolution implemented
9=Warped surface not implemented

Type of Solid

0=Volume of projection implemented

1=Volume of revolution implemented
2=Volume defined by boundary implemented as volume of projection
elements

4. 3D Lines are ignored.

5. Holes defined independently and not as part of a cell are ignored.
6. Holes made from negative cones are ignored.
7. Some wedges have been implemented using a different method; instead of two 3-sided
shapes and four ruled lines, a rectangle and line can be used with four ruled lines.
8. Shared Cell Definition and Shared Cell Instances have not been implemented.
9. Feature Solids, Smart Solids and Smart Surfaces are not supported.

6.6 ImPLANT-I 2 Warnings and Errors

There are several groups of errors and warnings that can be generated by ImPLANT-I 2
technology. Some of these are intended to help you correct the data you give to the
programs, and others are to help AVEVA support and development investigate problems
that occur when translating particular files.
Not all possible messages are included in these lists, and some messages have several
variants depending on the circumstances, and may include technical information from
internal software components. If you wish to raise a support call with AVEVA it is helpful if
you can include the precise error messages generated, if any.

6.6.1 ImPLANT-I 2 Translation Messages

This section includes example messages that may be generated during a translation, and
reported from either the ImPLANT2.exe command-line program or the ImPLANT-I dialog.

Version and Licensing Messages

• ImPLANT-I dgn8core version 2.X (MMM DD YYYY)
• Product is licensed to 'your company''
• AVEVA Licensing System Client version information
If ImPLANT-I cannot obtain a AVEVA Licensing System, messages will be issued, refer to
the AVEVA Licensing System Guide.

Invalid Option Warnings

• invalid scale value (????) ignored
• a ZONE is not suitable to wrap each DGN element - option ignored
• EQUI and ???? are incompatible: SUBE assumed
• STRU and ???? are incompatible: SUBS assumed
• VOLM and ???? are incompatible: SVOLM assumed

Progress Messages
The number and type of progress messages issued depends on the level of detail of
messages requested. These typically include basic details of the file, and its active units,
and the size and location of the whole model, and of each top-level element.
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.

Translation Errors
If a dgn files does not exist, or cannot be read (for example if it is locked by another
program, such as MicroStation you will get a message such as
• failed to read DGN file 'filename' <details>
ImPLANT-I 2 issues fewer warnings while processing elements than ImPLANT-I - it will
usually process each element as far as it can, and silently ignore it otherwise. Under some
circumstances it will fail to process an element in an unexpected way, and in this case you
may receive one of the following errors:
• Internal Error: OdError caught <details>
• Internal Error: std::exception caught <details>
• Internal Error: Other Exception caught <details>
• *** Exception caught: <details>
These errors may cause elements to be skipped, or in some cases cause the whole
translation to stop.
Possible causes for these messages include corrupt dgn files, but may also include
particular constructions in the file that require special handling by ImPLANT-I that has not
yet been implemented.
Examples of files that trigger these messages would useful for improving future releases of
ImPLANT-I. These are best submitted through the usual support channels.

6.6.2 ImPLANT-I2.exe Messages

Messages that are only issued by ImPLANT-I2.exe are mainly to do with the command
arguments, e.g.
• missing Input file for -i argument
• missing Output (macro) file for -o argument
• missing Messages file for -m argument
• missing scale factor for -scale argument
• missing X-shift for -shift argument
• missing Y-shift for -shift argument
• missing Z-shift for -shift argument
• missing number of elements for -skip argument
• missing number of elements for -process argument
• missing number of elements for -limit argument
• Unexpected argument '?????' ignored
• Failed to open Message file 'some_file.log' <for some reason>
• Failed to open Output (macro) file 'some_file.log' <for some reason>

6.6.3 ImPLANT-I Dialog Messages

Messages reported by the ImPLANT-I dialog can include messages from ImPLANT-I 2
Translation Messages or ImPLANT-I 1 Warnings and Errors as well as messages such as
the following:
• File ????? does not exist
• Folder ?????? does not exist
• Must have at least one dgn input file listed to be able to query units
• Output file ????? already exists. Do you want to overwrite it?
• Failed to open Message file: <reason>
• Failed to open Output (macro) file: <reason>

6.7 ImPLANT-I 1 Warnings and Errors

6.7.1 Warning Messages

This section notes the warnings that could occur when running ImPLANT-I. Further
information is provided with some of the warnings.
Depending on the warning, you are advised to try to correct the inconsistencies in the DGN
model and rerun ImPLANT-I. ImPLANT-I will continue running when a warning is issued, but
the object that generated the warning will not be exported.
Most of the expected warnings will be produced on ill-defined faces:
• A face has been defined with duplicate points.
• A line in a face intersects or touches another line or point in the same face.
• A face defined as a number of points makes a single line, and therefore is not a correct
face.
The following warnings may occur in the above category:
Warning - Straight line found
Warning - External Boundary 'n' degenerate
Warning - External Boundary 'n' self intersecting
Warning - External Boundary 'n' self touching
Warning - Gap in loop of projected surface or surface of revolution
Warning - Hole Boundary 'n' is degenerate
Warning - Hole Boundary 'n' self intersecting
Warning - Hole Boundary 'n' self touching
Warning - Hole is degenerate
Warning - Start and End Coordinates do not match
Warning - Shape forced onto a plane
The following warnings may occur when certain complex elements are incomplete, or are
not defined in the conventional manner:
Warning - No rules found for capped surface or surface
Warning - No boundaries found for capped surface or surface

Warning - The capped surface or surface has not the same number of boundary
records or is ill defined
Warning - Nested Complex Shape found (but accepted)
Other warnings will be produced when some special cases have not been implemented in
this version of ImPLANT-I:
Warning - B-spline type found, not implemented
Warning - Not implemented solid/surface type 'n'
Warning - A planar solid has been found that has not been implemented
Warning - Not implemented surface type 'n'
Warning - Not implemented Volume Boundaries Type
Warning - Not implemented Surface Boundaries Type
Warning - Cell Library Type Not Implemented
Warning - Line Type Not Implemented
Warning - Text Node Type Not Implemented
Warning - Complex String Type Not Implemented
Warning - Text Type Not Implemented
Warning - Point String Type Not Implemented
Warning - B-Spline Type Not Implemented
Warning - Shared Cell Definition Type Not Implemented
Warning - Shared Cell Instance Type Not Implemented
Warning - Group Data Not Implemented
Warnings will be produced when there is something wrong with the construction of the
model:
Warning - The hole does not follow an external boundary
Warning - The construction of the element has not been implemented
Warning - Invalid type found, type = 'n'
Warning - Two shapes in projected or surface of revolution do not have the same
number of vertices
Warning - A solid was found in a hole surface
Warning - This construction cannot produce a primitive
Warning - The following hole plane is not on the same plane
Finally, warnings will be produced when ImPLANT-I is used in an invalid manner:
Warning - A file for output has not been defined
Warning - The millimetre factor has not been set

6.7.2 Error Messages

This section lists errors that could occur when running ImPLANT-I.
The program stops processing after an error is reported.

Error - Unexpected End of File was found

Error - Unexpected record for a complex shape hole
Error - Cannot open file
Error - The read from the file failed error 'n'
Error while closing … file (may be incomplete):
If the following errors occur, please contact the AVEVA Customer Support desk:
Error - Not all the allocated memory has been cleared
Error - Insufficient memory space
Error - Pointer was not found in buffer store

6.7.3 Other Messages

Under some circumstances ImPLANT-I may write other messages to the standard output,
and/or the message file. These may provide extra information to help you or AVEVA
Customer Support to identify the causes of any problems. If you receive one of these
messages and need more information about it, please contact AVEVA Customer Support,
sending a complete message file.

Index

A STEELTOLERANCE . . . . . . . . . . . 5:19
STRUC . . . . . . . . . . . . . . . . . . . . . 5:19
Attribute Translation . . . . . . . . . . . . . . . 5:21 TOLERANCE . . . . . . . . . . . . . . . . . 5:19
AVEVA Licensing System . . . . . . . . . . . . 2:2 UNITS . . . . . . . . . . . . . . . . . . . . . . 5:20
VOLM . . . . . . . . . . . . . . . . . . . . . . . 5:20
C
Command Line D
ImPLANT-I 1 . . . . . . . . . . . . . . . . . . . 3:2 DGN File
ImPLANT-I 2 . . . . . . . . . . . . . . . . . . . 3:2 translation . . . . . . . . . . . . . . . . . . . . 3:3
Command line arguments . . . . . . . . . . . 5:10
Command Syntax . . . . . . . . . . . . . . . . . 5:11
Commands
H
ADDSTEEL . . . . . . . . . . . . . . 5:8, 5:11 How to Use this Manual . . . . . . . . . . . . . 1:1
APPROX . . . . . . . . . . . . . . . . . . . . 5:12
ATTRIBUTES . . . . . . . . . . . . . . . . . 5:12
I
ATTRIBUTES EXTENSION . . . . . . 5:12
EQUIP . . . . . . . . . . . . . . . . . . . . . . 5:12 ImPLANT-I
EXCLUDE . . . . . . . . . . . . . . . . . . . 5:12 running . . . . . . . . . . . . . . . . . . . . . . . 3:1
EXCLUDE LEVEL . . . . . . . . . . . . . 5:12 ImPLANT-I 1
EXTENSIONS . . . . . . . . . . . . . . . . 5:14 Default Operation . . . . . . . . . . . . . . . 5:2
FINISH . . . . . . . . . . . . . . . . . . . . . . 5:14 Options . . . . . . . . . . . . . . . . . . . . . . 3:7
GENERATE . . . . . . . . . . . . . . . . . . 5:14 overview . . . . . . . . . . . . . . . . . . . . . . 5:1
GROUPPRIMITIVES . . . . . . . . . . . 5:14 scripting . . . . . . . . . . . . . . . . . . . . . . 5:1
HOLLOW . . . . . . . . . . . . . . . . . . . . 5:15 ImPLANT-I 2
INCLUDE . . . . . . . . . . . . . . . . . . . . 5:15 Options . . . . . . . . . . . . . . . . . . . . . . 3:5
ISFF . . . . . . . . . . . . . . . . . . . . . . . . 5:16 scripting . . . . . . . . . . . . . . . . . . . . . . 4:1
MESFIL . . . . . . . . . . . . . . . . . . . . . 5:17 ImPLANT-I.exe Profile Macro . . . . . . . . 5:7
PDMSCOMMAND . . . . . . . . . . . . . 5:18 Installation
QUERY . . . . . . . . . . . . . . . . . . . . . . 5:18 .NET Framework . . . . . . . . . . . . . . . 2:1
REMSTEEL . . . . . . . . . . . . . . 5:9, 5:18 basic . . . . . . . . . . . . . . . . . . . . . . . . 2:1
REPORTSTEEL . . . . . . . . . . . 5:9, 5:18 testing . . . . . . . . . . . . . . . . . . . . . . . 2:2
SHIFT . . . . . . . . . . . . . . . . . . . . . . . 5:18 Introduction . . . . . . . . . . . . . . . . . . . . . . 1:1
SOLID . . . . . . . . . . . . . . . . . . . . . . . 5:19 ISFF Extensions . . . . . . . . . . . . . . . . . . 5:10
STEELFILTER . . . . . . . . . . . . 5:9, 5:19

L
Limitations
General . . . . . . . . . . . . . . . . . . . . . . . 6:1
Geometry Transfer . . . . . . . . . . . . . . 6:2
ImPLANT-I 1 Technology . . . . . . . . . 6:2
PDMS/Marine Outfitting . . . . . . . . . . 6:1

R
Recognising Profiles . . . . . . . . . . . . . . . . 5:9
Running in a command Window . . . . . . . 2:2

S
Steel Structures . . . . . . . . . . . . . . . . . . . 5:7

T
Tolerances . . . . . . . . . . . . . . . . . . . . . . . 4:2
Coarse . . . . . . . . . . . . . . . . . . . . . . . 3:6

U
Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . 4:2
Output . . . . . . . . . . . . . . . . . . . . . . . . 3:6

W
Warnings and Errors
ImPLANT-1 2 . . . . . . . . . . . . . . . . . . 6:3
ImPLANT-I 1 . . . . . . . . . . . . . . . . . . . 6:5

Aveva Everything 3 D Installation Guide
80% (5)
Aveva Everything 3 D Installation Guide
68 pages
Complete Audio Mastering: Practical Techniques
From Everand
Complete Audio Mastering: Practical Techniques
Gebre E. Waddell
5/5 (5)
System Administration
100% (1)
System Administration
77 pages
Fritzing for Inventors: Take Your Electronics Project from Prototype to Product
From Everand
Fritzing for Inventors: Take Your Electronics Project from Prototype to Product
Simon Monk
No ratings yet
TM 1300 AVEVA Plant 12 1 System Administration Basic Rev 3 0 PDF
No ratings yet
TM 1300 AVEVA Plant 12 1 System Administration Basic Rev 3 0 PDF
115 pages
Aveva Licensing System
100% (1)
Aveva Licensing System
66 pages
Programming FPGAs: Getting Started with Verilog
From Everand
Programming FPGAs: Getting Started with Verilog
Simon Monk
3.5/5 (2)
ImPlant-I Installation and User Guide
No ratings yet
ImPlant-I Installation and User Guide
58 pages
ImPlant-I Installation and User Guide
No ratings yet
ImPlant-I Installation and User Guide
44 pages
Review 12.2 Install Guide
No ratings yet
Review 12.2 Install Guide
24 pages
Engineering Installation Guide
No ratings yet
Engineering Installation Guide
62 pages
Ig52770 - AVEVA Diagrams 14.1.SP3 Install Guide
No ratings yet
Ig52770 - AVEVA Diagrams 14.1.SP3 Install Guide
60 pages
Marine Software Installation Guide
No ratings yet
Marine Software Installation Guide
68 pages
Programming Arduino Next Steps: Going Further with Sketches
From Everand
Programming Arduino Next Steps: Going Further with Sketches
Simon Monk
3/5 (3)
Aveva Everything 3 D Installation Guide
No ratings yet
Aveva Everything 3 D Installation Guide
60 pages
ImPLANT-STL Installation and User Guide
No ratings yet
ImPLANT-STL Installation and User Guide
38 pages
PDMS and Associated Products Installation Guide
No ratings yet
PDMS and Associated Products Installation Guide
84 pages
4.0 Getting Started Guide: Inplant
No ratings yet
4.0 Getting Started Guide: Inplant
74 pages
Explant-I User Guide
No ratings yet
Explant-I User Guide
28 pages
PDMS - Installation Guide
No ratings yet
PDMS - Installation Guide
84 pages
PDMS and Associated Products Installation Guide
No ratings yet
PDMS and Associated Products Installation Guide
86 pages
Teardowns: Learn How Electronics Work by Taking Them Apart
From Everand
Teardowns: Learn How Electronics Work by Taking Them Apart
Bryan Bergeron
No ratings yet
Global Server Installation Guide
No ratings yet
Global Server Installation Guide
24 pages
Aveva Unified
No ratings yet
Aveva Unified
97 pages
Installation User Guide
No ratings yet
Installation User Guide
22 pages
Companies and Environmental Impact: Identification and Visualization of Key Ecological Indicators
From Everand
Companies and Environmental Impact: Identification and Visualization of Key Ecological Indicators
Martin Knura
No ratings yet
CNC Machining Handbook: Building, Programming, and Implementation
From Everand
CNC Machining Handbook: Building, Programming, and Implementation
Alan Overby
No ratings yet
Programming the Photon: Getting Started with the Internet of Things
From Everand
Programming the Photon: Getting Started with the Internet of Things
Christopher Rush
5/5 (1)
Programming the Intel Galileo: Getting Started with the Arduino -Compatible Development Board
From Everand
Programming the Intel Galileo: Getting Started with the Arduino -Compatible Development Board
Christopher Rush
5/5 (1)
Electronics from the Ground Up: Learn by Hacking, Designing, and Inventing
From Everand
Electronics from the Ground Up: Learn by Hacking, Designing, and Inventing
Ronald Quan
3.5/5 (2)
Programming Arduino Next Steps: Going Further with Sketches, Second Edition
From Everand
Programming Arduino Next Steps: Going Further with Sketches, Second Edition
Simon Monk
3/5 (3)
Shared Services Installation Guide
No ratings yet
Shared Services Installation Guide
46 pages
Aveva Licensing System Installation Guide
No ratings yet
Aveva Licensing System Installation Guide
62 pages
Prediction of Burnout: An Artificial Neural Network Approach
From Everand
Prediction of Burnout: An Artificial Neural Network Approach
Felix Ladstätter
No ratings yet
AVEVA Integration Service InstallationGuide
No ratings yet
AVEVA Integration Service InstallationGuide
41 pages
PDMS-Equipment UG PDF
No ratings yet
PDMS-Equipment UG PDF
144 pages
Equipment User Guide
No ratings yet
Equipment User Guide
152 pages
Programming Arduino: Getting Started with Sketches
From Everand
Programming Arduino: Getting Started with Sketches
Simon Monk
3.5/5 (5)
The IT Factory
From Everand
The IT Factory
H.J.C. van Aken
No ratings yet
Operation and Installation Manual: MEDRAD® Stellant Imaging System Interface (ISI)
No ratings yet
Operation and Installation Manual: MEDRAD® Stellant Imaging System Interface (ISI)
30 pages
Aveva Licensing System
No ratings yet
Aveva Licensing System
66 pages
Aveva Instrumentation Installation User Guide
100% (2)
Aveva Instrumentation Installation User Guide
58 pages
Mar API
No ratings yet
Mar API
10 pages
ChatGPT for Business: Strategies for Success
From Everand
ChatGPT for Business: Strategies for Success
Matthew C. Smith
No ratings yet
Catalogues and Specifications Reference Manual
100% (1)
Catalogues and Specifications Reference Manual
205 pages
Software Patterns Made Easy
From Everand
Software Patterns Made Easy
Justice Nanhou
No ratings yet
Electrical Installation User Guide
100% (1)
Electrical Installation User Guide
53 pages
Pollution Prevention: Methodology, Technologies and Practices
From Everand
Pollution Prevention: Methodology, Technologies and Practices
Kenneth L. Mulholland
No ratings yet
AVEVAPIDInstall 121
No ratings yet
AVEVAPIDInstall 121
98 pages
Installation Manual: Iris™ and Rda Software
No ratings yet
Installation Manual: Iris™ and Rda Software
218 pages
Programming the BBC micro:bit: Getting Started with MicroPython
From Everand
Programming the BBC micro:bit: Getting Started with MicroPython
Simon Monk
No ratings yet
Gray Hat Hacking the Ethical Hacker's
From Everand
Gray Hat Hacking the Ethical Hacker's
Çağatay Şanlı
5/5 (1)
Six Sigma for IT Management
From Everand
Six Sigma for IT Management
Melvin Harteveld
No ratings yet
The Linux Terminal for Advanced Users - The Command Line Made Easy: First Edition
From Everand
The Linux Terminal for Advanced Users - The Command Line Made Easy: First Edition
Michael Basler
No ratings yet
United under SAP: The process of eliminating information islands for ThyssenKrupp in China (Zhongshan)
From Everand
United under SAP: The process of eliminating information islands for ThyssenKrupp in China (Zhongshan)
Marcel Gundlach
No ratings yet
Troubleshooting and Repairing Commercial Electrical Equipment
From Everand
Troubleshooting and Repairing Commercial Electrical Equipment
David Herres
No ratings yet
Explant-A User Guide
No ratings yet
Explant-A User Guide
14 pages
Global Manager Services Installation Guide
No ratings yet
Global Manager Services Installation Guide
48 pages
TM-3561 AVEVA Plant (12.1) Schematic 3D Integrator
No ratings yet
TM-3561 AVEVA Plant (12.1) Schematic 3D Integrator
80 pages
Introduction of an Employee-Led Training System at Stage Entertainment Germany: A Qualitative Study
From Everand
Introduction of an Employee-Led Training System at Stage Entertainment Germany: A Qualitative Study
Kim Maya Sutton
No ratings yet
Wire Loop Embeds-1
No ratings yet
Wire Loop Embeds-1
8 pages
Iindex
No ratings yet
Iindex
1 page
BaseBolt and ColumnShoe Embeds
No ratings yet
BaseBolt and ColumnShoe Embeds
8 pages
HiddenCorbel Embeds
No ratings yet
HiddenCorbel Embeds
8 pages
CADfix 12 Installation Guide
No ratings yet
CADfix 12 Installation Guide
39 pages
SWE EPDM Workflow EN
No ratings yet
SWE EPDM Workflow EN
19 pages
FasteningPlate Embeds
No ratings yet
FasteningPlate Embeds
8 pages
Troubleshooting (Common Issues)
No ratings yet
Troubleshooting (Common Issues)
2 pages
Tutorial
100% (1)
Tutorial
48 pages
Review 6.3.SP1 Fix 1 Install Guide
No ratings yet
Review 6.3.SP1 Fix 1 Install Guide
11 pages
AVEVA PDMS E3D ReleaseNotes 2022-08-29
No ratings yet
AVEVA PDMS E3D ReleaseNotes 2022-08-29
37 pages
Install Guide Tekla Structures and Aveva PDMS - 2020-12-18
No ratings yet
Install Guide Tekla Structures and Aveva PDMS - 2020-12-18
6 pages
New Bolting For Pdms
No ratings yet
New Bolting For Pdms
23 pages
TM-1816-Cable Tray Modelling (2,5,7,8)
No ratings yet
TM-1816-Cable Tray Modelling (2,5,7,8)
32 pages
TM-1815 - Cableway & Cable Modelling (1,3,6)
100% (1)
TM-1815 - Cableway & Cable Modelling (1,3,6)
42 pages
How To Get Pipe Development
No ratings yet
How To Get Pipe Development
4 pages
ABC of TeklaPad (Interacting With Tekla Database)
No ratings yet
ABC of TeklaPad (Interacting With Tekla Database)
25 pages
Instructions For Incorporating Updated Database Into WinTR-55
No ratings yet
Instructions For Incorporating Updated Database Into WinTR-55
4 pages
SADP Module 5
No ratings yet
SADP Module 5
34 pages
9th Class
No ratings yet
9th Class
65 pages
Boot Magazine - Issue 023 - AMD K6 3D - Jul Aug 1998
No ratings yet
Boot Magazine - Issue 023 - AMD K6 3D - Jul Aug 1998
100 pages
Data Analysis Made Easy With UNkNOT
No ratings yet
Data Analysis Made Easy With UNkNOT
6 pages
AIT-700 Users Manual ED12 20181101
No ratings yet
AIT-700 Users Manual ED12 20181101
88 pages
Windows Forms Controls
No ratings yet
Windows Forms Controls
50 pages
User Manual PEAK777VL2 100907
No ratings yet
User Manual PEAK777VL2 100907
61 pages
Clothes management system project report
No ratings yet
Clothes management system project report
29 pages
Com 323 Programming in Java Week 01
No ratings yet
Com 323 Programming in Java Week 01
45 pages
Internship Report-1
No ratings yet
Internship Report-1
41 pages
List of Datasets For Machine-Learning Research
No ratings yet
List of Datasets For Machine-Learning Research
61 pages
3D Modelling Using Ai
No ratings yet
3D Modelling Using Ai
4 pages
Usability Evaluation of Unidays': On Android, Ios, Windows
No ratings yet
Usability Evaluation of Unidays': On Android, Ios, Windows
19 pages
University of Nottingham Thesis Title Page
100% (3)
University of Nottingham Thesis Title Page
5 pages
Myst Online Uru Live Manual
No ratings yet
Myst Online Uru Live Manual
16 pages
AICT Lecture 2
No ratings yet
AICT Lecture 2
16 pages
Mindray BS 200
No ratings yet
Mindray BS 200
9 pages
Summative Term 1 (2019 - 20)
No ratings yet
Summative Term 1 (2019 - 20)
12 pages
Lesson Plans g9 Computer Studies by D Phiri 0963829015
100% (1)
Lesson Plans g9 Computer Studies by D Phiri 0963829015
63 pages
Configuration Guidefor Sun Solaris Host Attachment
No ratings yet
Configuration Guidefor Sun Solaris Host Attachment
82 pages
DS2 DSX - AN - 210x210mm - NEW
No ratings yet
DS2 DSX - AN - 210x210mm - NEW
4 pages
10.30 EE Introducing A BIM Based Permits Process in Estonia Jaan Rick
No ratings yet
10.30 EE Introducing A BIM Based Permits Process in Estonia Jaan Rick
61 pages
Lecture 01 Number Conversion
No ratings yet
Lecture 01 Number Conversion
70 pages
All About Transport Request
100% (1)
All About Transport Request
6 pages
Os Lec 5 Thread
No ratings yet
Os Lec 5 Thread
10 pages
The Psychology of Evolving Technology: How Social Media, Influencer Culture and New Technologies Are Altering Society 1st Edition Rhoda Okunev
No ratings yet
The Psychology of Evolving Technology: How Social Media, Influencer Culture and New Technologies Are Altering Society 1st Edition Rhoda Okunev
49 pages
Pixel Racers (Driving Game) On Scratch
No ratings yet
Pixel Racers (Driving Game) On Scratch
1 page
Mic MP
No ratings yet
Mic MP
16 pages
Pvsyst Tutorial v8 Import Topography en
No ratings yet
Pvsyst Tutorial v8 Import Topography en
15 pages