MULTI-FINGER IMAGER PROCESSING

SOFTWARE (MIPS)
MIPSVIEW SOFTWARE DOCUMENTATION
Date

January 2013

Release:

Beta

Software release:

MIPSView 2.2.0;

Documentation release:

2.2.0

PREPARED BY EPIDOTE LIMITED FOR BETA RELEASE TESTING ONLY

MIPSView Manual 2.2

Page 1

CONTENTS
Contents .......................................................................................................................... 2
Software overview ........................................................................................................... 4
This release ..................................................................................................................................................4
Whats new in this release ...........................................................................................................................4
MIPS General .................................................................................................................................................. 4
MIPS Viewer ................................................................................................................................................... 4
Plotting ........................................................................................................................................................... 4
Annotations & bookmarks .............................................................................................................................. 4
MIPS3D ........................................................................................................................................................... 5
MIPS products..............................................................................................................................................6

Software version control .................................................................................................. 7

Sources of help ................................................................................................................. 8
Manual ........................................................................................................................................................8
On-line Help .................................................................................................................................................8
Error handling ..............................................................................................................................................8
Email support ...............................................................................................................................................8

Software installation ........................................................................................................ 9

Hardware platform ...................................................................................................................................... 9
Installing and launching the MIPSVIEW software .........................................................................................9
Licensing ......................................................................................................................................................9

Project folder structure .................................................................................................. 10

Overview ................................................................................................................................................... 10
Folder contents & File naming conventions ............................................................................................... 10

MIPS Viewer................................................................................................................... 15
Viewer sub-windows.................................................................................................................................. 15
Main window ................................................................................................................................................ 15
Curve viewing window.................................................................................................................................. 16
Display Layout editor ................................................................................................................................. 23

MIPSView File menu ..................................................................................................... 31

Open Project ................................................................................................................................................. 31
Open Log set ................................................................................................................................................. 31
Open Context................................................................................................................................................ 32
Recently Used ............................................................................................................................................... 32
Close ............................................................................................................................................................. 32
Project Database........................................................................................................................................... 33
Settings ...................................................................................................................................................... 35
Exit ................................................................................................................................................................ 36

MIPSView View menu .................................................................................................. 37

Project file window ....................................................................................................................................... 38
Processing history window ........................................................................................................................... 39
Cross section and curve readout window .................................................................................................... 40
3D View......................................................................................................................................................... 42
Annotations ............................................................................................................................................... 43
Plotting from MIPS ..................................................................................................................................... 49

MIPSView Manual 2.2

Page 2

Channel Highlighter ................................................................................................................................... 51

Basic Workflow ............................................................................................................................................. 51
Process controls ............................................................................................................................................ 51

MIPSView Window menu ............................................................................................. 52

MIPSView Help menu ................................................................................................... 53

MIPSView Manual 2.2

Page 3

SOFTWARE OVERVIEW

THIS RELEASE
This document describes the January 2013 release of the MIPSView software package. The
MIPSView package consists of the MIPS Log viewing module only. It includes MIPS3D, API
style plotting and a new annotation feature.

WHATS NEW IN THIS RELEASE

In addition to bug fixes, the following performance enhancements have been made since
2.1 release:
MIPS GENERAL

1. File->Open->Log set now sticky remembering last folder from which a .mip1 file was
opened. This is reset to the processing folder when a new project is opened.
MIPS VIEWER

1. Readout window on LH side now shows the current .mip1 data file name with the
processing subfolder name.
2. Fixed bug where aux track scale bars were upper justified after file open with
inherited layout.
3. Improved handing of data containing Nulls.
4. Layout editor now has a Clone button in the aux track curve selection tab to copy
curve scales from row above.
5. Option under View->Curve highlight to temporarily turn on a highlight of a selected
multi-curve channel or auxiliary curve.
6. Data can be tiled horizontally or vertically from Window->Tile Horz or Tile Vert. In
vertical tiling mode data sets can easily be compared side by side.
PLOTTING

1. When .mip1 data file displayed with only one aux track defined in the layout file, it
will display with the multi-arm track double width.
2. Fixed bug in annotation anti-collision logic.
3. Trap requests for pdf files longer than 200 ins (a PDF limitation).
ANNOTATIONS & BOOKMARKS

MIPSView Manual 2.2

Page 4

1. Individual annotations can now be edited by pointing at the annotation text in the
viewer, then using RHM->Annotations->Edit text. This will launch the annotation
layer editor at the relevant annotation entry.
2. Fixed bug which used black text on black background as default font for new text
annotations when project was re-opened.
3. An annotation overlay of the pipe schematic can be displayed in Track #3. The layer
is defined via the View->Annotations manager. This can optionally include bars
showing collar locations, and pipe defects. The viewer uses tool tips to show the
pipe dimensions when the mouse hovers over the pipes. The thresholds for pipe
defect colouring are read from the file PipeGrades.xml in the project system folder.
MIPS3D

1. Added feature to lock the radial scalars to enable the user to compare ID data with
OD data.
2. Added feature so user can change the colour of the text next to the colour bar to be
compatible with different display backgrounds.
3. Changed drawing of OD cylinder from 20 sided polygon to 120 sided.
4. Fixed bug which was not drawing depth annotation or 3D axes to jpeg / bmp images.
5. Fixed bug which was not drawing OD cylinder if curve PipeOD was absent

MIPSView Manual 2.2

Page 5

MIPS PRODUCTS
The MIPS product is a modular set of software designed to realize the potential of cased
hole mechanical image (caliper) logs. Five primary modules provide the functionality of
MIPS.
The Log viewing module, in MIPSPro, MIPSLite and MIPSView, provides display and analysis
of multi-arm caliper logs, derived statistics, and dynamic pipe cross-sections.
The MIPSPro Data loading module is customized for client use, and reads field data from
the Sondex Mechanical Imaging Tool (MIT), LAS format log files or generalized ASCII log files,
and as an optional plug-in, direct from Warrior databases.
The MIPSPro Data processing module facilitates editing, re-calibrating, centralization and
orientation of the multi-arm caliper logs. A subset of these modules is provided in MIPSLite.
The MIPSPro Pipe Analysis Module allows a joint-by-joint determination of wall penetration
for corrosion analysis.
The MIPSReport module allows the definition and printing of multi-finger caliper reports.
This is included in licensed releases of MIPSPro.
The MIPS3D 3D visualization module allows the user to fly-down or examine the pipe from
any angle.
By combining modules, clients are provided with, for example:
A full processing package for the log analysis centre (MIPSPro & MIPS3D); A field processing
package for QC and well-site products (MIPSLite and MIPS3D); A log viewing tool for
reporting and interpreter use (MIPSView & MIPS3D).
The current release products are:
MIPSPro: Licensed and HASP protected data analysis and reporting interface, along with
several processing programs.
MIPSLite: Licensed and HASP protected data processing interface, along with some
processing options.
MIPSView: License free data viewing module.
MIPS3D: License free 3D viewer for use with MIPSPro, MIPSLite and MIPSView.
Documentation: MIPS manual and on-line help.

