Scanit User Guide
Scanit User Guide
Kingdom® 2018
Scanit User Guide
February 2018
2 © 2018 IHS Markit™. All Rights Reserved.
Trademarks and Copyright
This manual was produced by IHS Markit.
February 2018
.
IHS Markit Kingdom® software and all of its components, AVOPAK, CGMPAK, GeoSyn®,
LoadPAK, PAKnotes®, Petra®, SynPAK®, Tunnel L+, Tunnel O, VelPAK®, VuPAK®,
Kingdom 1D Forward Modeling, Kingdom Colored Inversion, The Kingdom Company,
Kingdom Data Management, Kingdom DM Catalog Builder Kingdom Illuminator
Kingdom Seeker, and Kingdom I3D Scan are trademarks of IHS Markit.
Portions of data loading are copyrighted by Blue Marble Geographics.
Mapping API for the Spatial Explorer map provided by Esri ArcGIS Runtime SDK for .NET.
Kingdom Geophysics contains components under U.S. Patent Numbers 6,675,102,
8,265,876, and 9,105,075.
VuPAK® includes OpenInventor® and VolumeViz from FEI Visualization Sciences Group,
Inc. Some components or processes may be licensed under U.S. Patent Number 6,765,570.
Tunnel L+ includes OpenWorks® and SeisWorks® Development Kit from the Halliburton
Corporation.
Kingdom Connect and Tunnel O include OpenSpirit® FrameWork from OpenSpirit, a
TIBCO Software Group Company. Kingdom Data Management includes components from
OpenSpirit and are copyrighted by OpenSpirit, a TIBCO Software Group Company.
Kingdom Gateway plug-in for Petrel* E&P software platform uses the Ocean* software
development framework and * is a mark of Schlumberger.
Kingdom®1D Forward Modeling® includes software developed as part of the NPlot library
project available from: http://www.nplot.com/.
Portions of Kingdom® bitmap graphics are based on GD library by Boutell.Com, Inc. Further
information about the company can be found at www.boutell.com.
PAKnotes TIFF support is based in part on libtiff.
Copyright Notice
© 2011 - 2018 IHS Markit. For Internal use only. All rights reserved.
This manual contains confidential information and trade secrets proprietary to IHS Markit LTd.
and its affiliated companies (“IHS Markit”). No portion of this manual may be reproduced,
reused, distributed, transmitted, transcribed or stored on any information retrieval system, or
translated into any foreign language or any computer language in any form or by any means
whatsoever without the express written permission of IHS Markit. For more information,
please contact Customer Care at kingdom_support@ihsmarkit.com.
Misuse Disclaimer
IHS Markit makes no representation or warranties of any kind (whether express or implied)
with respect to this manual or the Kingdom® software and to the extent permitted by law, IHS
Markit shall not be liable for any errors or omissions or any loss or damage or expense
incurred by an user. IHS Markit reserves the right to modify the Kingdom® software and any
of the associated user documentation at any time.
Acknowledgments
IHS Markit wishes to gratefully acknowledge the contributions of the many client software
testers in preparing the Kingdom® software. The enthusiastic Beta testers, smoke testers,
amber testers and staff greatly appreciate their invaluable feedback and contributions.
Scanit Manual............................................................ 1
Overview of Scanit Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Aspects of Scanit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Working Scanit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Top Level Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
The Pattern Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
The Input Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
The Middle Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
The Output Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
The input and output files are seen on screen together with a Pattern Window above the
Input Window and a Middle Window for extraction of subsets from the original file.
Typically, users would use the Pattern Window as the means of extracting required data from
the Input Window as a subset of data to be placed in the Middle Window. This subset would
be displaying the data in a way that allowed the extraction of columns of data to be processed
and displayed in the bottom Output Window.
Selecting a portion of a string in the Input Window the program will, if required, produce the
correct pattern in the Pattern Window.
A specific ‘Open Stacking Velocities’ option is available which brings up a Step-by-Step Guide
to reformatting stacking velocities.
Once the output file has been created to the satisfaction of the user, a template of the actions
just used on screen to produce the required format can be saved for future use.
Note: The usage of Scanit may be best explained by use of examples; at the back of this
document there are a number of examples of different types of input files designed to
show all the different aspects of the Program. Go Here.
Aspects of Scanit
How Scanit deals with large data files
The user has the opportunity to select how many lines of the data file will be displayed
in the Scanit Process Windows using the Display Lines drop down menu. This is
particularly useful when dealing with very large input data files.
However; Scanit will always process the entire Input file when running through a
reformatting pattern, regardless of what the Display Lines is set to.
A default value of 10,000 lines is already set. If the user changes this value to the
Maximum Display of all Lines and this maximum is too large for the program’s
memory to be read in then an Alert Message will pop-up and the program will change
back to the default value.
Note that due to the Pattern used in the Pattern Window the Middle Window may
display far fewer lines than on the input file; for example only one in every 20 line of
the input file will actually be selected to be displayed in the Middle Window, so the
display in this window may look considerably smaller than the input file. Like wise if
data fields in rows have been unwrapped into columns then the output file may be
much larger than the input file.
Mouse Movement
The mouse works in ‘instant feedback’ mode which is that when your finger is
removed from the mouse button whatever action has been selected will be done with
out the necessity for a ‘Do It’ button.
Auto-Field Expansion
Auto-Field Expansion is an automatic process within Scanit and can not be switched off.
Given a selection of a number of rows to extract, the Auto-Field Expansion feature will check
the columns immediately to the left and right of the selection to see if these fields are blank or
not. If Scanit reads a non-blank field an Alert will pop up allowing the user to expand the
selection or not.
This may occur within the data when the user has selected the width of a three-figure shot
point for example without realizing that the shotpoint increases to four figures as shown in the
example above. In this case pressing ‘Yes’ to the Expand Selection alert will expand the
selection by one row to the left. Because in this example the column to the right of the
selection is blank then no alert and no change will occur to the right of the selection.
If the field then expands again into a fifth column to the left then the alert message will come
up again.
The final column width selection that Scanit has processed will be highlighted in color in the
Input Window for user reference.
Of course it may be that you are intending to select an inner portion of a string and do not
want your selection expanded; in which case you would press ‘No’ and the process would
proceed as originally selected.
Note: The Alert may well pop up twice; once for the left non-blank detection and once for the
right non-blank detection.
Templates
Every procedure that is run on the open data file is stored so that when you are happy with
the procedures used you can save them as a template to run again on the data file at a later
date.
Note: There are no Generic Templates provided with Scanit since each template is usually
unique to the data file it has been created for.
When you save a template using the File -> Save -> Template option it will prompt you for the
name of your template file; this will default to being the same name as the data file associated
with it.
If you exit Scanit without saving a template it will NOT prompt you to save one.
Note: The template ‘Run’ icon will be greyed-out when you have started manually using
Scanit to edit data files; because once you have done some manual processes on the
data you can not then run the template associated with the file; you would need to re-
load the data file, load and run the template.
Pause
Using the Pause button will pause the running of the template after each line to allow you to
see what has happened to the data file before moving on to the next procedure.
To run the template in pause mode, select Pause before selecting the Run Template option;
then on selecting Run an Alert will come up after each process for the user to select Yes or
No to continue.
Working Scanit
Top Menu Bar
File Menu
Open - Opens the Input file to be reformatted, or opens a pre-defined Template to be
viewed in the Input Window or any other text file you wish to open in your Input
Window.
Note: Opening a template file or ‘any’ text file in the Input Window will give you the
opportunity to view the file but you will not be able to edit it; although if appropriate the
file can be reformatted using the processes available to you within Scanit.
Open SV - Open a Stacking Velocities file for data re-formatting - this provides and
On-line Step-by-Step Help to guide you through importing stacking velocities into the
right format to be read into VelPAK.
Save - Output File or Template that has been created while producing the required
output file.
Exit - Exits the program.
Format
Font - Allows the selection of different font for all the displays. This can be of use, for
example, to select a narrow font if the file has many columns and fields making it very
wide. The fonts that are available are dependent on what fonts are available on the
PC you are working on.
Utilities
Run Template - Allows the opening up and running of Templates already defined by
the user to be run on the Input file. Note there are no Pre-defined Templates supplied
with Scanit
Delimiter - Will set the Input File columns to be in alignment by choosing the delimiter
from the choice in the pull down list; Space, Comma, Semicolon, Tab or enter your
own delimiter which can be any length and character type.
The process will then analyze the data for the maximum width of any field and
produce columns that align.
Note: Whatever is selected to be the delimiter will be removed and replaced by a space.
Missing Field Replacement - Delimited data can have missing data fields. Within
Scanit these fields need to have something within them. Selecting this option will fill
missing data fields with the selected choice from the pull down list; Null, Missing,
INDT, 0, -1, -999.25 - or enter your own string.
For example a text file with values separated by commas but with some fields missing
such as:
TEXT,,123,OTHER
TEXT,NEW,123,OTHER
TEXT,NEW,,OTHER
When delimited by commas would come out as:
unless a ‘missing’ value is placed where no real value exists, for example ‘INDT’ from
the drop down list to align the correct columns:
Help
Online Help - opens the on-line help system.
About - displays the version number.
First Bank
New Open Open Save Save Delimit Display Lines Run Pause Undo
Stacking Template Template
Velocities
Data
New - Clears all data.
Open - Open text file for formatting. See also Open SV below also. This option can
also be used to load stacking velocities although no step-by-step help will pop-up.
Open SV - Open a Stacking Velocities file for data re-formatting - this provides and
On-line Step-by-Step Help to guide you through importing stacking velocities into the
right format to be read into VelPAK.
Save - Save output to text file.
Save Template - Save as Template. This will save all actions currently run within the
Pattern Window and Middle Window subsetting extraction procedures as a template.
Go Here for further details of the templates.
Delimit - make columns on input data. Go Here for details.
Display Lines - Choose the number of lines you wish to display in the windows. If this
is set to ‘Max’ and the selection is too great for the memory of the program then an
Alert Message will pop-up and the program will change back to the default value.
Note: Scanit will always process the entire Input file when running through a reformatting
pattern, regardless of what the Display Lines is set to.
Run Template - Run template (*.tem). (This will be greyed-out if you have already run
some manual processes on your data.
Pause Template - set pause mode to run a template.
Undo - undo output operation in Output Window. This will allow up to 5 undos to
occur.
Second Bank
Action Buttons associated with the Pattern Window the data. Go Here for details for
the Pattern Window.
Third Bank
Accept
All Middle Rule Lines Columns
All Input- Accept all text from the Input Window and put it in exactly the same form
into the Middle Window for selection of the data to be processed.
All Middle - Accept all text from the Middle Window and put it in exactly the same
form into the Output Window.
Highlight - Highlight text in the Input Window after selection is made in the Middle
Window. This is useful as a check that the data that has been extracted is what was
meant to be extracted and that all occurrences of that item have been included in the
Output file. Go Here for full details.
Rule Lines - A simple visual aid to help determine the exact columns requiring
definition in the Pattern Window. Using the Rule Lines option will give you lines drawn
within the Input Window into the Pattern Window. This will enable you to see at a
glance which columns within the Pattern window you need to define for which
columns of data within the Input Window.
Clicking on any area of the Pattern Window or any part of the Input Window where
there is data will display the lines. Turning off the ‘Rule Lines’ option will clear all lines
previously drawn.
Undo - (Do not confuse with the Undo button within the first bank of icons.) Will undo
the last operation in the Output window. This undo will undo processes that have
been done on the Output window, for example a Math process, Columns or Fill
Columns - Make columns in Output Window. If data has arrived in the Output
Window and the columns are a mixture of left and right justification, for example, then
this would align the columns and left-justify them.
Fill - Fill any blanks within a selected column in the Output Window with underscores.
For example:
34 8 999 34_8_999
Well Well_129
1290 0
Highlight the column required to be filled by selecting the width of a value within the
column.
Note: Fill should only be done as final option of a Scanit run; adding a new column to the
output file once Fill has been run on a previous column will return the previous column
back to its real values as extracted from the Input file.
Further Tools
Select/Click on icons to the left of the input value slots to activate the tool.
Unwrap - Used in the Middle Window to unwrap the selection in the Middle Window
to columns. Go Here for more details.
Math Function - Used to run mathematical and other types of functions on
highlighted column in Output Window. Click on the Math Function icon, enter the
Function and the value to be applied (if appropriate), and then highlight the column in
the Output Window on which it is to be applied. Go Here for details of the Math
function.
Find Text - Used to find an alphanumeric text string in the Input Window. Enter the
string and click on the search icon to the left to activate the tool.
Note: Note there is no ‘Undo’ facility on columns that have had a Math function run on them.
Note: Also note that a Math function should only be done as final option of a Scanit run;
adding a new column to the output file once a Math function has been run on a
previous column will return the previous column back to its real values as extracted
from the Input file.
The Pattern Window at the top of the Scanit screen is used to set the criteria from which the
subsets will be produced in the Middle Window. It is column dependent and takes the form of
a color key. However, exact text can also be used within the Pattern Window to extract an
exact match of the text from the Input Window to be processed into the Middle Window.
Note: Clear Pattern is used to clear some or all of the patterns set up within the Pattern
Window.
Every line that matches the ENTIRE pattern as painted in the Pattern Window will come out
in the Middle Window.
The user can select items from the Input Window itself which will give an absolute value in
the Pattern (see Short Example 1 below) or can use the Action buttons at the top to extract
columns of various data information types from the data file (see Short Example 2 below).
The user is assisted in producing a valid pattern by the ‘Choose How to Use’ option which
pops up on selection of a string in the Input window; allowing the user to choose whether the
selected string is to used as an exact string or as a pattern.
Short Example 1 - All Surveys beginning ‘HOR123’ - selection of the six character
string ‘HOR123’ in the Input Window will cause it to appear in the Pattern window in
the same column; the program will then display in the Middle Window all rows of data
from the input file that start with the characters ‘HOR123’.
Short Example 2 - Selecting the Action Button Numbers ‘0-9’ and then selecting the
relevant columns within the Pattern window (not the Input Window) will extract all
rows in the data file where there are numbers (and only numbers) in these positions.
A range of Actions can be set in the Pattern; to take the above two examples; if both
Actions were put in the Pattern together this would imply ‘Extract from the data file
and place in the Middle Window only those rows of data that start with ‘HOR123’ and
have four number in the designated, set columns’. [Note that in this case the Middle
Window would turn up a blank since these conditions do not occur together.]
Action Buttons
Relate to what type of character you want to use to extract the row of data.
(A-Z) - Upper Case Alphabetical characters are to fall in the designated column.
Letter or Digit - Any Alphanumerical character can fall in the designated columns.
(a-z) - Lower Case Alphabetical characters are to fall in the designated columns.
Punctuation - Punctuation marks are to fall in the designated columns. Go Here for a
detailed list of what is included as punctuation.
Clear Pattern - will clear selected portions of the Pattern line. Select Clear and then
highlight the designated columns of the Pattern.
Non Blank - Will select any thing as long as it is not Blank. That is; if character is not
equal to white space. Go Here for a more technical definition.
Any Number - Ignores spaces in the defined field; remaining characters must be
numerical. Designed to capture 10^^ (where ^ is a space) in the same column as 100^
and 1000 it will equally well allow 1^^2 to be passed as a valid numerical column. his
can therefore be a usual option to be able to span a number of fields for selection. Go
Here for a more technical definition.
Punctuation
The following symbols are categorized as punctuation for Scanit. Valid punctuation marks are
members of the following categories in “Unicode Category”:
Connector Punctuation - the character is a connector punctuation, which connects
two characters.
Dash Punctuation - the character is a dash or a hyphen.
Open Punctuation - the character is the opening character of one of the paired
punctuation marks, such as parentheses, square brackets, and braces.
Close Punctuation - the character is the closing character of one of the paired
punctuation marks, such as parentheses, square brackets, and braces.
Initial Quote Punctuation - the character is an opening or initial quotation mark.
Final Quote Punctuation - the character is a closing or final quotation mark.
Other Punctuation - the character is a punctuation that is not a connector
punctuation, a dash punctuation, an open punctuation, a close punctuation, an initial
quote punctuation, or a final quote punctuation.
To assist the user as much as possible in the production of a correct pattern in the Pattern
Window, highlighting columns in the Input window for selection will cause the Alert message
above to pop up.
This shows the user what selection has been made (in the example above 2641) and then
asks to choose between using the selected data as an Exact Character String or as a
Character Type -in this case numbers 0-9 - to appear in the Pattern Window:
All rows which have a number 0-9 Only rows which have ‘2641’
within these 4 defined columns will in these columns will pass
pass through to the Middle Window: through to the Middle Window:
Whatever the user decides the selection pattern (or exact string)
will be placed in the Pattern Window as shown
On selecting ‘Yes’ to the alert the items will pass into the Output Window.
Note: Be wary of spaces or blanks being used instead of zeros within Lat/Long fields
(usually) - selection of this column via a whole field Numerical extraction will ignore
lines with the blank space in.
Fields Skip
Set Unwrap Icon Button to activate this option for selection of data in the
Middle Window.
Used on row orientated data, Unwrap allows the user to select a number of fields
within a row in the Middle Window and unwrap them into single column sets in the
Output Window.
Fields - Set the number of fields to keep within the unwrap. Default is 2 for a pair of
values.
Skip - Set a number of fields to skip between selection of the fields; default is zero.
A typical example of this would be to turn a number of pairs of time-velocity values all
on one row in the input file into singular columns of time-velocity pairs, as shown in
the example below:
Highlight
The Highlight Button set to on will show you what data from the Input file has been
selected for output. This acts as a QC tool for you to scroll through the Input Window
and check that the item that has been extracted is what was meant to be extracted
and that all occurrences of that item have been included in the Output file.
In the example shown below the line name and shot point string has been extracted in
the Middle Window and listed in the Output Window. The string that has been
selected is shown in color in the Input Window.
Columns Fill
Columns
Make columns in Output Window. If data has arrived in the Output Window and the
columns are a mixture of left and right justification, for example, then this would align
the columns and left-justify them.
Fill
Fill any blanks within a selected column in the Output Window with underscores.
For example:
34 8 999 34_8_999
Well Well_129
1290 0
Select the Fill option icon so it has turned orange, and highlight the column required to
be filled by selecting the width of a value within the column.
Note: Fill should only be done as final option of a Scanit run; adding a new column to the
output file once Fill has been run on a previous column will return the previous column
back to its real values as extracted from the Input file.
Math Function
Used to run mathematical and processing function on highlighted column in Output
Window.
Note: Note there is no ‘Undo’ facility on columns that have had ‘Math’ run on them.
Note: Also note that Math should only be done as final option of a Scanit run; adding a new
column to the output file once Math has been run on a previous column will return the
previous column back to its real values as extracted from the Input file.
Select the process from the Math drop down box and the variable in the right hand of
the two Math input controls and make sure the Math icon to the right of the controls is
highlighted.
Once the Math icon is highlighted you will need to select the column you want the
Math to be run on. If you do not select the whole width of the field for that column of
data an alert will come up to warn you and expand the selection width, exactly in the
same way as the Auto-Field Expansion.
+,-,*,/ - add, subtract, multiply, divide.
Pow - Returns a specified number raised to the specified power.
Exp - Returns e raised to the specified power.
Abs - Returns the absolute value of a double-precision floating-point number.
Floor - Returns the largest integer less than or equal to the specified number.
Ceiling - Returns the smallest integer greater than or equal to the specified number.
Truncate - Calculates the integral part of a number.
Max - Returns the larger of two double-precision floating-point numbers.
Min - Returns the smaller of two double-precision floating-point numbers.
Sqrt - Returns the square root of a specified number.
Rem - Returns the remainder resulting from the division of a specified number by
another specified number.
Log - Returns the logarithm of a specified number.
Log10 - Returns the base 10 logarithm of a specified number.
Diff - The difference between one value in a selected column and the next one.
GreaterThanDelete - If the column number is greater than the Variable entered in the
field then the entire row is deleted from the Output Window.
LessThanDelete - If the column number is less than the Variable entered in the field
then the entire row is deleted from the Output Window.
NumericalEqualsDelete - If the column number is mathematically equal to the
Variable entered in the field then the entire row is deleted from the Output Window.
LINE - Line Name or - for 3D data - the Inline of the seismic survey. Note that for 3D
data the Survey can and should be added to the Inline during the Input into VelPAK
process.
SP/CDP - Shot point, CDP or cross line number.
TIME - Time of stack velocity pick in milliseconds.
VELOCITY – Stacking velocity pick, in project depth units per second.
Note: VelPAK does not deal with Latitude and Longitudes. If these are in your original data
file they will be ignored.
X Y Z
X Y Z SEGMENT_NUMBER
X - X co-ordinate.
Y - Y co-ordinate.
Z - Z depth (not used on input - use 0).
SEGMENT_NUMBER - A number that denotes a single segment; a change of number
denotes a new segment.
X Y Z SEGMENT_NUMBER
X - X co-ordinate.
Y - Y co-ordinate.
Z - Z depth (not used on input - use 0).
SEGMENT_NUMBER - A number that denotes a single segment; a change of number
denotes a new segment.
Note: This option will only accept ‘Unix’ CPS1 Binary formats (not ‘PC’ based). This option
will accept grids previously output from software packages Velit and Cubit.
WELLNAME X Y
WELLNAME TOPNAME Z
Note: If the file is a Deviation file then the Time slots must be INDT and not zero values.
In this example we want to extract the line name, cdp, time - velocity pairings and X and Y
value from each line within the data file. In this respect it is an easy example to start with
since there will be no use of the Pattern Window to extract certain rows and ignore certain
rows in the input file.
4. Press the ‘All Input’ button at the top of the Scanit window.
This has made the entire file be selected into the Middle Window, from which the field
selections can take place.
This is because the program has noticed a ‘non-blank’ to the right of the selection; in
this case the decimal point to the right of the Line Name. It is asking whether you wish
to expand your highlighted selection to include this value. In this case you do not want
to (although in general it is a useful tool if you have inadvertently selected a field width
thinner than the maximum value which may occur further down the file - out of view).
7. Press No to the Alert.
The first field will be displayed in the Output Window and if ‘Highlight’ is selected (its
default value) at the top of the Scanit screen, then the values that have been selected
from the Middle and Top Windows will be highlighted, for reference (Figure 6).
Note: The Line Name at the moment is made up of Survey Name and the In-line (or cross-
line) number; separated by a blank. We will want to use the ‘Fill’ option to join these
two fields with an underscore to make them one - but this can not be done until you
have finished processing the file at the end since any Fill option will immediately be
undone when selecting the next field for Output.
The Output data file is more or less complete now in the format we require; the only thing to
do, as mentioned earlier, is to join the Survey Name and the Line Name up with an
‘underscore’ using the Fill option. As with the ‘Math’ function, the Fill option must be run on
the final Output file; no further selections from the Middle Window can be processed
otherwise the ‘Fill’ or the ‘Math’ processes will be undone.
13. Select the Fill option at the top of the Scanit window so that the icon becomes orange
(Figure 9).
14. In the Output Window select the text string within which you wish to fill any blanks with
underscores. In this case it is the text string of the Survey and Line Name - ‘V2WA_G
2641.
The process will complete and the blank will be filled with an underscore (Figure 10).
The Output file is now correctly re-formatted. We now need to save it since we need to use
this file to extract Navigation data for the Lines.
15. Save the file as Example1_output.dat.
16. Save the template as Example1.tem you have created by selecting the File ->Save ->
Template option at the top of the Scanit window. This will allow you to run the procedures
you have just done manually automatically on this data file in the future.
Have a quick scan through the file yourself to see if you can see what can be used....
In fact it would appear that the only unique identifier is the ‘0’ that occurs as the first
Time-Velocity pairing for each new Line in the data file so we will utilize this ‘0’ to
extract the information we require.
4. In the Input Window select the individual column with the ‘0’ in for the top line of the data
file.
An alert pops up (Figure 13).
This is asking you whether you want to treat the selection of ‘0’ as an exact string or
whether you want the pattern - in this case numbers 0-9 - to appear in the Pattern
Window.
5. In this case we want the exact string, so select the radio button ‘Use Exact Character’.
The ‘0’ falls into the Pattern Window at the top implying that all rows containing a ‘0’ in
this column will be extracted and placed into the Middle Window. Instead of using a
Pattern Color Key (such as ‘any number (0-9)’ or ‘any lower case letter (a-z)’ to
extract a value in a particular column) Choosing to Use the ‘0’ from the Input Window
has ‘hardcoded’ the value ‘0’ into the Pattern Window for extraction.
Looking at the Middle Window, this is exactly what has happened (Figure 14).
The size of the data in the Middle Window has been reduced dramatically since only
one row per CDP is now being displayed.
6. Scroll through the Middle Window to check that the extraction procedure has occurred as
you expect.
The Middle Window display now contains a Line Name, Shot Point, One Time-
Velocity pair and the X/Y value for the Shot Point.
It is now just a straightforward task of extracting all the fields you require to make a
Navigation input file - which will be all the fields listed except for the Time-Velocity pair
- making sure they are in the correct column delineated field format for easy reading
into your package.; in this case the order is the same as the original (excluding the
Time-Velocity pair).
Note: At all times in the following manoeuvre a Confirmation Selection alert will come up on
selecting the data item in the middle window. If you are happy that you have selected
the correct data say ‘Yes’ to the Confirm Selection these alerts
7. From the Middle Window, select the column with the Line Name ‘V2WA_G-2641’.
8. From the Middle Window, select the column with the CDP in ‘7900’.
9. From the Middle Window, select the columns with the X/Y values in ‘5321990 202379’
The output from those three actions will be in the Output Window (Figure 15).
At the moment, the text file (Figure 16) is showing a line of information containing the Line
Name and Shot Point and XY locations followed by pairings of Times and Velocities in
columns that would need to be ‘unwrapped’ to be able to be read in to VelPAK.
Therefore:
Note: If you wanted to use the Open Stacking Velocity file option you can do here; the Open
SV option will bring up a Step-by-Step guide for processing the velocities into a format
required by VelPAK.
3. Move to the directory where the example data would be and select it so that the data file
falls into the Input Window of Scanit (Figure 17).
The program will pause as it sorts the data and then present the sorted lines in the
Middle Window (Figure 19).
6. Highlight the Line Name in the Middle Window by dragging the cursor across it.
An action like this in the Middle Window is telling the program to drop the highlighted
columns into to the Output Window.
7. Say ‘Yes’ to the Confirm Selection alert if you are happy that you have selected the
correct data.
In this case the Line Name will fall into the first available set of columns in the Output
Window which here are the first columns in the Output Window (Figure 20).
8. Scroll through each window to check that what you think you have selected has actually
been selected - especially if the Line Name (or shot point in later examples) becomes
wider further down the data file.
Note: The Input Window is only showing information down to line HOR123-1041 whereas
the Middle Window and Output Window goes down to HOR123-1457. A look at the
file in a standard text editor shows that the final line number in the file is actually
HOR123-1729. Don’t Panic! This is simply a display feature in that Scanit will only
display the number of lines selected from the ‘Display Lines’ drop down at the top of
the Scanit window, which defaults to 10,000. Because the input data file has other
lines within it which do not contain the Line Name scrolling to the bottom of the data in
the Input Window will take you 10,000 lines down the data file but the actual Line
Name it will find is considerably less than the Line Name reached by the 10,000th line
in the Middle and Output Window where the other lines in the data file (containing the
Time-Velocity pairs) are currently being ignored.
Scanit will always process the entire Input file when running through a reformatting
pattern, regardless of what the Display Lines is set to.
10. With the cursor, highlight the shot point column in the Middle Window.
11. Say ‘Yes’ to the Confirm Selection alert if you are happy that you have selected the
correct data.
The program will work through and come out with the column of shot points next to
the Line Name - space delineated - in the Output Window (Figure 22).
Shot Point
Highlighted
(QC)
Notice also that the shot point has been highlighted in color in the Input Window;
showing you exactly what has been captured.
This will clear the entire Pattern Window allowing you to select a new pattern to
unwrap the data.
13. Look at the first line of Time-Velocity information in the Input Window for Shot Point 1001
of Line HOR123-1001 (Figure 24).
We want to be able to extract the Time-Velocity pairing lines within the input data file
of which the first reads 0 1525 100 1531 etc. So within the Pattern we would highlight
a set of columns where the numbers fell.
This is different method of selection from the way we have selected the Line Name
where we selected an exact string of Letters and Numbers (in this case HOR-123)
and the Shot Point from the ‘Choose How to Use’ alert.
Note: There are a number of ways that these data columns can be extracted; this is just one
way.
14. In the Input window select the value ‘1953’ from the column on the right.
15. The ‘Choose How to Use’ alert will pop up. This time we want the Character Type to be
used instead of an exact string. In this case it is 4 columns of ‘any’ number we wish to
extract, so select the default radio button of ‘Use Character Type’ (Figure 25).
You will see in the Middle Window we now just have the Time-Velocity pairings on
display.
Select the Unwrap Action Button by clicking on the Icon (Figure 26). The default of ‘2’
in the first unwrap window refers to the number of fields to keep within the unwrap.
Default is 2 for a pair of values. The zero in the second unwrap window refers to how
many fields to skip between selection of the fields.
In this case both defaults are exactly what we need - “take two fields and leave them
as a pair and unwrap them and do not skip or ignore any other fields” - so we can
leave them at the default.
16. Highlight the first row of four pairs of Time-Velocity values by dragging the cursor across
the whole line (Figure 27). Make sure you select the width of columns required for larger
values further down the file (although the program will warn you if it comes across a non-
blank value next to a selected column).
17. Say ‘Yes’ to the Confirm Selection alert if you are happy that you have selected the
correct data and check that the ‘Unwrap status’ is currently set to ‘True’.
The program will extract the pairs and present them in the Output Window.
Notice that whereas before you had unwrapped the fields the Line Name and Shot
Points moved up row by row in the Output field (Figure 22), the unwrapping of these
values - of which there are a number of Time-Velocity pairs all assigned to the one
shot point value, has amended the Output Window display so that there are a number
of rows with the same line name and shot point each with one of the unwrapped Time-
Velocity pair. This is as we wish and a feature of Scanit that it will re-run all the Pattern
Window processes each time a new action is requested.
The final output file displayed here is what we require to read into VelPAK.
18. Save the file as Example2_Output.dat.
19. Save the template as Example2.tem you have created by selecting the File ->Save ->
Template option at the top of the Scanit window. This will allow you to run the procedures
you have just done manually automatically on this data file in the future.
20. Use the File Save File drop down at the top of the Scanit page to save the file to read it
into VelPAK.
2. We want to extract the seventh column which starts with the value 26.17278. This file
appears to be right-justified.
3. Use the Scroll bar for the Input Window to scroll down the file a bit to see the mix of
numbers, negative, positive and indeterminate that there are in this column and how the
width varies from the first number in the column.
4. Select the data to be sub-set and processed into the Middle Window. There are many
ways this could be done; here is just one method:
Since all the lines which contain the column of numbers we want to extract also have
‘Galleon’ in a column to the right we can select this as an absolute value to be put in
the Pattern Window.
5. Highlight the word ‘Galleon’ in the Input Window (Figure 30).
The ‘Choose How to Use’ alert will pop up.
In this case choosing either for Galleon to be an exact string or a pattern will produce
the same result, so choose either!
You will get a listing of all the data in the Middle Window minus the header which does
not have Galleon or a lower case character pattern in the selected columns.
Now from the Middle Window you want to select the column of data to be extracted.
6. In this case, highlight the 26.17278 value that occurs in the first row of the Middle Window
(Figure 31).
7. Say ‘Yes’ to the Confirm Selection alert if you are happy that you have selected the
correct data.
8. A further Alert will come up and you will see the value -7.580981 being highlighted in
yellow (Figure 32).
The program checks firstly to the left of each row of the selected columns (and then to
the right) to see if there are non-blanks in the adjacent columns. In this case it as
found a ‘-’ which occurs one column to the left of the selection and so the alert has
popped up.
9. Press Yes on the Alert to Expand Selection.
The selected data width will be expanded by one column to the left and the program
will move on. It has also scanned to the right of the selected columns but since no
non-blanks were found the program moved on to the next row.
The program halts again since it has found another non-blank to the left (Figure 33).
The program has found a further non-blank column to the left as before - but this time
because the Display Lines option at the top of the Scanit screen is only set to show
the first 10,000 lines (it’s default value) it can not show you the value that needs
attention.
In this case you have no means of knowing whether it is correct to press ‘Yes’ other
than past alerts on this data file show that the data values columns are moving out to
the left, so it is likely that this is correct to press ‘Yes’.
12. Press Yes to the Alert.
Note: If you think you want to see all the data before deciding ‘Yes’, you will need to let the
process finish running and then ‘Undo’ the process using the Undo icon at the top of
the Scanit window. Then select from the Display Lines drop down selector the option
‘Max’ to display all the lines in the data file. You will then need to run the whole set of
processes again as described in this example. When you reach this point again the
value it has found will be shown and a judgment can be made.
The final selection will appear in the Output Window. A scroll through it will show the
different widths of the values within the column (Figure 35), but which have all been
accounted for due to the Auto-Field Expansion process.
The column of numbers are currently right-justified in the way they appear in the
original data file. To make the column ‘left-justified’:
13. Select the ‘Columns’ icon at the top of the Scanit window (Figure 36). This will reformat all
columns in the Output Window (in this example only one) to line be left justified and to
line-up.
LINE - Line Name or - for 3D data - the Inline of the seismic survey. Note that for
3D data the Survey can and should be added to the Inline during the Input into
VelPAK process.
SP/CDP - Shot point, CDP or cross line number.
TIME - Time of stack velocity pick in milliseconds.
VELOCITY - Stacking velocity pick, in project depth units per second.
Scanit can take any format of Ascii Stacking Velocity file and extract the four fields required
for input into VelPAK.
Overview
Scanit has four labelled windows; Pattern Input, Middle and Output.
• Use the Pattern Window as the means of extracting required data from the Input Window
to be a subset of data in the Middle Window.
• ‘Paint’ unique identifiers in the Pattern window that relate only to columns in the Input
window that have the required information (Line Name or SP/CDP or Time or Velocity in
them).
• The extracted subset in the Middle window is displayed in a way that allowed the
extraction of columns of data to be processed and displayed in the bottom Output
Window.
• You must select the information from the Middle window in the correct order such that the
columns of data that will fall in to the Output window will be in the correct order for reading
into VelPAK so in the case of Stacking Velocities you will be subsetting the Line Name
first.
• Selecting data from the Input Window or by using the Pattern will change the subset
display in the Middle Window without making any change to the Input or Output files.
• This gives the user a chance to test certain patterns extracted from the Input window into
the Middle window using the Pattern window without corrupting the Input or Output file.
Load Data
• Load your Stacking Velocity data file into the Input window from the standard File Selector
that has popped up.
_________________________________________________________________________
• Look at the data file you have loaded into the Input window and make sure you are
familiar with which parts of the file make up these four required fields in the output file.
Before you begin extracting and subsetting data from the Input window you may need to do
some pre-processing to the file.
• If the columns are not aligned in your Input file you can use the ‘Make Columns and
Delimit’ option from the Utilities menu - this will set the Input File columns to be in
alignment by choosing the delimiter from the choice in the pull down list; Space, Comma,
Semicolon, Tab. The process will then analyze the data for the maximum width of any
field and produce columns that align.
.
• Decide whether you need to extract individual lines to be brought in to the subset in the
Middle Window or whether ALL the data in the Input window can be brought into the
Middle Window for extraction of columns.
For example, data like this below will need to have a Pattern painted in the Pattern window to
extract the Line Name ‘Hor123-1001’ from its individual line:
Line Name
But data like this below has the Line Name on every line so the whole data file can be
selected and moved into the Middle window:
Line Name
All
• If you want all the data to go from the Input Window and put it ‘as is’ into the Middle
Window for selection of the data to be processed press the All Input button.
• When the data has moved into the Middle Window move to Extract Lines Hint.
Pattern
Depending on what the Input Data file looks like you may find that you have to use the
Pattern window to individually extract portions of the data file, starting with the Line Name.
Selecting data that you may want to use in the Input Window will bring up the ‘Choose How to
Use’ window to assist you in choosing whether the pattern used to extract information is an
extract string or a pattern of numbers, lower case letters or punctuation, for example.
Go Here for more details of the Pattern window from the main Scanit User Guide.
Go Here for some worked examples of subsets being extracted through clever use of the
Pattern window.
Every line that matches the ENTIRE pattern as painted in the Pattern Window will come out
in the Middle Window.
• Select the text in the Input Window you want to extract in to the Middle Window.
• On the Choose How to Use alert box decide whether it is the Pattern of the text you have
chosen or the exact string. The extracted parts of the Input Window will pass into the
Middle Window.
• If you find you have not selected what you think you have selected the option ‘Clear
Pattern’ allows you to clear selected portions or all of the Pattern line if you make a
mistake.
• Likewise you may need to use the Clear Pattern to begin extracting another set of
information from the Input file to put into the Middle window.
• When the selected data has moved into the Middle Window move to Extract Lines Hint.
_________________________________________________________________________
The Line Name is the first column in the required format for input into VelPAK; therefore it is
the first element to be considered in using Scanit on the Stacking Velocity input file.
• Use All or Pattern to get the Line Name into the Middle Window
• Once in the Middle window select the Line Name using the cursor.
• The Alert that comes up will ask for confirmation as to whether you want to proceed -
check that the highlighted column is what you want to extract as the line name. Unwrap
Status should state False.
• The whole column (all the rows) will be selected and dropped into the first column of the
Output window.
• The “Auto-Field Expansion” process will check the columns immediately to the left and
right of the selection to see if these fields are blank or not. If Scanit reads a non-blank
field an Alert will pop up allowing the user to expand the selection or not.
This is a useful check in case the Line Name becomes wider further down the file -
unseen in the Middle Window unless you scroll down.
• You will see the rows and columns that have been selected will have become highlighted
in a particular color for you to check what the selection has actually selected
• If you make a mistake the Undo button on the upper bank of buttons will undo the
output operation in Output Window. (This will allow up to 5 undos to occur.)
_________________________________________________________________________
_
The Shot Point/CDP is the second column in the required format for input into VelPAK;
therefore it is the second element to be considered in using Scanit on the Stacking Velocity
input file.
• Does the Middle window NEED re-selecting to extract the SP/CDP? It may well be
that extracting the Line Name has also given you the SP/CDP values you need too, so
you do not necessarily need to clear the Pattern Window and the Middle Window to begin
the selection procedure again.
• Once the SP/CDP is in the Middle window select the column using the cursor.
• The Alert that comes up will ask for confirmation as to whether you want to proceed -
check that the highlighted column is what you want to extract as the SP/CDP. Unwrap
Status should state False.
• The whole column (all the rows) will be selected and dropped into the second column of
the Output window next to the Line Name.
• The “Auto-Field Expansion” process will check the columns immediately to the left and
right of the selection to see if these fields are blank or not. If Scanit reads a non-blank
field an Alert will pop up allowing the user to expand the selection or not.
This is a useful check in case the SP/CDP becomes wider further down the file - unseen
in the Middle Window unless you scroll down.
• You will see the rows and columns that have been selected will have become highlighted
in a particular color for you to check what the selection has actually selected.
• Data can be selected in ANY row within the Middle Window - it does not have to the be
top row; the whole column from the top line will be extracted according to the selection.
• If you make a mistake the Undo button will undo the output operation in Output
Window. (This will allow up to 5 undos to occur.)
_________________________________________________________________________
_
Time and Velocity values for the Stacking Velocity data file would tend to come in pairs in the
form Time/Velocity.
Often these Time/Velocity pairs appear as a number of pairs occurring in the same row of the
data file.
Scanit will need to UNWRAP these sets of Time/Velocity pairs
• Does your data file have Time/Velocity pairs appearing as a number of sets in the same
row?
• Yes - Go to Unwrap Required.
No - Go to No Unwrap Required
.
Example of Time/Velocity pairs needing to be ‘Unwrapped’
No Unwrap Required
• Does the Middle window NEED re-selecting to extract the Time/Velocity pairs? It
may well be that extracting the Line Name has also given you the Time/Velocity pairs you
need too, so you do not necessarily need to clear the Pattern Window and the Middle
Window to begin the selection procedure again.
• Once the Time/Velocity pairs are in the Middle window select the Time column using the
cursor.
• The Alert that comes up will ask for confirmation as to whether you want to proceed -
check that the highlighted column is what you want to extract as the Time. Unwrap Status
should state False.
• The whole column (all the rows) will be selected and dropped into the third column of the
Output window next to the SP/CDP.
• Select the Velocity value in the Middle Window. The whole column will be selected and
dropped into the fourth column of the Output window next to the Time column.
• Remember the “Auto-Field Expansion” process will check the columns immediately to the
left and right of the selection to see if these fields are blank or not. If Scanit reads a non-
blank field an Alert will pop up allowing the user to expand the selection or not.
• You may find you can select the Time/Velocity pairs in one selection. In this case the
Auto-Field Expansion will only work to the left of the furthest left selected value and
likewise for the furthest right; which means the blanks in between the two columns of
values will be ignored.
• You will see the rows and columns that have been selected will have become highlighted
in a particular color for you to check what the selection has actually selected.
• If you make a mistake the Undo button will undo the output operation in Output
Window. (This will allow up to 5 undos to occur.)
When you have the Time/Velocity pairs in the Output window sitting in the third and fourth
columns of the data file the selection procedure has finished. You should now move onto the
the any Post-process procedures which may need to be done to the file before you can
output it.
Unwrap Required
• It is possible that for the you will need to Clear the Pattern (‘Clear All’) and extract a
further subset from the Input file to put into the Middle window by using the Pattern
window.
• This may be the Exact Text of part of the Line Name, or a ‘blank’ in a particular place or a
number or an Upper Case piece of text, for example, in which case you will need to use
one of the various Action Buttons to signal that you want to extract a line where match of
the text from the Input Window to be processed into the Middle Window.
• Once in the Middle window if the Time/Velocity pairs need unwrapping activate the
Unwrap Action button by clicking on it to make it orange.
Fields Skip
• You may or may not need to change the Fields and Skip values; the default Unwrap mode
is set to the program capturing two fields and skipping none. This is the correct set up for
a file similar to the one below; you want two fields taken and unwrapped and none
skipped.
• Highlight the first row of pairs of Time-Velocity values by dragging the cursor across the
whole line. Make sure you select the width of columns required for larger values further
down the file (although the program will warn you if it comes across a non-blank value
next to a selected column to the left or right).
• The Alert that comes up will ask for confirmation as to whether you want to proceed -
check that the highlighted columns are what you want to extract as the Time/Velocity
pairs. The Unwrap status should state ‘True’.
• The program will extract the pairs and present them in the Output Window.
Notice that the unwrapping of these values - of which there are a number of Time-Velocity
pairs all assigned to the one shot point value, will have cleverly amended the Output Window
display so that there are a number of rows with the same line name and shot point each with
one of the unwrapped Time-Velocity pair. This is a feature of Scanit that it will re-run all the
Pattern Window processes each time a new action is requested.
When you have the Time/Velocity pairs in the Output window sitting in the third and fourth
columns of the data file the selection procedure has finished. You should now move onto the
the any Post-process procedures which may need to be done to the file before you can
output it.
____________________________________________________________________
• Have you selected your velocity field? (You may have been able to select the Time and
Velocity as a pairing in the last selection procedure.) If not go ahead and select it now.
You may need to manually move back to the preceding Help from the Help Index to do so.
Once you have all four fields in the Output window:
• Look at the output data and determine if you need to process/edit the file it in someway,
for example whether you need to get rid of lines with ‘-1’ in them, convert from feet to
meters, or Fill blank spaces within a Line Name.
• Go Here for Post Processing options.
• Note you can also save the TEMPLATE (using the Save Template option) to save the
moves you have made so that you can run the template on another similarly formatted
Input data file at a later date. Go Here for details.
Output
When you are happy with your data file you need to save it.
• Use the File - Save - File Option
• A File selector will come up; save the file to your selected directory.
• In VelPAK you will need to load it via the File - Import - Profile Stack option.
• Note the Prefix option at the bottom of the Line Selector - Lines within VelPAK brought in
from Kingdom are prefixed with the Survey Name. The Prefix option here will add the
Survey Name to the Line Name of your stacking velocity file. The drop down in the Prefix
slot will display all Surveys for line names currently held in the VelPAK project allowing
you to select the relevant survey name.
• You must have the Line data loaded into VelPAK (usually from Kingdom) before you can
load the Stacking Velocity file.
Post Processing
You can run a number of various post-processes on the data in the output file before saving
the data.
Math - You can run a number of functions - mathematical or otherwise - on selected columns
of data.
Press Icon
to Activate
• To get rid of any ‘-1’ values use Math - Less Than [Value] Delete where value is ‘0’.
• To change feet to meters or vice versa use the corresponding tool.
• Look at the full range of Tool options available Here.
• To run Math - select the tool (and value if applicable), press the icon to go ORANGE and
then
Fill - will fill any blanks within a selected column in the Output Window with underscores.
For example:
34 8 999 34_8_999
• Select the Fill option icon so it has turned orange, and highlight the column required to be
filled by selecting the width of a value within the column.
Columns - If the columns of data in the output window are a mixture of left and right
justification, for example, then this would align the columns and left-justify them.
• Selecting the Columns option icon so it has turned orange will automatically align all
columns in the output file.