Manual Petrogis

PetroGIS – the E&P add-in for ArcGIS www.gis-media.
com
PetroGIS
version 1.4
for ArcGIS 10
developed by: GIS-Media | Jan Burdziej
contact:
Jan Burdziej
(jan.burdziej@gis-media.com)
released on: 2012-05-18
1/47
PetroGIS – the E&P add-in for ArcGIS www.gis-media.com
Table of content
1. About PetroGIS.............................................................................................3
2. Installation...................................................................................................5
3. Tools............................................................................................................6
3.1. Import SPS / RPS...........................................................................................................7
3.2. Import SEG-P1.............................................................................................................10
3.3. Import SEG Y..............................................................................................................13
3.4. Import XPS.................................................................................................................15
3.5. Import UKOOA (P1/90).................................................................................................16
3.6. Import UKOOA (S+R)...................................................................................................20
3.7. Import UKOOA (Custom)...............................................................................................22
3.8. Batch Import UKOOA (P1/90).........................................................................................24
3.9. Export UKOOA (P1/90)..................................................................................................26
3.10. Create Bin Grid............................................................................................................28
3.11. List Line Bends.............................................................................................................29
3.12. Design 2D Survey.........................................................................................................31
3.13. Design Offsets.............................................................................................................33
3.14. Points To Lines.............................................................................................................37
3.15. Points To Polygons........................................................................................................39
3.16. DMS <-> DD Converter.................................................................................................41
3.17. Get Coordinates...........................................................................................................42
3.18. Measure Angles............................................................................................................43
3.19. About PetroGIS Tools....................................................................................................44
4. License and warranty...................................................................................46

5. References..................................................................................................47
2/47
1. About PetroGIS
PetroGIS ia a collection of GIS tools designed for E&P (e.g. seismic) data. PetroGIS is released as an Add-In for
ArcGIS Desktop 10™ software. The 10-day trial can be downloaded from our website. Check the website
for commercial license models and pricing.
GIS-Media offers a wide range of GIS services:

• a professional GIS support and consultancy focused on E&P industry,
• software development, e.g. ArcObjects extensions and tools for the ArcGIS™ environment,
• design and publication of OGC/ISO compliant web-services such as Web Map Service (WMS)
or Web Feature Service (WFS)
• designing and publication of interactive and OGC/ISO compliant geoportals.
Please do not hesitate to contact us if you need any kind of GIS assistance. Check our website for a full
list of services.
Feel free to report bugs and submit comments and feature requests.
Main features:
• import SPS (both rev. 0 and rev. 2.1), SEG-P1, UKOOA P1-90 and SEG Y files directly to your
ArcGIS project,
• batch import UKOOA P1-90 files (as point or lines, as SSDM TrackLines),
• export to UKOOA text files,
• convert seismic points into lines (support for one- and two-field sorting, e.g. Line and Station,
support for M-aware),
• convert survey / block coordinates into polygons,
• create bin grids (using UKOOA standard parameters, such as bin size, grid orientation),
• perform seismic survey preplanning / offset design (move theoretic source / receiver points
perpendicularily to the preplanned line layout),
• design 2D seismic survey – create points and lines with custom intervals, spread lengths,
station numbers (convert your sketch lines into valid seismic profiles),
• list profile's vertices and bands (export to clipboard or save to point feature class)
• easily retrieve X/Y coordinates from your map (support for snapping, copy to clipboard etc.),
• easily measure angles and distances (support for snapping).
3/47
Technical notes:
– All input and output feature classes are assumed to have the same coordinate system as the
active data frame. Thus, make sure that e.g. while importing UKOOA / SPS files, the input
coordinates (those in the UKOOA / SPS text file) matches the active data frame coordinate
system.
– For most tools it is recommended to use Projected Coordinates Systems instead of Geographic
Coordinate Systems.
– ArcGIS 10™ and .Net Framework 4 or higher are required for the PetroGIS to work properly.
4/47
2. Installation
The PetroGIS is distributed as a sigle file "PetroGIS_x.x.esriAddIn". You can install it by double-clicking in
Windows Explorer. When double-clicked, the ESRI supplied Add-In Installation Utility validates the add-in
and copies it to the appropriate well-known folder.
1. Double-click the following file:

2. Click "Install Add-In":
3. Click "OK":
PetroGIS add-in can also be installed manually, using the "Add from file" button on the Customize dialog
box available in all ArcGIS Desktop 10™ applications.
To uninstall the PetroGIS add-in, click Customize menu -> Add-In Manager -> select PetroGIS -> click
Delete this Add-In.
5/47
3. Tools
PetroGIS add-in installs the following toolbar, menus and tools:
The following tools are available in the current release:
Import Menu Survey Design Menu
Import SPS / RPS Create Bin Grid