MIPSView Manual 2.2

Page 6

SOFTWARE VERSION CONTROL

All MIPS software releases are documented in the secure website area accessed via
http://www.epidote.co.uk . Data and software can also be transferred via secure ftp sites,
details provided individually to clients.
Each of the MIPS executables has its own release number so that updates and corrections
can be made to individual programs without re-releasing the whole package. Licensed users
are informed via email when new releases are available for ftp download.
The version number of MIPSPro / MIPSLite / MIPS3D / MIPSView can be found from the
HelpHelp About dialog.
The version number of processing modules in <software folder>/utils can be found by
double clicking on the executable in MS Windows Explorer.

MIPSView Manual 2.2

Page 7

SOURCES OF HELP
MANUAL
The software is supplied with a digital copy of this user documentation as a PDF file, which
may be printed if required. Note that the documentation is valid only for a specific release.
Documentation of changes since the manual release date are detailed in the release notes
accessed from Help->Release Notes.

ON-LINE HELP
The full user documentation for the current software is accessible from the main window
pull down menu Help Documentaon.
Updates including bug fixes since the last full documentation release can be accessed
through Help->Release Notes.
Web style help is available via Help->Help Topics.
All menus, dialog, error and warning boxes have a help icon which link the user to the
correct place in an online version of the user documentation.

ERROR HANDLING
All data input from the keyboard are checked for valid type and range. If incorrect, an error
dialog box is launched. Problems encountered with file formats or data values during a
processing operation are trapped, and the error reported to a dialog box.

EMAIL SUPPORT
Depending on commercial arrangements, email support is available from Epidote at
support@epidote.co.uk .

MIPSView Manual 2.2

Page 8

SOFTWARE INSTALLATION
HARDWARE PLATFORM
The MIPS software is designed for a PC platform running Windows XP; Windows Vista;
Windows 7 (x32 and x64); Recommended PC: 1GHz+ clock speed and 1GB RAM or better.
Graphics are written to leverage OpenGL compatible graphics cards. 3D performance will be
enhanced by use of fast graphics cards.
Warning to users of Non-English Windows settings: The MIPS User interface requires the
Windows number format to be set as English. This can be changed from the Windows
Control panel (e.g. in Windows 7: Clock, Language, and Region->Change the number
format).

INSTALLING AND LAUNCHING THE MIPSVIEW SOFTWARE

To install the MIPSView package, follow these steps:
-

Download the MIPSView package from the Epidote website.

Create a suitable folder on your PC hard drive for the software
Unzip the MIPSView package
If required create a shortcut to MIPSView.exe and move this to your desktop

MIPSView can be started by double clicking on MIPSView.exe or the shortcut icon.

LICENSING
Each release of the software is supplied as statically linked executable code, with a digital
copy of the User manual. The MIPSView package is not HASP protected, and can be redistributed by licensed MIPS users to their clients.

MIPSView Manual 2.2

Page 9

PROJECT FOLDER STRUCTURE

OVERVIEW
Each project has a standard folder (directory) structure, created automatically when a new
project is created. In overview this is shown in Figure 0-1. The project folders and its subfolders can be viewed in the MIPS Project File Window by checking View->Project File
Window.

Figure 0-1: Folder structure of MIPS project

FOLDER CONTENTS & FILE NAMING CONVENTIONS

DATABASE FOLDER

This folder contains one .xml format file with information about the project. The contents
can be viewed and edited from File->Project Database. The information is used to annotate
the header area of .pdf format plots made using the MIPSPlot plug-in, and to populate the
header section of MIPS reports.
SYSTEM FOLDER

This folder contains Context files <name>.mip0 in ASCII text that store the program status
(such as display filenames and layouts). These can be recalled when the program is restarted. A context file can be stored in named files using the FileSave Context as... menu.
The current context can be stored when the program exits. The option to store the context
on exit may be switched on/off using the FileSengs menu.
FIELD FOLDER

MIPSView Manual 2.2

Page 10

This folder is used to store field data files including LAS format input files, calibration files
and raw log files associated with the project. These must be manually copied by the user
into this folder after project creation.

Figure 0-1: Project field folder example

Example Files
Raw caliper data

(*.dat, *cal, *.las, *.mdt)

Binary

Raw log data

(*.las, *.asc)

ASCII data

PROCESSING FOLDER

Processed log sets are stored internally using sub-directories for separate runs and with the
following file naming convention: The base name is derived from the field data filename or
chosen at load time by the user. The software assigns the sequential file number during data
processing operations. The extension for intermediate and final processed log sets is .mip1.
E.g. run3_5.mip1.
(See also Appendix: MIPS internal data file format.)

MIPSView Manual 2.2

Page 11

Figure 0-2: Project processing folder example

TABLES FOLDER

Figure 0-3: Project tables folder example

MIPSView Manual 2.2

Page 12

These tables store project specific parameters used during data processing. All files are
formatted comma separated values (CSV) ASCII with extension [.mip2]. These files may also
be edited in a spreadsheet such as Microsoft Excel.
The processing modules use the following tables:

Edit tables
Depth correction tables
Re-calibration zone tables
Re-calibration shift tables
Pipe dimension tables
Pipe end depth tables
Collar profile tables
Pipe body and collar analysis tables

The formats of each of these tables are described in Appendix: Table formats.
LAYOUTS FOLDER

Figure 0-4: Project layouts folder example

This folder is used to store log display layouts in files with extension [.mip3], and colour
maps in files with extension [.mip4].

MIPSView Manual 2.2

Page 13

IMAGES FOLDER

This folder is used to store static and dynamic graphic images created during the project
using .bmp, .jpg and .avi formats. Movie files created by MIPS3D are stored in AVI
format a standard format that can be played back through Windows software.
REPORTS FOLDER

