MIPSView Manual
MIPSView Manual
SOFTWARE (MIPS)
Release: Production
THIS RELEASE
This document describes the April 2016 2.4 release of the MIPSView software package.
GENERAL
1. New Feature: Maximum array channel count in .mip1 files has been increased to 1000 to
accommodate new data types e.g. waveform, cement. #6506
2. Bug Fix: Some menus were not fully visible when displayed on low resolution displays.
#7572
HELP
MIPS VIEWER
1. New Feature: Recent Project Layout Files can now be accessed from the RHM Menu
#2247
2. New Feature: The VDL Colour Bar is now a user-selectable option from the RHM menu
#7576
3. Bug Fix: Display Portrait Mode is now supported for high resolution monitors #7575
4. Bug Fix: On some systems, MIPS crashed when the last log set was closed #6555
5. Bug Fix: In some situations when zoomed in a long way, the gridlines disappeared #7577
6. Bug Fix: All aux curve headers are now visible when a .mip1 file is loaded #7582
7. Bug Fix: If dotted lines are selected for auxiliary curves in layout editor, they now display
as expected. #7681
8. Bug Fix: Any aux curves can now be hidden from display using RHM->Hide Curve #7671
9. Bug Fix: Layout Editor -> Aux Curves Tab issue fixed whereby adding another curve re-set
any previously modified header labels to their actual names. #7693
10. Bug Fix: RHM->Visual preferences were sometimes not retained #7721
SETTINGS
1. Enhancement: Preferences and Default Layout items are now grouped more logically.
#7589
2. Bug Fix: Default Settings and Preferences are now correct for a first time installation of
MIPSPro. #7687
VIEW MENU
PLOTTING
1. Fixed Bug: Reduced the time taken to generate a PDF and TIFF file for plotting
2. Bug Fix: Aux track displayed some incorrect colours #6520
3. Bug Fix: No plot produced with metric data set and fixed scale less than 1:100 #7554
4. Bug Fix: No plot produced with metric data set for depth range of greater than 2000m
#7652
5. Bug Fix: Grading information if included is now fully visible at the top of a plot #7691
6. Bug Fix: Fixed error in Fixed Scale/Paginate modes when Track 2 contained shading
#7734
ANNOTATIONS
1. Enhancement: The Apply button can now be used to preview Annotations in the viewer
immediately, without having to save and exit the annotations form. #7682
CROSS SECTION
1. Bug Fix: Cross section pen size default was too large with small radii values #6553
2. Bug Fix: Shading between ID & OD not always displaying #6542
PROCESSING HISTORY
1. New Feature: MIPS Version Number, Sentinel License Key Number and Analyst Name
(Optional) are now written to the .mip1 file processing history #7604
2. Enhancement: Curve edits are now fully reported in the processing history #6532
3. Bug Fix : The visibility of depth annotations has been improved #5488
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
DLIS format data files.
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 Joint Analysis module allows a joint-by-joint determination of wall penetration
for corrosion analysis.
The MIPSPro Report 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.
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).
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.
MIPS3D: License free 3D viewer for use with MIPSPro, MIPSLite and MIPSView.
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 download.
Beta test releases have a letter in the release number e.g. 2.3.1.0a.
The version number of MIPSPro / MIPSLite / MIPS3D / MIPSView can be found from the
Help→Help About dialog.
The version number of processing modules can be found by double clicking on the executable
in MS Windows Explorer.
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 software
release. Documentation of changes since the documentation date are posted online at the
support website.
ON-LINE HELP
The full user documentation for the current software is accessible from the main window pull
down menu Help → Documentation.
Updates including bug fixes since the last full documentation release can be accessed through
Help→Release Notes.
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
HARDWARE PLATFORM
The MIPS software is designed for a PC platform running Windows XP, Windows Vista,
Windows 7 or Windows 8 with 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. A .NET 3.5 or later installation is also required.
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).
Warning to users of non-English characters: We have tested the MIPS interface using the
standard English character set. Using non-English characters in the filenames and pathnames
may result in software failure or unpredictable results.
- Download and unzip the MIPSView installer from the website/ftp site.
- Copy the zip file o the required location on the file system and unzip.
- Create a desktop shortcut to MIPSView.exe if required
LICENSING
The MIPSView package is not HASP protected, and can be re-distributed by licensed MIPS
users to their clients.
OVERVIEW
Each project has a standard folder (directory) structure, created automatically when a new
project is created. In overview this is shown in the Figure below. The project folders and its
sub-folders can be viewed in the MIPS Project File Window by checking View→Project File
Window.
FOLDER CONTENTS
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 MIPS generated .pdf / .tiff format plots, and to populate the header section of
MIPS generated 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 re-started.
A context file can be stored in named files using the ‘File→Context Manager...’ menu.
FIELD FOLDER
This folder is used to store field data files including LAS format input files, calibration files and
raw log files associated with the project.
Example Files
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 a sequential file number and a
description of the most recently completed processing operation during data processing
operations. The extension for intermediate and final processed log sets is ‘.mip1’. E.g.
run3_5.mip1.
TABLES FOLDER
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.
Edit tables
LAYOUTS FOLDER
This folder is used to store log display layouts in files with extension [.mip3], and colour maps
in files with extension [.mip4].
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.
This folder is used to store 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. The default behaviour of MIPS (which can
be modified in File->Settings) is to delete the contents of the scratch folder on program exit.
FOLDERS
The LAS, DLIS and MIT import processors write by default to the following sub-folders of the
project processing folder:
Caliper: ‘MFC/<Source>/
Thickness: ‘Thickness/<Source>/’
Where <Source> is the name of original LAS, DLIS or MIT field file.
FILENAMES
<n>_ProcX_Source_m.mip1
Where
n = Sequential number for this processing stream showing the order in which data was
processed. Each MIPS process should increment this number by 1. The number has the
leading zeros included e.g. 002 so they are sequentially ordered in Windows Explorer and file
Open dialogs.
ProcX = Last processor which was run on the data (list of mnemonics see Appendix 6).
m = Sequential number for this processor, ‘_0’ (zero) the first time the process is run in this
processing sub-folder. The number ‘m’ is incremented if a particular processor is run again to
prevent it overwriting an existing file. Note underscore ‘_’ so it does not get confused with
any trailing digits in the ‘Source’ string.
EXAMPLES
1. Caliper data from file ‘Well999_Run1.las’ will be default be loaded to:
<Project>/processing/MFC/Well999_Run1/1_LASImport_Well999_Run1_0.mip1
2. If depth correction is performed on this data, the default output file will be :
<Project>/processing/MFC/Well999_Run1/2_DepthCorr_Well999_Run1_0.mip1
4. If the data was depth corrected again, using ‘1_LASImport...’ as input, the default
output file would be:
<Project>/processing/MFC/Well999_Run1/2_DepthCorr_Well999_Run1_1.mip1
5. If the data was depth corrected, using ‘3_ EccenCalc...’ as input, the default output file
would be:
<Project>/processing/MFC/Well999_Run1/4_DepthCorr_Well999_Run1_1.mip1
The user can change the output filename using the button ‘MIPS Output File’ on processor
UIs.
If selected the file save dialog will by default to point to the correct processing sub-folder.
If a file is selected for input which does not have the above structure, the default output name
will be: 1_ProcX_<Input file name>_m.mip1.
VIEWER SUB-WINDOWS
MAIN WINDOW
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 File→Open→Context.
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 a 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... where RHM indicates Right Hand Mouse click.
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.
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 a 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. If the VDL is
switched on, the colour map is displayed as a bar in the header area of the multi-curve track.
Auxiliary curves are displayed in one or more ‘tracks’. 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.
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.
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.
The following information is displayed along the bottom of the main window.
“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 use
RHM→Reload Layout
"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>
SCROLL BARS
Up: Display same depth interval above current frame but overlap 90% (Up button) or 10%
(using scroll bar background). Alternatively use the keyboard ‘Page Up’ button.
Down: Display same depth interval below current frame but overlap 90% (Down button) or
10% (using scroll bar background).Alternatively use the keyboard ‘Page Down’ 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 → Undo Zoom. Zooms are nested up to 10
deep. The zoom function is disabled while some of the data processing UIs are active.
An explicit depth range may be selected from the RHM button menu → Goto Depth.
The display may also be zoomed in using the ‘Up arrow’ key, and zoomed out using the ‘Down
arrow’ key.
Undo Zoom: Zooms out to the previous zoom level depth scale, centred on the current depth
Full Range: Displays the full depth range of the .mip1 data file.
Visual →
Caliper Lines: Toggle for caliper lines to be displayed or not displayed curve in multi-
arm display
Centre Lines: Turns dashed centre lines tracks on or off 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
Show As Radii: Displays multi-arm data as radii rather than radii*2 if selected
VDL Shading: Toggle for colour VDL style in multi-arm display. The colour map will be
shown in the header area of the multi-curve track.
Show VDL Colour Bar: Toggles the VDL colour bar on/off in the header area of the
multi-curve track.
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.
Log Value: Launches Notepad to allow feeler values to be pasted from MIPS viewing tool to a
text file. Once Notepad has launched feeler values at one or multiple depths may be
appended to it with a left hand mouse click at the required depth.
Synchronize Panes: Switches on/off tab depth synchronization. When on the depth range and
multi-arm display width of all curve set tabs is set 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.
Recently used layouts: Displays a list of recently used layout files that can be applied to the
display
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…
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.
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
editor (see Layout Editor) from the depth scale and the screen resolution. This number is
displayed in the bottom frame of the curve display windows.
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-
arm Title.
Array and auxiliary curve data is stored by MIPS as .mip1 format files, usually in sub-folders
of the project processing folder. Layout files control which curves are displayed in the MIPS
viewer, and their appearance. Layout files are usually stored in the project layouts folder, and
can be edited using RHM→Layout Editor…
The following hierarchy describes which layout file is used to display a particular .mip1 file:
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 project’s 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 with ‘*’ indicating layout file has been updated.
Figure: 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 UI.
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
New will re-set the layout definition to the default curve selection preserving any current
display settings.
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 UI 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.
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.
The Plot the Log 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 the Log 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.
Line Colour allows the user to select an arbitrary colour for the log. See Figure: VDL colour
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.
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.
After the rule is defined, pressing OK updates the list of log shading rules and updates the ‘live
data’ display.
This is launched from RHM → Layout Editor in the multi-arm display area and selecting the
‘MultiArm Settings’ tab.
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.
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), allowing the end colours
to be defined. The values in between are interpolated by RGB value.
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
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
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 UI (Figure).
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.
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. 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.
RECENTLY USED
These options facilitate the loading of recently used projects, MIPS data files and context files.
File → Close → Log Set removes the display of the current ‘live data’ set.
MIPS stores user supplied, project related information in an .xml format file in the project
‘database’ folder.
This information is used to populate the header section of reports generated by MIPSReport
and the header of API style log plots.
Client name
Well name
Survey date
A customised pipe grading definition file ‘pipegrades.xml’ can be retrieved from the
personal archive for use in joint analysis and reporting.
SETTINGS…
File → Settings… contains two subsections for setting options that alter the behaviour of the
package. The default behaviour of various MIPS setting can be set per project, or across all
projects for a particular user.
DEFAULT LAYOUT
The following default layout parameters are stored in the settings.mip3 file in the project
layouts folder, for use in subsequent MIPS sessions for that specific project.
This function toggles on/off a dashed line showing the relative position of the display centre
ID for each multi-arm track. The centre line visibility can also be controlled from
RHM→Visual→Centre lines. Default Off.
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. Default On.
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 ‘Annotate multi-arm data as radii’ is switched on, these
data are displayed halved and the arm readout labelled as ‘Arm radii’. Default Off.
Show VDL
Toggles on and off the VDL display behind the multi-arm logs. The VDL colour map is set in
the Layouts editor (Main view, RHM→Layout Editor…, Multi-Arm Settings tab). The VDL
display visibility can also be controlled from RHM→Visual→VDL Shading. Default Off.
Toggles an overlay of the tool upside curve on top of the multi-arm display, if the curve
exists in the visible log set. The visibility of this curve can also be controlled on the current
display from RHM→Visual→Tool Upside. Default On.
Toggles on and off the VDL Colour Bar display below the Multi-Arm Title for multi-arm logs.
This can also be controlled from RHM->Visual->Show VDL Colour Bar. Default On.
This sets various switches which control the behaviour of the package. These values apply
across all projects opened by a particular user from the same computer.
This controls whether the output log set from a processing operation is automatically
displayed on process completion.
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.
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, 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.
Delete scratch files on exit: Default is ‘On’. If set, then all sub-folders and files are deleted
from the project Scratch folder on project close or package exit.
Analyst Name: The (optional) name entered here is displayed in the processing history of
the .mip1 file.
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.
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.
The 3D view is synchronised to MIPSView when the 3D View menu item is checked. In this
mode MIPSView controls the depth range displayed in MIPS3D, and the cursor position in
MIPSView 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.
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 View→Project File 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 UI of the project after a project is created or
opened using the Project UI. (See Error! Reference source not found.) (This is accessed from
the pull down menu File→ New or File→ Open→ Project).
The window displays the folder and files from and including the <project> downwards in an
explorer style UI.
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.
This is a small sub-window initially below the project file window. It can appear or be hidden
with the pull down switch View→ Processing History 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.
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).
From MIPS 2.4, the processor version, MIPS license key and the Analyst (if defined in the
Preferences form) are recorded for each process.
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).
(Dotted) outline of Nominal & Drift Ids and Pipe OD at this depth
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.
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.
Show Pipe Dimensions: Toggles display of Nominal & Drift IDs and Pipe OD.
Show Cross section: Toggle on/off the display of the cross section itself. Default is ‘On’.
Pen Options: Allows the user to select the width of the lines in the cross section display.
Default is width ‘1’ (Thin).
Show Highside: Shows a red tick indicating tool upside. This is read from the curve ‘Tool
Upside’. Default is to show this when the curve exists in the current live data set.
Show OD File Data: Toggles display of OD as data from a 2nd multi-arm set
Select OD file > If Show OD File Data is toggled on, allows selection of an open multi-arm set
as an OD overlay.
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.
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.
OVERVIEW
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.
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→Annotations→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 by positioning the cursor over the text and clicking
RHM→Annotations→Edit Text.
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 2nd (RH) auxiliary track. 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 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
As well as viewer or manual entry, layers imported from other sources in MIPSPro or MIPSLite,
can be viewed in MIPSView.
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 set a new style for a single
annotation, select the row of the required annotation, adjust the style, and then click Apply.
This updates the annotations database and the display. To apply the style to all the
annotations in this layer, click Apply style to all.
Note that with the ‘Auto’ option for arrow selected, the direction is chosen to keep the text
field inside the track edges.
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.
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. More information on Camera Annotations is available in the online
MIPSView help topics.
If switched on, the well schematic annotation layer occupies the whole of auxiliary track 2.
The .xml file generated in the Well Schematic or Statistics processor 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
ANNOTATION MANAGEMENT
The pipe annotation layer is added to the list of annotation layers which can be managed from
MIPSView→ View→ 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:
In the MIPS viewer, all selected annotations can be switched on/off using the RHM →
Annotations → Show Selected toggle.
The MIPS annotations.xml file is updated with details of the pipe annotation layer.
The plotting utility in MIPS 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 MIPSView
File→Project→Database. The information is stored in a single .xml file in project Database
folder. The header information shown 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.
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.
Select page size controls the size of target paper for the plot (A0 – A5, and Letter). The width
of the image is set to fill the paper in its selected orientation.
‘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.
‘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.
Fixed Scale/Paginate for continuous plotters’, a fixed vertical depth scale (e.g. 1:200) can be
selected; the output is ‘continuous’ for fan-fold plotters.
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 controls the quality of the plot (and the consequent size of the output file). The
MIPS plotting module uses the same data reduction technique as the main MIPS viewer,
selecting the type of reduction (max, min or mean) from the current layout file. As a guide, at
A4 size the main MIPS viewer has equivalent depth resolution as an ~ 10dpi plot. Hence by
selecting higher dpi’s e.g. 600, the tiff / pdf display will show more detail than the view on
screen, but will occupy more disk space.
Show VDL, Show Centre Lines, Show Annotations, Show Caliper allow the colour VDL, the
multi-arm centre lines, annotations, and the multi-arm curves to be switched on/off for the
plot. Their initial settings are inherited from the current display. If the VDL colour map is an
overlay from a secondary multi-arm file, this behaviour is also inherited from the main viewer.
Output Type allows the user to switch between pdf and tiff format output files.
PDF limitations: PDF does not support dashed lines or cross hatched shading.
TIFF limitations: Tiff file sizes depend on plot area and can be large. For long plots lower
resolution may be required (70 or 150dpi). Plots at higher resolutions may be limited by
contiguous computer memory.
‘Select Output filename ' allows the user to choose an output filename for the plot, by
default in the project ‘images' folder.
This utility allows a multi-curve channel or auxiliary curve to be selected and highlighted in
the MIPS viewer for ease of identification.
BASIC WORKFLOW
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’.
Close will turn off the highlighting and close the UI.
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.
Documentation launches the system default pdf reader e.g. Adobe Acrobat with a copy of
this documentation.
Release Notes launches pdf reader with details of upgrades and bug fixes since the last full
documentation release.
Help About provides product information and the current MIPSView version number. This is
required for email support, and for reference to any hardcopy documentation.
Comments: Added by the processor while using the Pipe End Editor
Note: Collar analysis results are defined in similar fashion relative to the collar ID and OD. A
copy of this definition is available as a PDF format file for inclusion in reports.
PIPE DIMENSIONS
PIPE DIMENSIONS
Item (no.)
In ‘pipe-by-pipe’ analysis this represents the sequential pipe section number, selected
during pipe end detection and editing, and indexed from the bottom up.
The mean average value of the mean diameter in ins or mm over the pipe length.
The mean average value of the median diameter in ins or mm over the pipe length.
The average remaining wall thickness in % of nominal thickness of this pipe length.
MAXIMUM PENETRATION
Twice radius in inches or mm at maximum penetration of the pipe wall in the pipe section.
(Expressed as a diameter - twice radius - for comparison with Nominal and Drift Ids).
Maximum penetration of the wall in the pipe section, expressed as a percentage relative to
the difference between Nominal ID and OD at the maximum penetration point.
Orientation in degrees of maximum wall penetration in the pipe section. *Tool upside curve
required in input .mip1 data file.
Minimum wall thickness in the pipe section as %age of wall thickness at maximum
penetration point. Negative value implies wall is fully penetrated.
WALL LOSS
The maximum value of metal loss in this pipe section, expressed as the areal loss of wall
relative to the outer diameter and nominal diameters. For each sampled depth in the pipe
the metal loss is calculated as:
The joint analysis module reports the maximum of the wall loss in the pipe section
independent of the maximum penetration.
The maximum value of metal loss in the pipe, expressed as the percentage areal loss of wall
relative to the outer diameter and nominal diameters. For each sampled depth in the pipe
the loss is calculated as:
Percentage wall loss = (100/n) (Si 2-ID2)/( OD2-ID2), where n is the number of caliper arms,
Si is twice the radius measured by caliper arm i, ID is the Nominal ID of the pipe.
The mean average value of the areal wall loss wrt inner and outer nominal diameters over
the pipe length (%).
The integrated restriction in cubic inches or mm or cubic metres of the borehole over this
pipe length
The integrated restriction of the borehole as a %age of the bore volume over this pipe
length
RESTRICTIONS
Smallest arm reading in inches or mm in the pipe section, (expressed as twice radius for
comparison with Nominal and Drift Ids).
Orientation in degrees of arm with minimum radial restriction in the pipe section. *Tool
upside curve required in input .mip1 data file.
Maximum wall thickness in the pipe section as %age of wall thickness at minimum
restriction point.
Largest projection into the well bore from the pipe wall in ins or mm based on Nominal IR.
Largest projection into the well bore from the pipe wall as a %age of Nominal IR.
Smallest diameter in the pipe section measured on opposing arms as a %age of Nominal ID.
First arm with smallest diameter in the pipe section measured on opposing arms
Orientation in degrees of first arm with smallest diameter in the pipe section measured on
opposing arms. *Tool upside curve required in input .mip1 data file.
In 'Global detection mode' the N most significant 'events' in the pipe body section are
detected over the selected depth range are written to the output Joint Analysis table.
Currently collar sections and thickness data are not supported in Global detection mode. The
following are calculated:
CALIPER ONLY
See web help for table with joint selection headings, and for definitions using median ID
instead of nominal ID.
heading
heading
8 Max Int Pit ins/mm The difference Max Int Pit = Max
between the (Radius*2-NomID)/2
Maximum twice
radius in the joint and
the Nominal internal
radius of the joint.
heading