Import SEG-P1 List Line Bends
Import SEG Y Design 2D Survey
Import XPS Design Offsets
Import UKOOA (P1/90)
Import UKOOA (S+R) Other Tools
Import UKOOA (Custom)
Points To Lines
Batch Import UKOOA (P1/90)
Points To Polygons
DMS <-> DD Converter
Export Menu Get Coordinates
Export UKOOA (P1/90) Measure Angles
About PetroGIS Tools
6/47
3.1. Import SPS / RPS
Description
This tool allows to import SPS / RPS files. See the SEG SPS rev. 0 (1993) and SEG SPS rev. 2.1 (2006)
for further details on input file format.
Graphical User Interface
Usage
1. Input. Path of the selected input SPS / RPS file. Click the folder icon to load a valid SPS / RPS file
you want to import into point feature class.
2. SPS / RPS summary. The Number of Points in the input file. Only rows starting with "S" (for
shot points) or "R" (for receiver points) will be counted. Type of Points: "SPS" for shot points or
"R" for receiver points. It is assumed that all points in the file are of the same type.
3. Options. SPS rev. 0 / SPS rev. 2.1. Choose the type of your input file.
4. Add and calculate date / time field. Check to add an additional field to the output attribute
table. This will be a date field calculated based on Julian day (day of the year) as specified in the
input file (columns ).
5. Year. Specify a year (e.g. 2011) to be used in date calculation. Grayed out if Add and calculate
7/47
date / time field is not checked. Note that if your SPS data was recorded during several years,
you will have to adjust the year after import.
6. Output. Path for the output feature class. Click the folder icon to select a valid output feature
class. This can be a feature class in a geodatabase (File or Personal) or a shapefile.
7. Add output to map. Check to automatically add the output file to the active data frame in your
ArcMap session. The output feature class will use the coordinate system from the active data
frame.
POINT RECORD SPECIFICATION (example for SPS rev. 0)

This record type contains details at the position of the shotpoint at the time of recording or at the position
of a receiver at the time of first shotpoint recorded into the receiver.
Item Definition of field Cols Format Min. to Max Default Units Field Name Field Type
1 Record identification 1-1 A1 "R" or "S" None - RecordID String
2 Line name (left adj) 2-17 4A4 Free None - LineName String
3 Point number (right adj) 18-25 2A4 Free None - PointNum Double
4 Point index 26-26 I1 1-9 1 - PointID Integer
5 Point code * 27-28 A2 see below None - PointCode String
6 Static correction 29-32 I4 -999 - 999 Blank Msec StaticCor Integer
7 Point Depth 33-36 F4.1 0 - 99.9 None Metre PointDepth Double
8 Seismic datum 37-40 I4 -999 - 9999 None Metre SeisDatum Integer
9 Uphole time 41-42 I2 0 - 99 Blank Msec UpholeTime Integer
10 Water depth 43-46 F4.1 # 0 to 99.9/999 Blank Metre WaterDepth Double
11 Map grid easting 47-55 F9.1 None - Easting Double
12 Map grid northing 56-65 F10.1 None - Northing Double
13 Surface Elevation 66-71 F6.1 -999.9- 9999.9 None Metre SurElev Double
14 Day of year 72-74 I3 1-999 None - DayOfYear Integer
15 Time hhmmss 75-80 3I2 000000-235959 None - TimeHHMMSS String
_Date Date **
# Water depth should be read in as F5.1 to allow for 4 character decimal and integer values.
* Example Point codes :
"PM" - permanent marker, "KL" - kill or omit point
"G1".."G9" "H1".."H9", "R1".."R9" - receiver codes
8/47
"V1".."V9" "E1".."E9", "A1".."A9","W1".."W9",

"S1".."S9". - source codes
** An additional optional field for storing exact date value. It is calculated based on: 1) year (specified on
the tool interface), 2) day of year (taken from column 14) and 3) time (taken from column 15).
Note: Grey columns indicate field names and field types of the output attribute table.
Source (modified): SEG SPS rev 0 (1995), SEG Technical Standards Committee on Ancillary Data
Formats, Shell Processing Support Format for Land 3-D Surveys, Geophysics, 60, no. 2, 596-610.
http://www.seg.org/documents/10161/77915/seg_sps_rev0.pdf
9/47
3.2. Import SEG-P1
Description
This tool allows to import SEG-P1 files. See below for the SEG-P1 (1983) standard for detailed description
of the required input file schema.
Usage
1. Input. Path of the selected input input SEG-P1 file. Click the folder icon to select a valid SEG P-1
file you want to import into point feature class.
2. SEG-P1 Preview. This will list first 20 rows of the SEG P-1 file, which should contain header
information. See SEG-P1 file schema for details. The second window will list rows no. 21-22 as
sample data.
3. Add and calculate date / time field. Check to a date field based on "Year", "DayOfYear",
"Hours", "Minutes" and "Seconds" SEG-P1 fields, which shall be provided in a valid SEG-P1 file.
10/47
4. Decimal Places in X/Y. Check to enable custom precision of Easting and Northing coordinates.
Specify the number of digits from the right that will be regarded as decimals. E.g. if checked and
set to 1, the input string “12345678” will be regarded as “1234567.8”.
frame.
SEG-P1 SEG-P2 SEG-P3 (1993)
Item Description Field Record Columns Field Name Field Type

Specification Number
1 Data record identifier Blank 1 1 RecordID String
2 Line name (left justified) 4A4 1 2-17 LineName String
3 Shotpoint number or event parameter I8 (or as specified) 1 18-25 ShotNumber Double

as specified in sections 4c and 4g
(right justified)
4 Reshoot code for repeated numbers 1A1 1 26 Reshoot String

on the same lines, A for first reshoot,
B for second, etc.
5 Latitude (deg., min., sec to two I2, I2, F4.2, A1, 1 27-35 Lat String
decimal places,N or S; or grads to Or
five decimal places, N or S)
(F8.5, A1) (1) (27-35)
6 Longitude (deg., min., sec to two I3, I2, F4.2, A1, 1 36-45 Lon String
decimal places,E or W; or grads to Or
five decimal places, E or W)
(F9.5, A1) (1) (36-45)
7 Map grid Easting F8.X 1 46-53 Easting Double
8 Map grid Northing F8.X 1 54-61 Northing Double
9 Water depth or elevation above mean F5.X 1 62-66 DepthElev Double