This folder is used to store MIPS generated reports such as output from the Joint Analysis
processor.
SCRATCH FOLDER

This folder is used to stored intermediate files used to communicate between MIPSPro and
the processing executables. In addition to information recorded in the header of MIPS data
files, it provides a trail to the parameters selected during processing. The subfolders names
and filenames include the date and time of processing.

MIPSView Manual 2.2

Page 14

MIPS VIEWER
VIEWER SUB-WINDOWS
MAIN WINDOW

Figure 0-1: Log viewing module -- main window

MAIN WINDOW BEHAVIOUR

The 'log viewing' module is central to all license types of the MIPS software. It can be
launched from the installation folder or from a Windows shortcut icon. The main window
has the look and feel of a standard Windows application including resizing and
iconisation.
Other modules are launched from the pull down menus of this window.
On start-up, the log file names, views and parameter settings can be read from an ASCII
format context file mip0', stored in the project system folder. The context of a previous
session may be retrieved by recalling a named context file using FileOpenContext.

MIPSView Manual 2.2

Page 15

CURVE VIEWING WINDOW

Figure 0-2: Curve viewing window

The curve viewing window consists of 3 paned areas: the multi-curve set display area, the
auxiliary curve display area, and the curve header area.
Several curve viewing windows may be open simultaneously. They are constrained to fill the
parent window. Tabs at the top of the curve viewing windows select different processed
curve sets. The curves in the window currently at the front are referred to as the live data.
The Curve viewing window displays multi-arm curves and auxiliary curves from a processed
curve set in two panes. The user may adjust the position of the pane divider.
Mouse pointer style is horizontal line across the graphics areas of both panes. This is the
'depth cursor' and drives the interactive cross section.
When a curve set is opened, the display uses settings from the current display layout. For
the first curve set opened this is loaded from a default 'settings' file. An existing layout may
be loaded or edited from RHM Layout Editor...

MIPSView Manual 2.2

Page 16

The depth range displayed when a curve set is copied from the currently live data. If this
depth range is not available, the nearest portion at this depth scale is shown. The newly
opened file becomes the current live data.
MULTI-ARM CURVE DISPLAY

Figure 0-3: Multi-arm and auxiliary display

See also Multi-arm display layout editor.

The arm readings are shown as vertical solid lines or VDL style, with a dotted line showing
the centre of the track.
A difference of Swing inches from the centre ID will bring the curve to the neighbouring
track centre. For example, if the Centre ID = 6.184, and the swing is set Swing = 0.2, then a
value of 6.384 will plot on the centre of the next track to the right.
Curves every 90 degrees (e.g. every 8 for 32 arm curve sets) are displayed as different
colour.
The VDL style of display maps the (reduced) arm values to a colour band centred along the
track. The colour map can be configured via the VDL display layout editor.

MIPSView Manual 2.2

Page 17

AUXILIARY CURVE DISPLAY

Auxiliary curves are displayed in one or more tracks. Up to 10 tracks may be defined, but
viewing efficiently more than a few on a typical PC screen is difficult. A horizontal scroll bar
pans the graphics area across the tracks.
Tracks are edited individually using the Layout editor with up to 12 curves per track. In
general each track has a header, with the name, colour, style, units and scale bar annotated.
If required the header for a curve can be turned off, for example if Outside Diameter (OD)
is being displayed.
Curves are selected from the current live data set. The display settings for each curve are
made using the Curve selection and style editor. Synthetic, constant value curves may be
generated for a track. This allows threshold values to be illustrated.
Shading between curves is defined by shading rules, set using the Shading rule editor. This
fills the gap between two real or synthetic curves with an arbitrary colour if the rule is valid.
CURVE DISPLAY HEADER AREA

The header area of the multi-arm and auxiliary curves is contained in a separate paned
window, as it potentially occupies valuable screen real estate. The panels can be reduced in
size by dragging the splitter bar vertically.
The title of the Multi-arm window is the type of multi-arm data in the current MIPS file. The
layout editor sets the titles of the auxiliary curves.
WINDOW TAB

The <filename> is displayed on a tab at the top of the window. When several windows are
open, these tabs are offset, but the window contents are lined up, so it is possible to toggle
between curve sets, by clicking on the tabs.
If the data displayed in the tabs has different depth ranges or the central splitter bar has
been moved, it is possible to re-align the tabs using RHM->Synchronize Panes. This sets all
tabs to the depth range (if possible) and width of the upper live tab.
WINDOW BOTTOM STATUS LINE

The following information is displayed along the bottom of the main window.
Depth <Depth pointed at by mouse>

MIPSView Manual 2.2

Page 18

Layout:<Layout file name> Displays the current layout file describing how to display the
data. If the name has a * next to it, this means the layout file has been edited and saved
but the display has not been updated. (This happens if the layout editor was accessed while
another data set was in the upper tab). To update the display with the revised layout, open
the layout editor, load the revised layout file, and click OK and close the layout editor.
"Display centre ID:" <Centre value> Multi-arm curves whose values are equal to the display
centre ID will plot on the track centre.
"Swing:" <swing>
Reduction: <Max/Min/Avg> <No. of samples averaged>. See Data reduction.
SI <Depth sample interval> <Units>
SCROLL BARS

Up:
Display same depth interval above current frame but overlap 10% (Up
button) or 90% (using scroll bar background). Alternatively use the keyboard Page Up
button.
Down:
Display same depth interval below current frame but overlap 10% (Down
button) or 90% (using scroll bar background). Alternatively use the keyboard Page Down
button.
LEFT MOUSE BUTTON

Point click drag - release selects a smaller depth interval. To return to a depth selection
before the last zoom (un-zoom), use the RHM Last depth. To zoom out one level centred
on the current depth frame use RHM Un-zoom. Zooms are nested up to 10 deep. The
zoom function is disabled while some of the data processing GUIs are active.
An explicit depth range may be selected from the RH mouse button menu Goto depth.
The display may also be zoomed in using the Up arrow key, and zoomed out using the
Down arrow key.
MOUSE RIGHT BUTTON POPUP MENUS

Last depth: Returns to depth selection before last zoom

Un-zoom : Zooms out to the previous zoom level depth scale, centred on the current depth
Goto Depth Allows explicit depth range to be displayed.
Full Range: Displays the full depth range of the .mip1 data file.
MIPSView Manual 2.2

