Académique Documents
Professionnel Documents
Culture Documents
The content of this document is proprietary work of Intergraph Corporation, or relevant third parties,
and is protected by copyright law and international treaty. Any use, duplication, distribution or
disclosure of such, other than as specified herein, is unauthorized and in violation of applicable
copyright law and international treaty. All rights in content or materials bearing copyright notice or oth er
attribution of third party rights are reserved to the relevant third party. United States Government
license rights are limited to those mandatory rights identified in DFARS 252.227 -7015(b).
Intergraph may make improvements and/or changes in the product s and/or the programs described in
this publication at any time without notice.
Any content or materials supplied hereunder are provided "as is ," without warranty of any kind, either
expressed or implied, including, but not limited to, any implied warranties of merchantability, fitness for
a particular purpose, or against infringement. In no event shall Intergraph be liable for any damages
arising out of, or in connection with the downloading, viewing, use, duplication, distribution or
disclosure of any content or material published by Intergraph, including but not limited to any direct,
indirect, incidental, special, punitive or consequential damages, or loss or corruption of data.
Some jurisdictions do not allow the exclusions or limitations set f orth above, so the above may not
apply to you. The exclusions or limitations shall apply in all jurisdictions to the maximum extent allowed
by law.
Intergraph Corporation
170 Graphics Drive
Madison, AL 35758
Phone: +1.256.730.2000
Toll Free USA: +1.800.345.4856
Fax: +256.730.2048
Contents
Contents
Introduction ................................................................................................................... 2
December 3, 2015
Introduction
Introduction
Sometimes piping isometric drawing extraction fails in Smart3D. This document should help you find
where the problem lies.
The PCF (Piping Component File) is a text-based file that is passed to Isogen. The PCF provides a
useful checkpoint between the model extraction and Isogen drawing generation.
If the PCF is faulty then it is either a model extraction issue, or a problem in the PCF generation code.
If the PCF is good then and the drawing fails it is a problem in Isogen which may be possible to work
around by altering the style settings.
If the drawing is produced ok, but there is still an error something is wrong in either the post-
processing or storing the data back into the Smart3D database.
Getting Started
Use the flow chart below to decide how far the Drawing Update got before it failed.
December 3, 2015 2
ISO document size becomes 0KB because of error.
Does the message file exist? How to find it? Look in the View Extraction Data dialog. Select LOG
under REPORTS\Process File, and the message file is displayed in the right-hand pane. This means
Isogen started.
If not something has gone wrong while preparing the PCF for the Isogen run. See Investigating Model
errors.
Review the message file. Did Isogen run through to produce drawings? See structure of Message File
Appendix if you are not sure. If there is a failure in the Drawing generation, the next step is to look into
Isogen errors.
If Isogen ran open the drawings. If they look bad study the message file for clues. Is there an error or
a significant warning? See where has the drawing has gone wrong, and check if there is anything
unusual in the log file.
If the drawings are ok but there is a failure reported, something has gone wrong after this. This could
be the PipelineList Report, the Neutral File, or storing the results back into the database. See the
Drawings.log for clues.
You can see the Drawings log by Right clicking the drawing and selecting View Log.
Typically this shows you the last error at the bottom of the log file. This is not normally the most
important error. You should scan up the file to find the first error, as this gives a better clue as to what
has gone wrong. Ignore any information items in the first analysis.
This could be resolved by updating the drawing again or deleting the drawings and run the query.
Checking Setup
Some standard checks should be made when setting Isometrics, mostly to do with the location of
files.
1. All DLLs (Custom Symbols and VB labels) in symbol share and/or local paths are of latest
versions and located, registered/updated into configuration file.
2. All DetailSketch files are located in UNC path (Symbol Share) instead of local path..
3. All enabled report options are set to respective Iso options and their templates are located in
UNC path (Symbol Share).
4. All enabled Auxiliary Programs, ASC files, DataFiles, ReportFiles, SummaryFile, etc are
located in UNC path (Symbol Share).
5. All enabled label options are mapped to correct labels and correct data is written to PCF.
6. If you use custom Symbol KEY ASCII files the path should be correct, and these should be
supplied when filing a Service Request.
December 3, 2015 3
Investigating Model errors
In some specific scenarios, even though there are no disconnections the isometrics used to
fail. Upon investigating it was found that there are two components modeled at the same
location.
In some situations, the catalog is updated and some of the components are deleted. If the
model is not updated it fails to update the drawing.
3. Missing labels
Isometric fails to update if the configured labels pointed in the Isometric options are not
available or deleted from the symbol share. Also in some situations even if the labels are
present it may be customized in VB, if the corresponding dll files are not registered or
mapped using the custom symbols then also the isometric fails to update.
In some specific configurations the default ownership has to be altered from component to
pipe, then only the isometric is getting extracted. For example in the image below, the
ownership of the weld was originally set to component. After altering the ownership to Pipe
and changing it to field weld extracted the isometric.
December 3, 2015 4
Investigating Model errors
In placing control points to break isometrics in specific locations on the line, if the control
points of the sub type piping mfg limit point are not placed at the appropriate location(s)
than it would cause the ISO failure.
Incorrect symbol definition may result in bad geometry data in PCF which would cause
double back error when creating ISOs. In the following example the center location lies
outside of start and end. In this case the following parameters of the symbol should be
checked.
1. Face1 to center
2. Face2 to center
3. Face3 to center
Sometimes users accidently place Tap points at the same location which causes ISO
failure. It is difficult to make out in the model but it will be clearly seen the PCF as seen
below:
December 3, 2015 5
Investigating Isogen Errors
This is Personal Isogens log file. There are 2 main sections. First Idfgen which translates the PCF to
an IDF. This uses the coordinates of the all the components in the PCF to determine the correct order
for Isogen, and also makes sure that the PCF as a whole connects together. Second there is the
Isogen section where the drawing is laid out.
In both sections there can be warning or errors. Most warnings are benign and can be ignored. Errors
are more serious and cause the drawing to fail. Errors less than 2000 are Isogen errors; those greater
than 2000 are Idfgen errors.
Both errors and warnings try to identify the component that has cause the issue. They do this by using
showing both the 3D coordinate and the UCI (unique component identifier) of the problem
component. This can be used to identify the component in the model. Any error which identifies a 3D
coordinate should be investigated.
The line is disconnected due to a missing connection. It is hard to find as there is no proper open end
i.e., visible.
The two possible ways to find the disconnections are explained below.
December 3, 2015 6
Investigating Isogen Errors
The message file also shows which groups IDFGEN has sorted the components into by printing a
number such P1, P2, P3 etc. at the right side of a listing of the components. This can help find the
disconnection.
A list of other common errors in the message file are shown below:
1999 Drawing layout failed. Isogen has failed to converge. This often happens if the
drawing is too complicated. You can try simplifying the
drawing by placing Split points, or changing the drawing
boundaries. Sometime suppressing some unwatend
messages from the drawing can help.
1041 User defined Fitting Check if you are using a redefined symbols (.ASC) file.
Spindle Key ???? not There could be a problem with this file. This is listed under
found Supplementary.DataFiles
3102 Tee end without tee The main cause is Isogen trying to split the drawing in a
start bad location. Try making the backing sheet bigger and
forcing the drawing on 1 sheet to see if this resolves the
problem.
A fuller list of Personal Isogen errors is shown in the Personal Isogen Errors Appendix.
December 3, 2015 7
Investigating Isogen Errors
Options Override
Sometimes you want to test changing the extraction options for just one line. You can do this using
the Option Override mechanism, which you can access on Right Click.
You need to know the name of option that you want change.
When you override on option the overridden option is stored against a pipeline and used when that
line is extracted again.
Override options are a powerful way of working around problems on a line by line basis.
Taking it further
If you still cannot determine the issue, then file a Service Request. You should always supply
IsoDebugFiles, as these will often by requested to investigate an issue.
December 3, 2015 8
Appendix: IsoDebugFiles
Appendix: IsoDebugFiles
You can turn on IsoDebugFiles which instructs Smart3D to leave the files used while running Isogen.
Normally they are tidied up. You turn on IsoDebugFiles by setting the registry key
\HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Intergraph\Applications\Environment\Drawin
gs\IsoDebugFiles\Save to Yes.
This preserves temporary area on disk. You can find it in your temp folder under the IsoDebugFiles
folder. Everything under here is useful for a Support Engineer. You a folder for each pipeline. Under
here is a folder with the date/time stamp for each time that the isometric was extracted.
The full structure is shown above. The drawings log is in the folder with the data/time. Everything else
under here maps into the Personal Isogen project structure. The project is the plant. The style name
in this case is Iso_Pipeline.
The Inputs folder contains the PCF, an also the temporary IDF.
The Drawings folder contains the output drawing, and also the POD file.
The Messages folder holds the Isogen log file, or message file.
The Reports folder holds any Isogen Reports generated as part of the run, which could include the
neutral file, or the repeatability file which is used for Change Management.
The Isogen Logs folder holds a series of temporary Isogen internal log files, which are normally
written to the temp folder and deleted.
December 3, 2015 9
Appendix: Isogen Message File
1. Idfgen translates the PCF in an ordered set of components in a temporary idf, called
idftrans.idf.
2. Isogen itself runs on this idf.
You can see this progress in the Message file. Isogen is split into ISODAT and ISOPLOT. ISODAT
handles all the data issues, such dealing with option switches, deciding what text will plotted, and
generating report files. ISOPLOT actually lays out the Drawing.
A sample Message file is shown above. First the Personal Isogen version is stated. Then IDFGEN
runs, stating the build number.
The statement ALL COMPONENT CONNECTED indicates successful processing. Multiple passes
made attempting to connect the components typically means a disconnection.
Finally there is a message indicating the output produced with the text THE FOLLOWING
DRAWINGS ARE IN PLOTFILE . followed by a list of all the sheets.
Errors and warnings can occur in IDFGEN, ISODAT or ISOPLOT, and these will appear in the
appropriate section of the message file.
IDFGEN errors are typically some problem with connecting the components together.
ISOPLOT errors tend to be where Isogen struggles to lay out the drawing for some reason.
Sometimes placing drawing split points can help.
If any of the errors in the Message file include either 3D coordinate or a Unique Component Identifier
(UCI) then you should study the relevant area in detail.
December 3, 2015 10
Appendix: Personal ISOGEN return values
-1001 Failed to create the specified CreateProcess (Windows function) for the external processor has failed
Pre/Post Processor for some reason.
-1002 Pre/Post Processor has Exception raised trying to run external process. Check the programs
crashed defined as pre/post processors in Isogen.fls.
-1003 Pre/Post processor has External program exceeded the timeout and was terminated. Has it
timed out and the external hung, or is it just taking too long?
process has been killed
-1004 Pre/Post processor has Check the programs defined as pre/post processors in Isogen.fls. The
timed out but the external process is probably still running. Requires investigation of external
process cannot be process to determine why.
terminated (and is therefore
still running)
-2 Isogen dll failed to load Possible installation problem, missing dependent file etc. OR crash
occurred during execution, which has been trapped by the error handler.
-3 Isogen thread failed to finish Possible execution loop which has been terminated by Personal Isogen,
e.g. for exceeding a time limit.
1 Personal ISOGEN cannot Check path exists and is writable. The isometric directory is listed in
find the isometric directory pisogen.log (on users temp area) as Pisogen Root.
specified.
2 Invalid Style for this project. The specified Style cannot be found under the specified project. Check
path of style. Under the Project folder there should be style folder,
containing the isogen.fls
3 Specified Project not found. The specified project cannot be found under the isometric directory.
Check the path of the project folder. The project name is in Pisogen.log
4 IDFGEN handshake failed. The handshake passed to the idfdll.dll has not been verified.
5 Could not access specified PCF is usually copied to users temp area, but this has failed for some
PCF in TEMFILES. reason. Check PCF exists and can be copied to temp.
December 3, 2015 11
Appendix: Personal ISOGEN return values
8 The handshake passed to A number of other unexpected failures have been found to generate
the pisodll.dll has not been this error. It could be a timing issue.
verified.
9 Personal ISOGEN failed to View message file for details as there are many possible causes
produce a valid drawing.
11 IDFGEN DLL failed to Check access to the style and users temp folder.
establish current directory
12 IDFGEN DLL failed to Check access to the style and users temp folder.
change directory
13 IDFGEN did not complete View message file for details. One common cause is that the
successfully. components in the PCF do not form a connected system
14 IDFGEN DLL failed to Check access to the style and users temp folder.
restore working directory
15 IDFGEN could not delete Check for this FOR036.DAT in the users temp area
PISOGEN\PROGRAMS\FO
R036.DAT from a previous
run.
16 IDFGEN was unable to IDX file is obsolete under Personal Isogen (only relevant to stand-alone
create ISOGEN.IDX file. running of IDFGEN)
Error opening isogen.idx
17 IDFGEN was unable to copy Numerous causes (e.g. Error allocating memory to store a line, Zero line
ISOGEN.FLS to the length encountered, Error opening source isogen.fls (in specified
PROGRAMS directory project\isotype), Error opening target isogen.fls (in pisogen\programs),
Error closing source isogen.fls (in specified project\isotype), Error
closing target isogen.fls (in pisogen\programs))
18 Obsolete.
19 Personal ISOGEN The handshake passed to the pisogen.dll has not been verified. A
handshake failed. number of other unexpected failures have been found to generate this
error. It could be a timing issue.
December 3, 2015 12
Appendix: Personal ISOGEN return values
20 Unknown Error in Personal An unexpected path through the program has occurred a
ISOGEN. default/catch-all value which could be due to almost anything, and which
is useful only in as much as it prevents a crash.
22 PISOGEN DLL could not Likely to be a problem accessing users temp folder
Change Directory to
\PISOGEN\PROGRAMS.
Or the message file entry may be absent from the isogen.fls file;
24 PISOGEN DLL has been Resetting working directory failed (function _chdir)
unable to restore current
working directory.
25 Error around accessing i- Multiple causes (Error opening i-gen.fls for reading, Error opening
gen.fls or isogen.fls. isogen.fls for writing, Error opening options file specified in i-gen.fls,
Error closing options file specified in i-gen.fls, Error opening i-gen.opl for
writing, Error closing i-gen.opl, Error closing i-gen.fls, Error closing
isogen.fls
26 Problem with the specified Check existence and access of Isometric Directory, which is the Root
isometric root directory listed in pisogen.log.
27 Problem setting the current Check existence and access of Isometric Directory, which is the Root
isometric root directory listed in pisogen.log.
28 Invalid file extension Check the input file is a PCF, PDF or DAT file.
31 Error occurred creating a Error occurred during pass 1 when the input IDF file is preprocessed
POD (intermediate) file.
32 Error occurred creating a Error occurred during pass 2 when the POD file is being created from
POD (intermediate) file. Isogen data
December 3, 2015 13
Appendix: Personal ISOGEN return values
33 Failed to load Used in the creation of graphics output files such as DWG,IGR and
PODGRAPHICS DLL SHA.
34 PODGRAPHICS process A graphics specific process has failed e.g. user requested IGR/SHA
failed output but SmartSketch/Shape2D is not installed
41 Cannot get path to system Check users temporary path. Windows function GetTempPath failed.
temp directory
43 Unable to set bore units to Often a combination of metric bores and imperial dimensions causes
those specified in the input this. Check option switch 41.
file
44 Unable to perform macro Check the Isogen.fls and see what macros are defined. Macros are
substitution in style contained in $...$. Check user can write to Isogen.fls.
ISOGEN.FLS
45 Unable to restore original Related to macro substitution. Check the user can edit the isogen.fls in
style ISOGEN.FLS the style folder.
50 Project disk is full unable Check you have plenty of available space on the machine that you are
to create new output files using to create
51 File containing temp Check space on the Drive containing the users temp folder.
directory is full unable to
process files
52 Unable to extract the Bore Problem reading either the Option block of IDF, or header block of PCF
Units from the incoming
PCF, IDF or DAT file
53 Unable to Copy a File (either See pisogen.log (in users temp folder) for details of exact File Name
PCF, IDF, DAT or FLS) and Path concerned
1000 Expected files missing in Is the Isogen.fls present in the style folder. Are the input files present (in
Style particular the Options file)?
1001 Requested units Probably means a combination of metric bore and imperial co-ordinates
combination is inconsistent
1003 Problem deleting an Check whether the user can edit the message file list in Isogen.fls. Also
ISOGEN message file check STDOUT.TXT in temp area. A process locking this file could
cause this error.
1004 Line in the options file has Check the .opl file in the style, listed in Isogen.fls
invalid format
1005 Too many switches in the Check the .opl file in the style, listed in Isogen.fls
options file
1006 Too few switches in the Check the .opl file in the style, listed in Isogen.fls
options files
December 3, 2015 14
Appendix: Personal ISOGEN return values
1007 MicroStation design file Set MS_EXE environment variable if generating DGN. You need the
output requested but Microstation executable to drive creating DGN output.
MS_EXE environment
variable is not defined
1008 MicroStation design file Currently you need Microstation to generate the DGN graphics.
output requested but
MicroStation not installed
1009 MS_EXE environment Check Path of MS_EXE environment variable if generating DGN
variable does not end with a
\
1011 Options file missing Look in Isogen.fls (location specified in Pisogen.log). Check that the
specified in ISOGEN.FLS is .OPL file referenced is present.
missing
Warning messages
1999 Isogen has returned a FAIL This means Isogen has been unable to layout the drawing successfully.
for one or more drawings in Review failed drawing and message file for clues. Either this is bad
the set. data, bad options or too much data. Splitting the drawing can help
identify the problem, as you can see where the error is occurring if you
move the split points.
2022 IDFGEN has detected A Multi-Pass or Hard Disconnect has occurred when a gap of greater
disconnected pipeline - A than 8mm has been encountered i.e. more than one pipeline is output in
Multi-Pass or Hard the single idf. Drawings will be created for each separate pipeline.
Disconnect Viewing the listing in the message file can help determine where the
break is by seeing which pipeline set, P1, P2, etc. each component is
assigned to.
2023 IDFGEN has detected A Floating Pass has occurred in which only out-of-line items (such as
disconnected pipeline A Bolts, Supports and other positional items) are left over from the
Floating Pass previous pass the rest of the pipeline is still output to the idf.
This does not fail the drawing, but the left over items are lost.
2024 IDFGEN has detected A Soft Disconnect has occurred in which gaps greater than the
disconnected pipeline A specified tolerance (but less than 8mm) have been encountered a
Soft Disconnect single pipeline is output to the idf, but containing positioned warning
messages which can be output or suppressed on the drawing
depending on switch setting. This does not fail the drawing.
December 3, 2015 15