sea level
10 Year I2 1 67-68 Year Integer
11 Day of year I3 1 69-71 DayOfYear Integer
12 Hours (GMT) I2 1 72-73 Hours_GMT Integer
13 Minutes (GMT) I2 1 74-75 Min_GMT Integer
14 Seconds (GMT) I2 1 76-77 Sec_GMT Integer
15 Spare 1 78-80 Spare String
11/47
_Date Date **
** An additional optional field for storing exact date value. It is calculated based on: 1) year (taken from
column 10), 2) day of year (taken from column 11) and 3) time (taken from columns 12-14). The tool
assumes that year < 50 will be the year 2000 (e.g. 2049), while the year => 50 will be 1900 (i.e. 1950).
Source (modified): Morgan, J. G., Spradley, L. H., Worthington, G. A. and McClelland, I. J., 1983,
Special report on SEG standard exchange formats for positional data: Geophysics, 48, no. 04, 488-490.
http://www.seg.org/documents/10161/77915/seg_p1_p2_p3.pdf
Note. All header records should start with “H”. They will be skipped during import. All other records will
be assumed valid SEG-P1 records.
Note. At least Easting and Northing values have to be convertible to numbers for the record to be
imported as a point in a feature class. If not, an error will be logged and the error log window will be
displayed at the end of processing. Big number of errors can slow down the import significantly. If any
other fields does not fit to the SEG-P1 standard (i.e. can't be converted to a proper output type) they will
result in NULL values.
12/47
3.3. Import SEG Y
Description
This tool allows to import SEG Y (rev. 1.0 / 2002) geometry as a point feature class.
Usage
1. Input. Path of the selected input input SEG Y file. Click the folder icon to select a valid SEG Y file
you want to import into a point feature class.
2. Geometry Options. Choose the type of geometry: Source, Receiver or CDP X and Y coordinates
(see below for detailed description).
3. Byte order. Choose between Big and Little Endian.
frame.
13/47
File format description (rev. 1.0 / 2002):
Field Description Trace Header Bytes Field Name Field Type
1 Trace sequence number within line 1–4 TraceNo Long
2 Original field record number 9 – 12 FFID Long
3 Energy source point number 17 – 20 SourceNo Long
4 Ensemble number (i.e. CDP, CMP, 21 – 24 CDPNo Long

CRP)
5 Source coordinate X 73 – 76 Source_X Long
6 Source coordinate Y 77 – 80 Source_Y Long
7 Group coordinate X 81 – 84 Rec_X Long
8 Group coordinate Y 85 – 88 Rec_Y Long
9 Number of samples in this trace 115 – 116 NumSamp Long
10 Sample interval in microseconds for 117 – 188 SampInt Long

this trace
11 X coordinate of ensemble (CDP) 181 – 184 CDP_X Long

position of this trace
12 Y coordinate of ensemble (CDP) 185 – 188 CDP_Y Long

position of this trace
14/47
3.4. Import XPS
Description
This tool allows to import XPS (script) files. See the Shell Processing Standard for detailed description of
the file schema. The output is a table (DBF or geodatabase table).
Usage
1. Input. Path of the selected input XPS file. Click the folder icon to load a valid XPS file to import into table class.
2. XPS summary. The number of points in the input file. Only rows starting with "X" will be
counted. Type of Points. It is assumed that all points in the file are of the same type ("XPS").
3. Options. No specific options are currently available.
4. Output. Path for the output table. Click the folder icon to select a valid output table class. This
can be a table in a geodatabase (File or Personal) or a standalone DBF file.
ArcMap session.
15/47
3.5. Import UKOOA (P1/90)
Description
This tool allows to import UKOOA files. See the UKOOA-P1/90 standard for a detailed description of the
file schema.
Usage
1. Input. Path of the selected input UKOOA P-1/90 file. Click the folder icon to load a valid UKOOA
P-1/90 file you want to import into point feature class.
2. UKOOA Summary. A summary shows the number of points of a certain type. Unchecked types
will be skipped during import.
3. UKOOA Preview. This will list all rows of the UKOOA file starting with "H". See UKOOA P-1/90
file schema for details. The second text box shows a sample UKOOA P-1/90 file preview. This will
list first row after the header as a sample data.
16/47
ArcMap session.
U.K.O.O.A. P1/90 POST PLOT POSITIONING DATA FORMAT

TYPE 1 : GRID OR GEOGRAPHICAL COORDINATES
ITEM DESCRIPTION COL FORMAT Field Name Field Type
1 Record identification 1 A1 RecordID String
“S” = Centre of Source

“G” = Receiver Group
“Q” = Bin Centre

“A” = Antenna Position
“T” = Tailbuoy Position

“C” = Common Mid Point
“V” = Vessel Reference Point

“E” = Echo Sounder
“Z” = Other, defined in H0800
2 Line name (left justified, including reshoot 2-13 A12 LineName String
code)
3 Spare 14-16 A3 Spare1 String
4 Vessel ID 17 A1 VesselID String
5 Source ID 18 A1 SourceID String
6 Tailbuoy / Other ID 19 A1 TailbuoyID String
7 Point number (right justified) 20-25 A6 PointNum Double
8 Latitude (d.m.s. N/S) 26-35 2(I2), F5.2, A1 Lat String
(grads N/S) F9.6, A1
9 Longitude (d.m.s. E/W) 36-46 I3, I2, F5.2, A1 Lon String

(grads N/S) F10.6, A1
10 Map grid Easting (metres) 47-55 F9.1 Easting Double
(non metric) I9
11 Map grid Northing (metres) 56-64 F9.1 Northing Double

(non metric) I9
12 Water depth (datum defined in H1700) or 65-70 F6.1 DepthElev Double

elevation (non metric)
I6
13 Julian Day of year 71-73 I3 DayOfYear Integer
17/47
14 Time (h.m.s., GMT or as stated in H1000) 74-79 3I2 TimeHHMMSS String
15 Spare 80 1X Spare2 String
ITEM 16. RECEIVER GROUP RECORDS (3-D OFFSHORE SURVEYS)
16a Record identification “R” 1 A1 RecordID String
16b Receiver group number 2-5 I4 RecGroup Integer
16c Map grid Easting (metres) 6-14 F9.1 Easting Double

(non metric) I9
16d Map grid Northing (metres) 15-23 F9.1 Northing Double
(non metric) I9
16e Cable depth (metres)(or additional 24-27 F4.1 CableDepth Double

information as specified in H2600)
(non metric) I4
16f Receiver group number 28-31 I4 RecGroup Integer
16g Map grid Easting (metres) 32-40 F9.1 Easting Double

I9
16h Map grid Northing (metres) 41-49 F9.1 Northing Double
(non metric) I9
16i Cable depth (etc.) 50-53 F4.1 CableDepth Double

I4
16j Receiver group number 54-57 I4 RecGroup Integer
16k Map grid Easting (metres) 58-66 F9.1 Easting Double
I9
16l Map grid Northing (metres) 67-75 F9.1 Northing Double

(non metric) I9
16m Cable depth (etc.) 76-79 F4.1 CableDepth Double
I4
16n Streamer ID 80 I1 StreamerID String
Source: U.K.O.O.A. P1/90 POST PLOT DATA EXCHANGE TAPE, 1990 format.
http://www.seg.org/documents/10161/77915/ukooa_p1_90.pdf
Note. All header records should start with “H”. They will be skipped during import. All other records will
be assumed valid UKOOA P1-90 records.
18/47
Note. At least Easting and Northing values have to be convertible to numbers for the record to be
imported as a point in a feature class. If not, an error will be logged and the error log window will be
displayed at the end of processing. Big number of errors can slow down the import significantly. If any
other fields does not fit to the UKOOA P1-90 standard (i.e. can't be converted to a proper output type)
they will result in NULL values.
Note. All “R” records may include up to 3 receiver groups. Each group will be stored as a single point.
19/47
3.6. Import UKOOA (S+R)
Description
This tool allows to import UKOOA files, with a typical (land) seismic survey, i.e. Source and Receiver
points only. It allows to split the UKOOA file directly into two separate point feature classes, one
for source points and one for receiver (geophone) points.
Note: Columns from 71 to 80 are split into four "Status" fields, which is not a standard UKOOA schema.
Usage
1. Input. Path of the selected input UKOOA P-1/90 file. Click the folder icon to load a valid UKOOA
P-1/90 file you want to import into point feature class.
2. UKOOA Summary. A summary showing number of points of a certain type.
3. UKOOA Preview. This will list all rows of the UKOOA file starting with "H". See UKOOA P-1/90
file schema for details. The second text box shows a sample UKOOA P-1/90 file preview. This will
20/47
list first row after the header as a sample data.

ArcMap session.
21/47
3.7. Import UKOOA (Custom)
Description
This tool allows to import custom UKOOA files. You can use this tool to import any other text files, as
long as they contain valid coordinates. You can interactively specify start and end column for Line Name,
Point Number, Easting (X) and Northing (Y). The first letter in each row will treated as RecordID, and will
be checked and processed unless it is "H" (header information) or "EOF" (end of file).
Usage
1. Input. Path of the selected input UKOOA (or any other text) file. Click the folder icon to select
the UKOOA file (or a custom text file) you want to import into point feature class. It should
contain fixed (in terms of column numbers) location of Line Name, Point Number and X and Y
coordinates.
2. Custom Column Positions. Select start and end column for each field. The frst character in
each line will always be treated as a "Record ID".
22/47
3. Coordinates type. Choose the appropriate coordinate format for both Easting (X) and Northing
(Y). The following formats are available:
Id Mask Sample UKOOA string Example
0 XXXXXXX.X 1234567.9 1234567.9
1 DDMMSS.X 123542.5 12°35'42.5''
2 DDDMMSS.X 1123542.5 112°35'42.5''
3 DDMMSS.XH 123542.5E 12°35'42.5''E
4 DDDMMSS.XH 1123542.5E 112°35'42.5''E
5 DDMMSS.XX 123542.53 12°35'42.53''
6 DDDMMSS.XX 1123542.53 112°35'42.53''
7 DDMMSS.XXH 123542.53E 12°35'42.53''E
8 DDDMMSS.XXH 1123542.53E 112°35'42.53''E
Key:
D – degrees, S – seconds, M – minutes,
X – any digit,
H – hemisphere (N, S, E, W)
Note: each string value is converted to double. Leading spaces will be omiitted.
4. UKOOA Preview. An interactive preview of the input file. Modify start and end columns to see
which data will be taken as Line Name, Point Number, Easting (X) and Northing (Y). Make sure
that start is not less then end column, and column ranges do not overlap.
ArcMap session.
The attribute table of the output point feature class:

Field Name Field Type Field Length
RecordID String calculated based on start / end column
LineName String calculated based on start / end column
PointNum Double calculated based on start / end column
Easting Double calculated based on start / end column
Northing Double calculated based on start / end column
23/47
3.8. Batch Import UKOOA (P1/90)
Description
This tool allows to import multiple UKOOA P1/90 files at a time (batch import). See the UKOOA-P1/90
standard for a detailed description of the input file schema. Several conversion types are available:
UKOOA to point feature class, UKOOA to line feature class and UKOOA to SSDM Tracklines.
Usage
1. Conversion Type. Choose the output type (e.g. points, lines, SSDM Tracklines).
2. Input. List of selected input UKOOA P-1/90 files. Click the folder icon to load valid UKOOA P-1/90
files you want to import into point feature classes. # Lines indicates the number of lines in each
input file (including headers etc.).
3. Output options. Create a new feature class or append new data to the existing feature class.
4. Use File Name as Line Name. Check to use input file name(s) as LineName string for the
24/47
output feature class.

5. Z-Aware. Check to use Water Depth / Elevation as a Z coordinate, to create a 3D point / line
feature class.
6. M-Aware. Check to use Point Number as an M coordinate, to create points / lines that support
hatching (e.g. labeling point numbers along the seismic profile).
7. Year (applies to UKOOA P190 to Point Feature Class). Check to add “_Date” field to the
output point feature class. This date will be calculated using the given year, day of year and time
(HHMMSS).
8. Output. Path for the output location, where feature classes will be stored. Click the folder icon to
select a valid output location. This can be a folder or a geodatabase (File or Personal).
9. Add output to map. Check to automatically add the output files to the active data frame in your
ArcMap session.
10. Note. It is strongly recommended to use empty folder / geodatabase as the output location.
All existing feature classes will be overwritten by default!
25/47
3.9. Export UKOOA (P1/90)
Description
This tool allows to a export point feature class into the UKOOA text file. Some fields (such as Easting,
Northing, Longitude, Latitude) can be filled automatically based on feature's geometry. Julian Day and
Time can be calculated based on the date field.
Usage
1. Input. Select the input point layer from the active data frame.
2. UKOOA Fields. Choose the fields, which contain respective UKOOA attributes. If you choose
26/47
“none”, the given column range in the output UKOOA file will be filled with spaces.
3. Point No. Decimals. Set the number of decimal places for Point Numbers (max. 3 is allowed).
4. Receiver Group Records. Choose the fields for receiver group records. If you choose “none”,
the given column range in the output UKOOA file will be filled with spaces (for “R” records).
5. East / North from geometry. Choose to fill Easting and Northing attributes automatically based
on features' geometries. Note, that the Projected Coordinate System of the point feature class is
required to get valid Easting and Northing values.
6. Lat / Lon from geometry. Choose to fill Latitude and Longitude attributes automatically based
on features' geometries. These values will be formatted as Decimal Degrees.
7. Julian Day and Time from Date field. Choose to calculate and fill the Julian Day (day of year)
as well as Time (HHMMSS) attributes based on a date field. Choose a date field for calculating
Julian Day and time.
8. Add UKOOA Header. Check to add the UKOOA Header. Projection parameters (such as False
Easting / False Northing) will be filled in automatically.
9. Edit Header. Click to edit the default UKOOA header.
10. Output. Path for the output UKOOA file. Click the folder icon to select the output UKOOA file
name and location.
27/47
3.10.Create Bin Grid
Description
This tool allows to create a bin grid using UKOOA standard parameters, such as bin size, origin, bearing
etc.). See the attached image and Bin Grid Definition for details.
Usage
1. Parameters. Define bin size, origin, bearing.

ArcMap session.
28/47
3.11.List Line Bends
Description
This tool is designed to list all line coordinates (vertices): start and end coordinates along with all line
bends. It can be used as "lines to points" converter. You shall specify the Line Name field, which
contains line identifier. Each line vertex / node will be numbered. You may copy the output list to the
clipboard (and paste it e.g. into the Excel spreadsheet) or save it as a point feature class.
Usage
1. Input. Select the input line layer from the active data frame.
2. Options. Choose the Line Name field, which containg the line identifier.
3. All points / End points. Choose whether you need all line coordinates (vertices) or start / end
points only.
29/47
4. Output. When clicked "OK", all line vertices will be listed here. Click "Copy" to copy the Output
results to the clipboard. Fields will be separated with tabulators, so you can easily paste the
results e.g. to the Excel spreadsheet. Click "Clear" to clear the results.
5. Point layer. Check to save the output to a point feature class. Click the folder icon to select a
valid output feature class. This can be a feature class in a geodatabase (File or Personal) or a
shapefile.
ArcMap session.
30/47
3.12.Design 2D Survey
Description
This tool helps in desiging 2D seismic profiles. Providing that there are draft design profiles, one can
provide specific point intervals, first point number, point number increment as well as the length of tail
spread at the beginning and end of seismic profile. This tool can create both source and receiver points
and lines using input sketch lines as either source or receiver lines. See the image below for the
additional explanation. Note: the tool is still under development.
Usage
1. Input. Select the input line layer from the active data frame. This could be an initial 2D survey
31/47
design, e.g. sketch source or receiver lines designed based on the geological target and local
obstacles (such as protected areas, buildings, wells, roads).
2. Source Lines /Receiver Lines. Choose which type of seismic survey the input layer represents.
3. Line Name. Specify the field from the input feature class, which contains the line name.
4. Line Options. Design both Source and Receiver lines. Check to design both line types. If
unchecked, only input lines will be adjusted to fit specific intervals and station numbering. E.g. if
the input line feature class represents source lines, the output will contain only source lines /
points. If checked, both source and receiver lines / points will be created.
5. Get from fields – all line parameters will be acquired from specified fields. This option allows to
design multiple seismic profiles with different parameters (e.g. intervals / tail spread).
6. Set manually – set all attributes manually. Note: all lines will have the same parameters (e.g.
point intervals and tail spread length).
7. First SP/RP – first source / receiver point number; Increment SP/RP – increment value for
source / receiver points, e.g. 1 would result in SP/RP numbers: 2001, 2002, 2003..., while
increment 2 would result in SP/RP numbers: 2001, 2003, 2005...; Interval SP/RP (m) – the
distance between source / receiver points in meters.
8. Start Spread (m) – spread length in meters, i.e. the distance between first SP and first RP. It
has to be calculated manually, usually it can be calculated as:
((Number of receiver points in start tail spread – 1) * receiver interval) + receiver interval / 2
Note: negative value will result in source lines being longer than receiver lines.
9. End Spread (m) – spread length in meters, i.e. the distance between last SP and last RP. It has
to be calculated manually, usually it can be calculated as:
((Number of receiver points in end tail spread – 1) * receiver interval) + receiver interval / 2
Note: negative value will result in source lines being longer than receiver lines.
10. Output. Line layer. Check to save output to a line feature class. Click the folder icon to select a
valid output line feature class. This can be a feature class in a geodatabase (File or Personal) or a
shapefile.
11. Output. Point layer. Check to save output to a point feature class. Click the folder icon to select
a valid output point feature class. This can be a feature class in a geodatabase (File or Personal)
or a shapefile.
ArcMap session.
32/47
3.13.Design Offsets
Description
The theoretic survey grid usually does not take into account existing obstacles, such as protected or
restricted areas, well locations, buildings, roads, underground infrastructure etc. At the initial stage of a
seismic survey project, this theoretic survey can be compared with auxiliary data (such as topographic
maps, satellite imagery and other spatial data) to find possible offsets or bypasses. In this way the
preplanned seismic survey can be designed right in the office. Fold analysis and other analyses can be
performed on this new design to check, how obstacles may affect the survey results (e.g. the fold
distribution, number of skipped points, etc.).
This tool allows to perform a seismic survey preplanning / offset design. It will move theoretic
source / receiver points perpendicularily to the preplanned line layout.
33/47
Usage
1. Input. Choose the Point Layer with theoretic point locations. Next, choose Line Layer with
offset / bypass lines.
2. TIP: When drawing offset lines make sure that they are extended beyod theoretic lines so
that the perpendicularily moved point could be located on the new offset line. Make sure the
Line ID field is of the same type and contains the same values in both point and line
layer.
3. Options. Single input line. Choose, if only one line exists in the input line layer.
4. Options. Multiple input lines. Choose, if there are multiple lines in the input line layer. In this
case you will need to provide Line ID field for both input points and lines. This will be used to
assign points to appropriate lines on which the points will be projected.
5. Copy all attributes. Check to transfer all attributes of your theoretic points to the newly created
offset point feature class.
6. Add Offset Length field. Check to add the Offset field to the output feature class. The offset
distance will be stored here (useful to evaluate offset statistics – e.g. min, max, mean offsets).
7. Adjust offsets to. Check to round the final offset to a given interval. This could be used to
ensure, that offset points will fit the bin grid. Note that this will result in points that are not
placed exactly on the input lines.
8. Max offset. Check to specify what is the maximum offset allowed (often defined in seismic
survey technical specification). If a max. offset is exceeded, the point will be placed in its
theoretic location. The default is 100.
9. Order. Choose the ordering rule for the input point layer. The input points can be reordered using
one or two fields (e.g. Line Name and Point Number).
10. Output. Path for the output point feature class. Click the folder icon to select a valid output
feature class. This can be a feature class in a geodatabase (File or Personal) or a shapefile.
ArcMap session.
The typical scenario would be:

1. Import the seismic survey using Import SPS / UKOOA / SEG-P1 tools.
2. Add auxiliary data (protected or restricted areas, well locations, buildings, roads, underground
infrastructure).
3. Draw possible lines bypassing obstacles.
4. Use the Design Offsets tool. It will move your theoretic points perpendicularily and snap with
the new offset lines as designed in the previous step.
34/47
Fig. 1: Theoretic 3D seismic survey (roads, lake and restricted Fig. 2: Manually designed offset lines. Obstacles are bypassed,
area shown in the background). roads are used if possible.
Fig. 3: Theoretic points (Input Point Layer, blue) and offset lines Fig. 4: Theoretic points and offset points (generated using Deisgn
(Input Line Layer, violet) on which the points will be Offsets tool).
projected.
35/47
Fig. 5: Theoretic points (blue) and offset points (violet) - placed Fig. 6: Offset points symbolized using Offset Length, calculated by
perpendicularily to the original profile. the Deisgn Offsets tool.
Fig. 7: Offset points created without Adjust Offset option. Note Fig. 8: Offset points created with Adjust Offset option. Note
that offset points (violet) are placed exactly on the offset that offset points (violet) are aligned with the bin grid (black)
lines (violet), thus they are not aligned with the bin grid but will not be placed oexactly on offset lines (violet).
(black).
36/47
3.14.Points To Lines
Description
With this tool you can convert points (e.g. SPS / UKOOA points) into lines (seismic profiles). Multiple
lines (with unique line ID) are allowed. Additionally, the input file data can be reordered using one or
two fields (e.g. Line Name and Point Number).
For each line "From" and "To" point values (e.g. Point Numbers) can be added.
Usage
2. Line Options. Create a single output line. Choose to create a single output line. Only one line
in the output feature class will be created. It will be assumed that all points in the input feature
class belong to the same line.
37/47
3. Line Options. Create multiple output lines using field. Choose to create a multiple output
lines. This is a typical scenario if drawing seismic survey consisting of several seismic profiles.
Multiple lines in the output feature class will be created. Specify the field name containing the
unique line ID / Name.
4. Add "From" and "To". Check to add two additional columns in the output line feature class:
"From" and "To". Specify the field name, from which the first and the last value will be recorded
for each line. This coulb be e.g. the Point Number – in this case new fields will store the station
range for each seismic profile.
5. Order. Choose the ordering rule. The input points can be reordered using one or two fields (e.g.
Line Name and Point Number).
6. Output. Path for the output line feature class. Click the folder icon to select a valid output feature
ArcMap session.
38/47
3.15.Points To Polygons
Description
With this tool you can convert points (e.g. block / concession coordinates) into polygons (e.g. block /
concession boundary). Multiple polygons are supported. Additionally, the input points can be reordered
using one or two fields (e.g. Block Name and Point Number).
Usage
2. Polygon Options. Create a single output polygon. Choose to create a single output polygon.
Only one polygon in the output feature class will be created.
3. Polygon Options. Create multiple output polygons using field. Choose to create multiple
output polygons. Multiple polygons in the output feature class will be created. Specify the field
name containing a unique polygon ID / Name.
39/47
4. Order. Choose the ordering rule. The input points can be reordered using one or two fields (e.g.
Line Name and Point Number).
5. Output. Path for the output polygon feature class. Click the folder icon to select a valid output
feature class. This can be a feature class in a geodatabase (File or Personal) or a shapefile.
ArcMap session.
40/47
3.16.DMS <-> DD Converter
Description
Convert between Degrees-Minutes-Seconds (DMS) and Decimal Degrees (DD). Both conversions (DMS to
DD and DD to DMS) are supported.
Usage
1. Choose the conversion method (DMS-->DD or DD-->DMS).

2. Click "Convert" to calculate the coordinate.
41/47
3.17.Get Coordinates
Description
This tool can be activeted in the data view only. Click icon to activate the tool. It allows to easily
retrieve coordinates by clicking on a map. The results are listed in a dockable window. When the tool
is activated, the dockable window will appear. It can be docked, just like any other window in ArcMap.
By default, when the tool is active, the snapping is also turned on. Click on a map to get coordinates of
a specific location. You can also snap to any object in the map. Snapping description will also be added
to the results window.
Click "Copy to Clipboard" to copy the results to the clipboard. The results can be easily pasted into a
text editor or a spreadsheet (e.g. MS Excel™). Click "Clear" to clear the results.
Additionally, it is possible to double click on a specific record in the result window and a graphic icon
will be placed on the map showing the exact location for which the coordinates were acquired. This is a
graphic element, which can be deleted just like any other graphic element in the ArcMap ™ (using the
standard Select Elements tool ).
Usage
1. Click "Copy to Clipboard" to copy the results to the clipboard. The results can be easily pasted
(Ctrl + V) into a text editor or a spreadsheet (e.g. MS Excel™ or Calc).
2. Click "Clear" to clear the results.
3. List of coordinates. Double click on each record to put a red cross (a graphic icon) on the
specific location on the map.
4. Coordinate system of the active data frame. For Geographic Coordinate Systems (GCS)
Easting_X corresponds to Longitude, while Northing_Y to latitude.
42/47
3.18.Measure Angles
Description
This tool can be activeted in the data view only. Click icon to activate the tool. It allows to easily
measure angles and distances on a map. The results are shown in the bottom-left corner of the
ArcMap™ window or in a pop-up window (when double-clicked). By default, when the tool is active, the
snapping is also turned on.
The angle is measured clockwise from the North (0) in degrees. Use the tool when the data frame is
in a Projected Coordinate System (PCS).
Usage
1. Click on a map to set the starting point and move the mouse cursor to the second point of the
line you want to measure.
2. Double-click to stop measuring. The pop-up window will be displayed with the results (distance
and angle from the origin point).
43/47
3.19.About PetroGIS Tools
Description
Here you can find the product name and version as well as the license information (license type and
licensee name). The progress bar displays the license status (e.g. remaining days to expiry date).
Additionally, this dialog allows for registering new licenses and obtaining machine ID, which is
required to activate the Single License.
Usage
1. Register. Click to register your PetroGIS license. You will receive your license via email after
purchase. Copy the license code from the email and click Paste From Clipboard. Alternatively,
you may receive the license file. In this case click Load From File and browse to your license
file.
44/47
2. Register. Apply License. Click to apply the new license.

3. Register. Get Machine Code. If you ordered a Single License, click here to get the Machine
Code that the license will be registered to. Copy the machine code and send it by email to
office@gis-media.com. You will receive the pre-activated license for your machine.
4. Purchase. Go to http://gis-media.com/petrogis/order-now/ and order a license. You will receive
payment details via e-mail.
45/47
4. License and warranty
LICENSE
TRIAL LICENSE. THE SOFTWARE MAY BE USED ON ONE SINGLE MACHINE (COMPUTER) FOR A GIVEN
TRIAL PERIOD. THE TRIAL PERIOD MAY NOT BE PROLONGATED IN ANY WAY UNLESS EXPILICTLY
ALLOWED BY THE LICENSOR.
SINGLE LICENSE. SINGLE LICENSE IS REGISTERED TO A SPECIFIED MACHINE BY THE UNIQUE
MACHINE CODE. THIS LICENSE MAY NOT BE USED ON ANY OTHER MACHINES.
CORPORATE LICENSE. CORPORATE LICENSE MAY BE USED ON ANY NUMBER OF MACHINES WITHIN
THE SAME COMPANY AND IN THE SAME PHYSICAL LOCATION.
WARRANTY DISCLAIMER
THE PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY.
IT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW THE AUTHOR WILL BE LIABLE TO YOU FOR
DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA
OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF THE AUTHOR HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
46/47
5. References
ArcGIS Desktop Blog: Add-ins for ArcGIS Desktop 10. URL:

http://blogs.esri.com/Dev/blogs/arcgisdesktop/archive/2010/05/05/Add_2D00_ins-for-ArcGIS-Desktop-
10.aspx.
Morgan, J. G., Spradley, L. H., Worthington, G. A. and McClelland, I. J., 1983, Special report on SEG
standard exchange formats for positional data: Geophysics, 48, no. 04, 488-490. URL:
http://www.seg.org/documents/10161/77915/seg_p1_p2_p3.pdf.
SEG SPS rev 0 (1995), SEG Technical Standards Committee on Ancillary Data Formats, Shell Processing
Support Format for Land 3-D Surveys, Geophysics, 60, no. 2, 596-610. URL:
http://www.seg.org/documents/10161/77915/seg_sps_rev0.pdf.
U.K.O.O.A. P1/90 POST PLOT DATA EXCHANGE TAPE, 1990 format. URL:
http://www.seg.org/documents/10161/77915/ukooa_p1_90.pdf.
47/47

Manual Petrogis

Uploaded by

Copyright:

Available Formats

Manual Petrogis

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual Petrogis

Uploaded by

Copyright:

Available Formats

PetroGIS – the E&P add-in for ArcGIS www.gis-media.

developed by: GIS-Media | Jan Burdziej

released on: 2012-05-18

4. License and warranty...................................................................................46

GIS-Media offers a wide range of GIS services:

1. Double-click the following file:

PetroGIS add-in installs the following toolbar, menus and tools:

The following tools are available in the current release:

Import Menu Survey Design Menu

Import SPS / RPS Create Bin Grid

3.1. Import SPS / RPS

Graphical User Interface

POINT RECORD SPECIFICATION (example for SPS rev. 0)

1 Record identification 1-1 A1 "R" or "S" None - RecordID String

4 Point index 26-26 I1 1-9 1 - PointID Integer

5 Point code * 27-28 A2 see below None - PointCode String

6 Static correction 29-32 I4 -999 - 999 Blank Msec StaticCor Integer

7 Point Depth 33-36 F4.1 0 - 99.9 None Metre PointDepth Double

8 Seismic datum 37-40 I4 -999 - 9999 None Metre SeisDatum Integer

9 Uphole time 41-42 I2 0 - 99 Blank Msec UpholeTime Integer

10 Water depth 43-46 F4.1 # 0 to 99.9/999 Blank Metre WaterDepth Double

11 Map grid easting 47-55 F9.1 None - Easting Double

12 Map grid northing 56-65 F10.1 None - Northing Double

14 Day of year 72-74 I3 1-999 None - DayOfYear Integer

15 Time hhmmss 75-80 3I2 000000-235959 None - TimeHHMMSS String

"V1".."V9" "E1".."E9", "A1".."A9","W1".."W9",

3.2. Import SEG-P1

Graphical User Interface

SEG-P1 SEG-P2 SEG-P3 (1993)

Item Description Field Record Columns Field Name Field Type

1 Data record identifier Blank 1 1 RecordID String

2 Line name (left justified) 4A4 1 2-17 LineName String

3 Shotpoint number or event parameter I8 (or as specified) 1 18-25 ShotNumber Double

4 Reshoot code for repeated numbers 1A1 1 26 Reshoot String

(F8.5, A1) (1) (27-35)

(F9.5, A1) (1) (36-45)

7 Map grid Easting F8.X 1 46-53 Easting Double

8 Map grid Northing F8.X 1 54-61 Northing Double

9 Water depth or elevation above mean F5.X 1 62-66 DepthElev Double

10 Year I2 1 67-68 Year Integer

11 Day of year I3 1 69-71 DayOfYear Integer

12 Hours (GMT) I2 1 72-73 Hours_GMT Integer

13 Minutes (GMT) I2 1 74-75 Min_GMT Integer

14 Seconds (GMT) I2 1 76-77 Sec_GMT Integer

15 Spare 1 78-80 Spare String

3.3. Import SEG Y

Graphical User Interface

File format description (rev. 1.0 / 2002):

Field Description Trace Header Bytes Field Name Field Type

1 Trace sequence number within line 1–4 TraceNo Long

2 Original field record number 9 – 12 FFID Long

3 Energy source point number 17 – 20 SourceNo Long

4 Ensemble number (i.e. CDP, CMP, 21 – 24 CDPNo Long

5 Source coordinate X 73 – 76 Source_X Long

6 Source coordinate Y 77 – 80 Source_Y Long

7 Group coordinate X 81 – 84 Rec_X Long

8 Group coordinate Y 85 – 88 Rec_Y Long

9 Number of samples in this trace 115 – 116 NumSamp Long

10 Sample interval in microseconds for 117 – 188 SampInt Long