Page 19

Visual ->
Caliper Lines : Toggle for line style curve in multi-arm display
Centre Lines: Turns dashed centre lines tracks for the multi-arm curves. Only
displayed if the caliper wiggle lines are also turned on.
Tool Upside: Turns on an overlay of the ToolUpside curve in the multi-arm track if it
is present in the .mip1 data file
Multi-arm title: Displays the title from the .mip1 file header at the top of the multiarm track.
VDL Shading : Toggle for colour VDL style in multi-arm display
Select VDL file > Allows VDL shading using values from another open .mip1 data
file (for use e.g. in a thickness overlay). This VDL map is also applied to the 3D display
in MIPS3D.
Cross Section : Launches cross section display of live data set
Log Value Launches Notepad to allow feeler values to be pasted from MIPS viewing tool to
a text file.
Synchronize Panes: Sets the depth range and multi-arm display width of all curve set tabs to
that of the live data set.
Layout editor Allows editing and saving of layout settings for the multi-arm display or for
the auxiliary curve display.
Reload Layout: Re-applies the definitions of the current layout file. This is used if the layout
has been edited from a different tab.
Bookmark->
Cross section: Stores a cross section definition (Data set name, depth and arm
number) from the current position of the mouse. These can be previewed and edited in the
bookmarks editor at Interpretation-> Bookmarks, and imported into MIPS reports.
Plot: Stores a plot definition (Data set name , layout file name, depth range) of the
current view. These can be previewed and edited in the bookmarks editor at Interpretation> Bookmarks, and imported into MIPS reports.
Annotations->
Add Text: Insert a text annotation at the current cursor position. The font, colour
and background for new annotations can be set in the Annotations manager in View->
Annotations
MIPSView Manual 2.2

Page 20

Show selected: Switches on / off all currently selected annotation layers.

Annotations layers can be selected and edited in View-> Annotations
Edit Text: If the cursor is pointing at an existing text annotation, this will launch the
text annotation manager and allow the details of this text annotation to be edited.
Clip Aux curves: clips the auxiliary curves at the track edges.
HIDING AUXILIARY CURVES

Auxiliary curves displayed in the auxiliary tracks can be temporarily hidden. Place the mouse
pointer in the header area of the auxiliary track, and use RHM->Hide curve-><Curve Name>.
The curves can be un-hidden using RHM->Unhide curves. Hiding curves using this option
does not remove the curve label, does not affect the displays of other tabs, and does not
affect the current Layout file.
DATA REDUCTION

In order to efficiently display curve when the number of samples to plot per pixel on the
screen exceeds one, some form of data reduction is necessary. One common algorithm for
data reduction is to compute the mean value of samples over the depth interval that
contributes to this size in the window. This is supplied as the average option. For display of
curves where finding holes is important, a more appropriate algorithm is the display of the
maximum of the samples over the depth interval relating to the display pixel. In both the
multi-arm layout and the statistics layout editors, all curves have a reduction option of
maximum, average or minimum.
The software computes the data reduction factor, using the algorithm selected in the
layout editors (Sections 6.1.7 and 6.1.8) from the depth scale and the screen resolution. This
number is displayed in the bottom frame of the curve display windows.
USE OF SECOND FILE FOR VDL DISPLAY

The RHM functionality Select VDL file allows the VDL colour to be mapped from a second
MIPS multi-arm set. This is sometimes useful for editing and for thickness or time-lapse
workflows. It should be noted that the data reduction applied to the VDL set is controlled by
the layout editor in the VDL set display, not in the primary live data display.
CURVE TITLES

This text is stored in the MIPS data sets and (optionally) displayed above the multi-arm set.
Each processor provides an automatic title to help track processing workflows. The display
of the title can be suppressed by toggling off Display multi-arm title in RHM->Visual->Multi-

MIPSView Manual 2.2

Page 21

arm Title. If the user wishes to edit the title (e.g. before delivering MIPS data files to a client)
this can be done in the header editor processor.

MIPSView Manual 2.2

Page 22

DISPLAY LAYOUT EDITOR

LAYOUT FILE CONTROL

Each tabbed data display in MIPS has an associated layout file that defines how the data
appears. These layout files are stored in the project Layouts folder. Layout files can be
stored and used in future projects by copying the files in to the new projects layout folder.
The name of the layout file in use is shown in the lower main window bar. The same layout
file can be used on multiple tabs. If the layout file has been updated (by editing from a
different tab) after the current display was created, a * is shown next to the layout file
name.
The Apply button shows the effects of any layout file edits, but file control ensures that
changes to layout files are saved to the current layout filename or to a new layout file when
the layout editor is closed using the OK button.

Layout File name displayed in MIPS lower bar

Layout File name displayed with * indicating layout file has been updated.

AUXILIARY CURVE PANEL SELECTION AND FILE CONTROL

MIPSView Manual 2.2

Page 23

Figure 0-1: Display layout editor Tab 1 -- Auxiliary Curve Panel selection and file control

A panel selector allows the user to create up to 2 panels or tracks for display in the auxiliary
view area. Selecting a panel for editing changes the scope of the subsequent tabs of the
GUI.
The number of vertical grid lines for the track can be set.
Files containing predefined layouts for the auxiliary curve display can be saved to or loaded
from disk. These are stored in the layouts folder of the project with extension '.mip3'.
Save will save the current layout definition to the current layout file.
Save As will launch a file save dialog for a new layout file and then save the current layout
definition
Load will launch a file open to load an existing layout file
New will re-set the layout definition to the default curve selection preserving any current
display settings.
CURVE SELECTION TAB

MIPSView Manual 2.2

Page 24

Figure 0-2: Display layout editor Tab 2 -- Auxiliary Curve selection

Curve types can be selected as Log and read from the auxiliary curves of the MIPS data file,
or as Synthetic and generated internally at a fixed value.
If a log is selected for edit in the Editing Tab column, this changes the scope of Tab 3 GUI
and allows settings (e.g. scale & title) for this log to be edited.
The curve required is selected from the pull down list of auxiliary curves in the current live
log set. If log type synthetic is selected, the value can be entered in the box.
Logs must be defined for display with no gaps, e.g. Log 5 can only be created if Log 4 exists.
Logs can be deleted by pressing the X button.
The auxiliary curve scales can be copied from the preceding curve definition by pressing the
'V' button. For example if the scale on 'Maximum' curve above was set from 3.0 to 5.0
inches, then clicking 'V' on the second line (Minimum curve) would also set this scale to 3.0
to 5.0 inches.

