# IsoOverView
## For users
- Set the **Debug On** switch in the **Schedule Batch Job** screen during isometric sheet creation, then start Iso as usual.
- Start IOV, `iov.exe`.
- Select the project-specific `.ini` file.
- Select one or more `h` files, that is, isometric sheets.
- Select the plotter or printer.
- Click **Start**.
- Wait until MicroStation closes and the IOV message **ISO OverView completed** is displayed.
## For the administrator
### Automatic hits file generation
IOV requires the hits file for each pipeline. Users can either set the **Debug On** switch during generation of the isometric sheets, or set word `16` to `0` in `INTERGRAPH_OPTIONS_BLOCK`.
### Program execution
Below is a brief summary of how the program runs, in order to make the process easier to understand.
- The `iov.ini` file in the program folder is read.
- The `.ini` file selected by the user is read.
- The seed file is copied to an IOV file.
- All elements in the IOV file are set to the `pipelv` level.
- The pipeline is drawn.
- The isometric sheet is opened.
- All elements on `pipelv` are deleted.
- The `mstnseedview` view from the IOV file is referenced by using the scale `refscale` and insertion point `refpoint`.
- The reference file is copied into the isometric sheet.
- The IOV file is detached.
- The line terminal numbers are written to the IOV file.
- The grid file is read and the distance is calculated.
- The **Connect to** information is read from the IDF file.
- The `IsoCoverSheet` is created, `ICSseed` is copied.
- The IOV file is copied in by reference.
- The table is created.
- The I3D file is created.
- The line terminal numbers are written to the I3D file.
- The I3D file is copied in by reference.
- MicroStation is closed.
### Creation of the Seed files
Seed files are MicroStation **2D files**.
### IsoOverView seed file
This contains the key plan drawing with the original coordinates and the **Saved View** whose name is taken from the `mstnseedview` variable.
The recommended procedure for creating the seed file is as follows:
- Open the PDS model, `Piping` or `EQP`, with the referenced grid.
- Reference the model with the most important components.
- Select **File → Export 2D...**
- Select **View: Top View**.
- 
- Edit the seed file, for example by deleting any unnecessary lines.
- Create a **Saved View** with the name from the `mstnseedview` variable.
### IsoCoverSheet (ICS) seed file
This file is usually a copy of the IsoGen border file. The additional dimension-table entries should also be created here.
### LOG file
The temporary folder, often `c:\temp`, contains a log file, `iov.log`. This file makes it easier to identify errors.
## INI file
\[IsoOverView\]
seedfile=o:\\sk\\proj\\lingen\\defset\\iovseed.dgn
pipeco=3
pipelv=40
pipewt=4
pipelc=0
' Name of the Saved View in the IOV seed file
mstnseedview=iov
' Insertion scale of the view in the Iso sheet, `???.i01`
refscale=7:1
' Insertion point of the view in the Iso sheet, `???.i01`
refpoint=100,35
isopath=O:\\sk\\proj\\lingen\\iso\\
' Factor for unit conversion, default `1000`
Unitfactor=1000
' Elements that are not to be displayed, for example support segments. Use the name from the hits file, first column. Multiple names can be specified if separated by spaces.
NotUsedComponent=SUPP
\[IsoCoverSheet\]
' Colour, level, weight, text height, and similar settings for the line terminal number in the CoverSheet top view. For the ISO view, see `[I3D]`.
LENtextco=2
LENtextlv=1
LENtextwt=1
LENtextlc=0
LENtexttx=0.2
LENtexttw=0.2
LENtextJustification=CC
' Colour, level, weight, text height, and similar settings for the table in the CoverSheet.
TABtextco=1
TABtextlv=1
TABtextwt=1
TABtextlc=0
TABtexttx=3.5
TABtexttw=2.5
TABtextft=29
TABtextJustification=LC
\'Table settings (measured with reference to grid)
\'Y coordinate of first line
TABlineheight=10
' Line spacing
TABlinespacing=6
' X coordinate of the serial number
TABnumberpoint=15
' X coordinate of the label, `Connection to`
TABlabelpoint=35
' X coordinate of delta X
TABXpoint=250
' X coordinate of delta Y
TABYpoint=320
' X coordinate of delta Z
TABZpoint=400
' Number of decimal places for the distance to grid lines
TABround=0
' The distance to the grid lines is multiplied by this factor
TABfactor=1000
' Coordinates read from the `h` file and the `idf` file are different. This value is required in order to locate the `Connected to` text.
TABaccuracy=0.05
' MicroStation macro used to fill the text field in the ICS file. The isometric sheet, `???.i01`, is referenced automatically, and this macro can then be used to copy out the text field.
ICSmacro=o:\\sk\\proj\\lingen\\defset\\icsmacro.bas
' ICS seed file
ICSseedfile=o:\\sk\\proj\\lingen\\defset\\icsseed.dgn
' PDS file for grid measurement. Created by using PDS.
Gridfile=o:\\sk\\proj\\lingen\\defset\\FW_lingen.dat
' Insertion scale for IOV in the ICS file
ICSrefscale=25:1
' Insertion point for IOV in the ICS file
ICSrefpoint=220,230
\[Programm\]
' These variables are used by the program itself.
Lizenz=338070
inifile=o:\\sk\\proj\\lingen\\defset\\iov.ini
createIOV=1
createICS=1
createI3D=1
\[IPlot\]
' IPlot Iparm file
IParmfile=o:\\sk\\proj\\lingen\\defset\\plotseed.i
' Printer in the format `\\server\printer`
IPlotque1=\\\\XNS178\\ls802_A3
IPlotque2=\\\\XNS178\\ls802_A4
IPlotque3=\\\\S_MT200\\5000A4Q
\[I3D\]
' 3D MicroStation file used as the seed file for the isometric view
I3Dseedfile=o:\\sk\\proj\\lingen\\defset\\I3Dseed.dgn
' Insertion scale for IOV in the ICS file
I3Drefscale=2.2:1
' Insertion point for IOV in the ICS file
I3Drefpoint=450,320
' Colour, level, weight, text height, and similar settings for the line terminal numbers in the isometric view
I3DLENtextco=2
I3DLENtextlv=1
I3DLENtextwt=1
I3DLENtextlc=0
I3DLENtexttx=2
I3DLENtexttw=2
I3DLENtextJustification=CC
## Variables in the IsoOverView section
### Seedfile
Specifies the seed file for IOV, for example an EQP top view exported to a 2D file.
### Pipeco
Colour number of the drawn pipeline.
### Pipelv
Level of the drawn pipeline.
> All MicroStation elements on this level in the isometric sheet are deleted.
### Pipewt
Line weight of the drawn pipeline.
### Pipelc
Line type of the drawn pipeline.
### DelLevel
**Deletes** all elements on this level. This is useful if the level has
been changed during testing.
Specify as usual in MicroStation (e.g. 10,12,50-60)
### Mstnseedview
Name of the **Saved View** in the IOV seed file.
### Refscale
Scale used for referencing the IOV file in the ISO sheet.
### Refpoint
Insertion point for the IOV file in the ISO sheet.
### isopath
The software enters the value of this variable automatically.
### Unitfactor
Factor used for unit conversion. The default is `1000`.
### NotUsedComponent
Elements that are not to be displayed, for example support segments. Use the name from the hits file, first column. You can specify multiple names as long as they are separated by spaces.
## Variables in the IsoCoverSheet section
### LENtext??
Colour, level, weight, text height, and similar settings for the line terminal number in the CoverSheet top view. For the ISO view, see `[I3D]`.
### TABtext??
Colour, level, weight, text height, and similar settings for the table in the CoverSheet.
### TABlineheight
Table settings measured with reference to the grid. Y coordinate of the first line, that is, the line height.
### TABlinespacing
Table settings measured with reference to the grid. Line spacing.
### TABnumberpoint
Table settings measured with reference to the grid. X coordinate of the serial number.
### TABlabelpoint
Table settings measured with reference to the grid. X coordinate of the label, `Connected to`.
### TAB?point
Table settings measured with reference to the grid. X coordinate of delta X, delta Y, or delta Z.
### TABround
Number of decimal places for the distance to the grid lines.
### TABfactor
The distance to the grid lines is multiplied by this factor.
### TABaccuracy
Coordinates from the `h` file and the `idf` file are different. This value is required in order to identify the `Connection to` text.
### ICSmacro
MicroStation macro used to fill the text field in the ICS file. The isometric sheet, `???.i01`, is referenced automatically. This macro can be used to copy out the text field.
### ICSseedfile
ICS seed file.
### Gridfile
The PDS file for grid measurement. This is created by using PDS.
### ICSrefscale
Insertion scale for IOV in the ICS file.
### ICSrefpoint
Insertion point for IOV in the ICS file.
### gridextension
Extra grid extension. The terminal point may lie outside the grid if it is still within this value. This is useful if multiple grids are in use.
If this value is not specified, the terminal point may be located at any distance from the edge of the grid.
## Variables in the Programm section
### Lizenz
Enter the licence number here. The licence number is supplied by ITC-Schlegel. The licence applies to the entire domain, that is, the program can be used throughout the entire network.
### INI-File
The value of this variable is entered automatically by the software.
## Variables in the Iplot section
### Iparmfile
This variable specifies the IPlot Iparm file.
### IPlotque1 to Iplotque5
These variables make it possible to specify up to five plotters or printers. These are then listed in the drop-down list box.
## Variables in the I3D section
### I3Dseedfile
3D MicroStation file used as the seed file for the isometric view.
### I3Drefscale
Insertion scale for IOV in the ICS file.
### I3Drefpoint
Insertion point for IOV in the ICS file.
### I3DLENtext??
Colour, level, weight, text height, and similar settings for the line terminal number in the isometric view.
## Tools
### b DGN Find and Replace
DGNFindReplace is a tool used to find text in DGN files and replace it with the required text defined in an Excel sheet.
In the following example sheet, the text `A` on level `6`, with colour `0` and weight `1`, is replaced with the text `O`.
It is possible to define a folder in which the DGN files are searched with the required extensions. Specific DGN files can also be added to the file list for processing.
The Excel configuration file can be created manually, or automatically by using the **Extract text to Excel** function.
## DGN Fill Text Nodes
DGN FillNode is a tool used to fill text nodes in DGN files with text defined in an Excel sheet.
In the following example Excel sheet, all files whose names contain the substring `abc` are filled with the text `demo1` for text node number `753`. All files whose names contain the substring `.i0` are filled with the text `demo2` for text node number `701`.