MIPSView Manual 2.2

Page 25

AUXILIARY CURVE SETTINGS TAB

Figure 0-3: Display layout editor Tab 3 -- Auxiliary Log style editor

The plot switch turns on and off plotting of this curve. This is used to suppress display of a
synthetic log defined only for shading purposes. Default: On.
The label switch turns on and off labelling of a curve. This can be used to suppress an
excessive number of headers. Default: On.
Label name allows the user to use a different name for display than the name of the log in
the log set. Default: log name from log set.
Scale low and scale high set the upper and lower values for the log display.
Data reduction options: Max, min or mean. See Data reduction.
Colour allows the user to select an arbitrary colour for the log. See Figure 0-7: VDL colour
editor.
Style is selected from a pull down list of available styles.

MIPSView Manual 2.2

Page 26

Figure 0-4: Auxiliary log and shading colour editor

SHADING RULE EDITOR

This is accessed from the Auxiliary log display layout editor (Section 0).

Figure 0-5: Display layout editor Tab 4 -- Shading rule editor

Shading between logs is defined by shading rules, set using the Shading rule editor. This
fills the gap between two real or synthetic logs with an arbitrary colour if the rule is valid.
A list of existing rules is tabulated.
Selecting Edit allows a new rule to be created. Log A and Log B are selected from a list of
Display names already defined by the log selection and style editor. If Log A > Log B
then shading is activated.
MIPSView Manual 2.2

Page 27

The colour of the shading is set using the colour editor (see Figure 0-7: VDL colour editor)
and style from a pull down lists.
After the rule is defined, pressing OK updates the list of log shading rules and updates the
live data display.
MULTI-ARM DISPLAY SETINGS

This is launched from RH mouse Layout in the mul-arm display area and selecting the
Multi-arm display tab.

Figure 0-6: Display layout editor Tab 5 -- Multi-arm display layout editor

Centre ID sets the value of the log at the centre of its track.
Edge Buffer sets the size of the blank area at the left and right hand edges of the main log
display.
Swing adjusts the deflection of the logs. A difference of swing from the centre ID will bring
the log to the neighbouring track centre. For example, Centre ID = 6.184, Swing = 0.2, then a
value of 6.384 will deflect to the centre of the next track to the right.
Data reduction options: Max, min or mean. See Data reduction
Color map allows the end values of the VDL scale to be entered, and a colour map defined.
Pressing the Edit map button spawns the colour editor (see Figure 0-7), allowing the end
colours to be defined. The values in between are interpolated by RGB value.

MIPSView Manual 2.2

Page 28

VDL COLOUR EDITOR

Figure 0-7: VDL colour editor

Colour Table files

Files containing a description of the colour maps are stored in the project's layout directory
with extension '.mip4'. A set of predefined colour maps are written to a new project when it
is created. A new colour map can be loaded by using the Files / Load dialog. A modified map
can be stored using the Files / Save dialog.
Data Endpoints
The feeler diameter corresponding to the first and last colours in the map can be set by
entering values into the Min and Max entry boxes. If the colours are to be mapped to the
range of data displayed in the current live multi-arm view, this can be done by clicking the
Visible Range button.
Colour Editor
Individual colours in the map may be edited by first selecting the colour cell to be edited,
then clicking on the Modify button. This launches a standard Windows colour palette
allowing the required colour to be selected.
MIPSView Manual 2.2

Page 29

Node Editor
Nodes are the cells in the colour map that define RGB values. These cells are marked with
thin red sides. Nodes can be added (Add) and deleted (Delete), or modified as above. The
colour of a cell that is not a node is calculated by RGB interpolation.
Selection
This number shows the index of the currently selected cell.

MIPSView Manual 2.2

Page 30

MIPSVIEW FILE MENU

OPEN PROJECT

This connects the software to a project, i.e. a set of caliper logs and other logs from a well,
using the Project Open GUI (Figure 0-1).

Figure 0-1: Project Open GUI

OPEN LOG SET

This allows the user to select and view processed curves stored in .mip1 data files. These are
stored in sub-folders of the project processing folder. On opening, a new log view tab is
created. The display layout used is either (1) For the first curve display, from the initial
settings (see File | Settings | Initial settings), or (2) for subsequent curve displays, inherited
from the current visible window.

Figure 0-2: Log filename browser

MIPSView Manual 2.2

Page 31

MIPS remembers which folder was accessed by Open Log set last and uses this as the
default next time.
OPEN CONTEXT

This allows the user to open a context file and recall previous work sessions such as display
filename and layouts. See Figure 0-3 Context File Open GUI. If the context has been saved
with a 3D view, MIPSView will automatically launch MIPS3Dview in a separate window. The
2D and 3D views will be synchronized so changes of depth and cursor movement in the 2D
view will update the 3D display.

Figure 0-3: Context File Open GUI

RECENTLY USED

These options facilitate the loading of recently used projects, MIPS data files and context
files.

CLOSE

File Close Project closes all the display windows.

File Close Log set removes the display of the current live data set.

MIPSView Manual 2.2

Page 32

PROJECT DATABASE

MIPS stores user supplied, project related information in a small .xml format file in project
folder database.
This information is used to populate the header section of reports generated by
MIPSReport, and the header of .pdf API style log plots.

MIPSREPORT HEADER TEXT FIELDS

The following fields are read from the project database:

Client
Field
Country
Well name
Analyst name
Pipe Description
Top logged depth

MIPSView Manual 2.2

Page 33

Bottom logged depth

Number of caliper fingers
Run number
Survey date
Survey reference number
Tool size
Tool type
Comment text

MIPSPLOT TEXT FIELDS

The following fields are read from the project database:

Client
Well name
Survey date

MIPSView Manual 2.2

Page 34

SETTINGS

File Se ngs launches a GUI for setting options that alter the behaviour of the package
(Figure 0-5).
Initial display parameters launches a Multi-arm layout editor GUI. (see Display layout
editor).
MIPS Package settings changes the behaviour of certain features of the package. The
settings are saved in file settings.mip3 stored in the project layouts folder. They can be reused between projects.

Figure 0-4: File | Settings submenu

Figure 0-5: MIPS Settings GUI

Open Output file on process completion. Default On.

This controls whether the output log set from a processing operation is automatically
displayed on process completion.
Inherit depth and layout from current view. Default On.
When a new MIPS file is displayed, the depth range and log display settings will be the same
as the previous 'live' display. If the new file has a different depth range, the default (upper
log section) depth range will be displayed.
MIPSView Manual 2.2

Page 35

Save context file on exit. Default Off.

The context system allows the package settings, the current live MIPS filename, and display
layouts to be saved at any time during a processing session, and then retrieved at a later
time. The package must be connected to a project before the save and open dialogs are
accessed. If a context file has been opened for the current session using, Save context writes
the current package settings, MIPS filenames, and display layouts to this file. If this settings
switch is set the system will save the current context when the package exits.
Debug GUI. Default off.
Generates diagnostics (For use by software developers only).
Debug processing. Default off.
Generates diagnostics (For use by software developers only).
Display dashed centre line behind multi-arm logs
This function toggles on/off a dashed line showing the relative position of the display centre
ID for each multi-arm track.
Display multi-arm title
The MIPS processors write a default title into the header of the MIPS data files. This function
toggles on/off the display of this title in the multi-arm header panel. The title can also be
edited using the header editor processor.
Annotate multi-arm data as radii
MIPS stores its multi-arm data internally as radii*2 to enable easy comparison of arm values
with nominal pipe diameters. By default the readout of log information under the MIPS
cross section display labels the arm values as Arm Value, and displays the maximum,
minimum, mean and median curves as radii*2. If the Annotate multi-arm data as radii is
switched on, these data are displayed halved and the arm readout labeled as Arm radii.
The Settings UI has to be closed before the MIPS viewer behaviour is updated.
Show VDL
This switches on/off the VDL display in the current view and sets the default behaviour for
new displays.
EXIT

File Exit saves the current status of windows and a layout to the current context file (if
enabled in the File->Settings->MIPS package settings menu) and stops the program.
MIPSView Manual 2.2

Page 36

MIPSVIEW VIEW MENU

Project file window toggles the appearance of the project file window at the top left of the
main window.
Processing history window toggles the appearance of the processing history window at the
bottom left of the main window.
Cross section launches a cross section window. The cross section and the curve readouts
relate to the visible data set.
All three of these windows may be floated, or docked to the left side or bottom of the
mother window. All may be closed using the X button in the upper RH corner or by
deselecting the option under the View pull-down.
3D View launches MIPS3D a 3D visualisation window see 3D Visualisation module
documentation MIPS3Dmanual.pdf. This window is not anchored. Only one 3D
visualization window is open at a time. The 3D view displayed is from the logs in the live
data set.
The 3D view is synchronised to MIPSPro when the 3D View menu item is checked. In this
mode MIPSPro controls the depth range displayed in MIPS3D, and the cursor position in
MIPSPro is shown on the 3D view. If the 3D View menu item is unchecked, the depth
displayed in MIPS3D is independent, and depth panning is enabled.
MIPS3D may be closed using its File | Exit option.

MIPSView Manual 2.2

Page 37

PROJECT FILE WINDOW

Figure 0-1: Project file window

This is a small sub-window initially anchored to the top left corner of the Main window. It
can appear or be hidden with the pull down switch ViewProject le window. This window
may be floated, or docked to the left side or bottom of the mother window. It may be
closed using the X button in the upper RH corner.
The window contains a Windows Explorer style GUI of the project after a project is created
or opened using the Project GUI. (See Error! Reference source not found.) (This is accessed
from the pull down menu File New or File Open Project).
See also Figure 0-1: Folder structure of MIPS project.
The window displays the folder and files from and including the <project> downwards in an
explorer style GUI.
Double clicking on any of the processed log sets (MIPS *.mip1 files) will open it into new log
viewing window using the current layout settings. Selecting a log set that is already open
will bring it to the front tab as the current live set.

MIPSView Manual 2.2

Page 38

PROCESSING HISTORY WINDOW

Figure 0-2: Processing history window

This is a small sub-window initially below the project file window. It can appear or be hidden
with the pull down switch ViewProject history window. This window may be oated, or
docked to the left side or bottom of the mother window. It may be closed using the X
button in the upper RH corner.
It contains the processing history of the current live data in the live log viewing window.
(see Processing modules for details of each processor and tables).
The license free viewer MIPSView has an option to display the processing history text from
.mip1 files. The processing module Header Editor allows the processing history text to be
edited to describe the file more succinctly to the client.

MIPSView Manual 2.2

Page 39

CROSS SECTION AND CURVE READOUT WINDOW

When launched, this un-anchored window provides a dynamic cross section, linked to the
cursor position in the live data set (the top curve viewing window).

Dynamic display of pipe cross section at position of depth cursor

(Dotted) outline of Nominal & Drift Ids and Pipe OD at this depth

Radius pointing to arm at cursor location

Scale bar for cross section

Full pathname of current live data set; current depth; arm

value, wall penetration (%) and arm number at cursor

Values of Nominal & Drift Ids and Pipe OD at this depth

Readout of all Auxiliary logs in data file

Figure 0-3: Cross section window

The cross section depth and current arm value is displayed under the graphic.
All the auxiliary curve values at the depth of the cursor are tabulated beneath the display. If
available, the drift ID, the nominal ID, and the pipe OD are read from the auxiliary curve and
tabulated in colour. They are also displayed as circles concentrically with the feeler sample
values.
In time-lapse and pipe thickness applications it is sometimes useful to overlay a cross
section display from a 2nd multi-arm set. The RHM pull down allows a 2nd multi-arm set to be
displayed as the effective pipe OD.
MOUSE RIGHT BUTTON MENU

Create JPEG Captures a JPEG format graphic file and allows this to be saved, by default in
the project images folder. This function has keyboard shortcut F9.

MIPSView Manual 2.2

Page 40

Create Bitmap Captures a BMP format graphic file and allows this to be saved, by default
in the project images folder. This function has keyboard shortcut F10.
Show pipe dimensions : Toggles display of Nominal & Drift IDs and Pipe OD.
Show OD file data : Toggles display of OD as data from a 2nd multi-arm set
Select OD file > If OD file data is toggled on, allows selection of an open multi-arm set as an
OD overlay
TOOL UPSIDE DISPLAY

As field files are loaded into MIPS an auxiliary curve named ToolUpside can be calculated
from the 'relative bearing' field curve. The ToolUpside is the index of the uppermost arm.
This is displayed as a High Side mark on cross section displays, example Figure 0-4.

Figure 0-4: High side indicator on cross-section

MIPSView Manual 2.2

Page 41

3D VIEW

3D pipe views are shown in a separate application MIPS3D.

For full documentation of MIPS3D see the current MIPS3D manual, accessed either from
MIPS3D->Help->Documentation, or the software installation folder.
If MIPS3D is not running, and 3D View is switched on, MIPS3D will launch with data from
the .mip1 file and depth range currently visible. The colour map used to paint the inside
surface is the 2D VDL colour map specified in the current layout file.
The two applications are synchronised so that changes of .mip1 file selections, depth range,
or VDL colours are reflected in the 3D view. The position of the depth cursor (depth and arm
channel number) is shown as a green ball on the 3D inside pipe surface.
If MIPS3D is running, and 3D View is switched off, MIPS3D will not close but will function as
an independent application, including depth selection and panning.

MIPSView Manual 2.2

Page 42

ANNOTATIONS
OVERVIEW

From release 2.1 MIPS supports the overlay of text annotations, cross section images and
other data on the curve data displayed in the main viewer, API plots and image copies.
A set of annotations is grouped into Layers. Annotations can be switched on individually or
as a layer. The style (e.g. font, colour, arrows) can be adjusted for each individual annotation
or layer. The check box at RHM->Annotation->Show Selected will switch on/off all
annotation layers selected in the Annotations manager.

MIPSPro viewer showing text and cross section annotations.

Text annotations appear on top of the multi-arm or auxiliary curves. The arrow direction is
automatically chosen so the text remains within the track. If two or more annotations
overlie, anti-collision logic will reduce the annotation lower in the list to an X in the margin.
Hovering over this mark will show the missing text.
The user can add text annotations from RHM->Annotation->Add Text. This launches a dialog
box for the user to add a text string anchored at this depth and Arm number/track position.
Text annotations can also be edited from RHM->Annotation->Edit Text.

MIPSView Manual 2.2

Page 43

Cross section annotations are drawn as an O in the RH margin. If the user clicks on this, an
image of the captured cross section will appear.
When run in joint body penetration mode, the joint analysis processor generates 3 sets of
annotations, showing the maximum penetration, minimum radius, and minimum diameter
points in each joint. These can be imported as text and/or cross section annotation layers to
illustrate the display.
A Well schematic annotation can be drawn in the 2nd (RH) auxiliary track. This shows the
tubulars defined in the well schematic or statistics processors, collars defined by a pipe ends
table, and corrosion anomalies defined by the pipe grading scheme.
Camera annotations are drawn with a Camera icon in the RH margin. If the user clicks on
one of these, a window appears showing the camera image associated with the nearest
annotation above the current depth cursor depth.
ANNOTATIONS MANAGER

The annotations manager is launched from MIPSPro->Interpretation->Annotations

MIPS Annotations manager

The upper grid shows the current defined annotation layers. Column 1 allows individual
layers to be selected for display, column 2 the layer type (Text, Cross section, Pipes or
Camera), and Column 3 the layer name. The first (fixed) layer is populated from RHM
actions in the main viewer.
MIPSView Manual 2.2

Page 44

As well as viewer or manual entry, layers can be built by importing from other sources:
-

Import text will launch a file open dialog to allow the import of text position
definitions produced during joint analysis. When one is selected, an annotation layer
is built.
Import Cross Section will launch a file open dialog to allow the import of cross
section definitions produced during joint analysis. When one is selected, an
annotation layer is built. It also allows the bookmarked cross sections to be imported
as an annotation layer.
Import Camera allows a camera image library (format from Epidote support) to be
read and stored as an annotation layer.
Well schematic layer definition allows the user to select a pipe ends table define
collars, and a pipe grading scheme to define corrosion anomalies.

New text layers can also be constructed manually by entering the details of each
annotation: Click New layer, select the new layer row and enter a name, then click Edit. The
Depth, position (Arm number/%age position in track) and text are required to define a text
annotation. In a similar fashion cross section annotation definitions can be entered by
selecting row Cross sections and then clicking Edit.
TEXT ANNOTATION LAYER EDITOR

This is launched from the annotations manager by selecting a row with a text annotation
layer and then clicking Edit. The annotations in the layer are listed in the grid. This shows
the track, position, depth and text of each annotation in the layer.
Individual annotations can be added or deleted via the Add or Delete buttons. The text of
an annotation can be edited directly in the grid.
The UI allows the user to adjust the font name (e.g. Arial), font size, text colour and
background colour and arrow direction of each annotation. To do this, select the row of the
required annotation, adjust the style, and then click Apply. This updates the annotations
database and the display.

MIPSView Manual 2.2

Page 45

Text Annotations layer editor

To set the font style to all annotations in the layer, click Apply Style to All. To set this as the
default style for future annotations, click Make Default Style. Note that arrow directions
can only be set for individual annotations. To quit the UI and keep any style changes which
have not been Applied, click Save and Close. To quit without saving the changes, click
Close.
CROSS SECTION ANNOTATION LAYER EDITOR

This is launched from the annotations manager by selecting a row with a cross section
annotation layer and then clicking Edit. The annotations in the layer are listed in the grid.
This shows the depth and associated text of each annotation in the layer.
Individual annotations can be added or deleted via the Add or Delete buttons. The text of
an annotation can be edited directly in the grid.
CAMERA ANNOTATIONS

This feature allows a library of downhole camera images to be linked to the viewer. When
activated a pop up window shows the camera image from the nearest image depth above
the depth cursor point. If a set of camera images is available, contact Epidote for more
details.
MIPSView Manual 2.2

Page 46

WELL SCHEMATIC ANNOTATIONS

If switched on, the well schematic annotation layer occupies the whole of auxiliary track 2.
The .xml file generated in MIPSPro is read to build an annotation layer. Up to 3 tubulars are
displayed. If the mouse hovers over a tubular, Pop-up text shows the Pipe OD, Weight,
Nominal ID, thickness and at the top and bottom depths of the tubular section as defined in
the well schematics table.
COLLARS

The collar depths are read from a Pipe ends table. Collars are shown as in the sketch, with
pop-up text identifying the item number, collar top depth and collar bottom depth.
DEFECTS

Defects derived from caliper are added to the annotation layer by colour coding the middle
of the inner pipe.
The user selects a .mip1 caliper data file which has the curve Max_perc_pen, maximum
%age penetration. Alternatively the user can select curve Mean_perc_pen, mean %age
penetration.
The user then selects colours which will be used to illustrate values above 4 thresholds. If
the curve value exceeds these thresholds, the middle of the inner pipe will be coloured
appropriately. The colours and defect thresholds are read from the PipeGrades.xml file in
the project system folder. These can be edited via Edit Grading.
PROCESS CONTROLS

Build will create or update the well schematic.

ANNOTATION MANAGEMENT

The pipe annotation layer is added to the list of annotation layers which can be managed
from MIPSPro-> Interpretation->Annotations. Each layer can be individually selected for
viewing and edited from this grid.
To edit or update the settings, this well schematic annotation form can be accessed from:

MIPSView-> View ->Annotations -> (Select pipe annotations layer)->Edit

MIPSView-> View ->Annotations -> Well Schematic Layer Definition

In the MIPS viewer, all selected annotations can be switched on/off using the RHM>Annotations->Show selected toggle.

MIPSView Manual 2.2

Page 47

OUTPUT

The MIPS annotations.xml file is updated with details of the pipe annotation layer.

MIPSView Manual 2.2

Page 48

PLOTTING FROM MIPS

MIPSPlot is a plug-in for MIPSPro, MIPSLite and MIPSView. It allows .pdf or .tiff format
digital files to be produced to provide hard copy illustrations of multi-arm caliper data. The
appearance of the plots is controlled using MIPS layout files in the same way as the MIPS
viewer. One or two auxiliary tracks are supported.
Basic project information is stored and retrieved from the project database and used to
annotate the header of the displays. The project database can be edited from MIPSPro File>Project database. The information is stored in a single .xml file in project folder Database.
For pdf plots the information retrieved is Client Name, Well name and Survey date. The
name of the input .mip1 data file and the plot creation date are also displayed.
Access to the Plotting user interface (UI): The plotting parameters UI is accessed from View
-> Plotting.

Figure MIPS Plotting UI

Select input .mip1 datafile allows the user to select the input dataset for plotting. By default
this is the visible live dataset in the MIPS viewer.

MIPSView Manual 2.2

Page 49

Select layout file allows the user to select the layout file that controls the appearance of the
display. By default this is the current layout file in use on the live data.
Select page size controls the size of target paper for the plot (A0 A5). The width of the
image is set to fill the paper in its selected orientation.
Scale can be set to:
Fit page, in which case the vertical scale depends on the paper size, orientation and depth
range selected. The plot will fit on one page.
Fixed Scale, in which case a fixed vertical depth scale (e.g. 1:200) can be selected. This is
designed for continuous feed plotters. A maximum length of 200ins (787cm) is supported in
pdf format.
Fixed Scale/Paginate, in which case a fixed vertical depth scale (e.g. 1:200) can be selected.
The display will be divided up to fit on sheets of paper, with a small overlap at the page
breaks.
Depth range is by default the visible depth range in the MIPS viewer, but can be selected
manually. Full range selects the full range of the input data set.
Dots per inch allows higher quality displays to be made if they are supported by the plotting
device. A larger number of dots per inch results in larger pdf file sizes.
Show VDL / Show Centre Lines / Show Annotations will override the settings inherited from
the current MIPS display or MIPS settings file.
Output Type allows the user to select between pdf or tiff formats.
Line style limitations: PDF does not support dashed lines or cross hatched shading, or plots
longer than 200"
Select output filename allows the user to choose an output filename for the .pdf or .tiff
plot, by default in the project images folder.
If the Open PDF file when created box is checked, the pdf file will be displayed in the PCs
default pdf viewer.
Click OK to generate the plot.

MIPSView Manual 2.2

Page 50

CHANNEL HIGHLIGHTER
This utility allows a multi-curve channel to be selected and highlighted in the MIPS viewer
for ease of identification.

MIPS Channel highlighter form

BASIC WORKFLOW

Launch the channel highlighter from pull down menu View -> Channel Highlight.
Select the required channel number or name.
Select a colour for the highlighted curve (may be needed if the VDL is switched on).
Press Highlight.
PROCESS CONTROLS

A pull down list of arm numbers / curve names allows the required channel to be selected.
Highlight will highlight the selected curve by changing its colour and adding a background.
Highlight Colour gives a selection of colours
Close will turn off the highlighting and close the UI.

MIPSView Manual 2.2

Page 51

MIPSVIEW WINDOW MENU

Cascade places the open windows behind each other, displaying the log set name on a tab
above the window. This allows the user to toggle between views before and after
processing steps.
Maximise arranges the open display windows as overlaid tabs allowing rapid comparison
of data sets. This is the default window configuration.
Tile Horz produces a non-overlapping layout of all open windows inside the main window
space organised horizontally.
Tile Vert produces a non-overlapping layout of all open windows inside the main window
space organised vertically. This mode is useful for comparing data sets side-by-side.
Split allows the user to easily readjust the relative sizes of the multi-arm, auxiliary, or
header windows within the main viewing window.
Zoom in will zoom the current display centred on the middle of the window, reducing the
depth range by 50%. This can also be achieved using the keyboard Up arrow.
Zoom out will zoom out the current display centred on the middle of the window, increasing
the depth range by 100%. This can also be achieved using the keyboard Down arrow.
Create JPEG creates a .jpg digital image of the visible multi-arm curves and auxiliary curves.
The window may have to be enlarged to correctly capture the image. The file save menu
defaults to the project images folder. This function has keyboard shortcut F11.
Create Bitmap creates a .bmp digital image of the visible multi-arm curves and auxiliary
curves. The window may have to be enlarged to correctly capture the image. The file save
menu defaults to the project images folder. This function has keyboard shortcut F12.
<List of open data sets> provides a one click shortcut to bring the selected log set to the
front as the live data set.

MIPSView Manual 2.2

Page 52

MIPSVIEW HELP MENU

Help Topics launches the browser based help web system. This contains documentation for
online help and workflows.
Documentation launches Adobe Acrobat reader with a copy of this documentation.
Release Notes launches Adobe Acrobat reader with details of upgrades and bug fixes since
the last full documentation release.
Help about provides product information and the current MIPSPro version number. This is
required for email support, and for reference to any hardcopy documentation.

MIPSView Manual 2.2

Page 53