Skip to content

Create Menu

This menu is available for any subproject once you have created a new project, or opened an existing one.

Alt text

The create drop-down meny allows you to add various data, content, or online services to your project (sub-project) as shown in the following menu:

Alt text

3D Surface

This allows you to add Bathymetry and/or Survey data to your Field layout in GeoTiff or X,Y,Z (pointcloud) format. You can add multiple Bathymetry/Surveys to a sub-project. FieldAP will then height- or depth-sample if you will each Bathymetry layer individually, and where there is no Bathymetry data the default “Sea Level” value from the Project settings will be used.

Selecting this option will display a dialog that will allow you to select a file and add it as a new 3D surface layer. The default name will be set to the filename, but you can change it in the Name field with a descriptive name of your choosing.

Alt text

Quality - Allows you to select the conversion quality on the 3D surface file you wish to upload. You can choose between; Low, Normal, High, and Extreme. This defines the resolution of the 3D mesh created. The default selection is Normal, which usually is a good tradeoff between performance and resolution.

Since this is a browser based solution and given the size and dimensions of the bathymetry files we resample the bathymetry data on conversion on the server side so it can be sampled real time in the browser. So based on the quality setting we map the bathymetry to a texture which is then also resized to best fit the aspect ratio of the bathymetry area. The quality settings are resampled as follows:

Quality Resolution
Extreme 512x512 pixels
High 256x256 pixels
Normal 128x128 pixels
Low 64x62 pixels

To examplify for a 4 x 2 km bathymetry file with the "Normal" setting and with aspect ratio applied the conversion will use a 256 x 64 setting making 1 pixel equal 4000/256 m = 15,6 meters

For a 5 x 5 km bathymetry file with "High" setting the resolution will be 5000/256 = 19,5m and for "Extreme" 5000/512= 9,7 m per pixel

Please note! You can upload multiple bathymety files with varying resolution in the same project so you can have e.g. a more detailed DEM for areas around a pipeline.

Always negate depth - This option allows you to load land based elevation models e.g. DEMs that have positive height or Z values. Set this to "No" and you will display the 3D surface model above sea level.

Is Bathymetry - Select Yes if this is Bathymetry data. No, if not.

Limit Import to - If you want to load Bathymetry data with much higher resolution for moe accurate sampling, you can select Current View Box, which will only load the data for the current view port stage area.

File - This will display a file dialog for selection of the 3D surface file you wish to upload.

Name - This field will allow you to change the name of the 3D surface file that will be converted to a more meaningful layer name. By default this will be populated by the file name selected.

Create - Then click on Create to have the file automatically converted and added to your project. Click Cancel - to abort.

The file will then be uploaded and converted and displayed on screen when complete and the new 3D surface will be visible in the layer section of the Project View:

Alt text

The loaded 3D Surface data e.g. bathymetry shown below in the stage area 3D View.

Alt text

The 3D surface layer will also be visible when you switch to 2D View mode as a depth map is automatically created from the 3D surface for this purpose to assist you with you field design activities. See illustration below.

Alt text

If you select the layer in the control it will be marked as selected and highlighted as shown here:

Alt text

Visibility

You can turn the 3D surface layer visibility on and off by clicking the "eye" icon to the left. You can also do this for all loaded 3D Surfaces layers by clicking on that corresponding eye icon. This is the same for both 2D and 3D Mode.

Layer options

If you right click on the selected layer, a menu of available options will be displayed as shown here:

Alt text

Locate - This will locate the layer on stage.

Clone - This will create a copy of the currently selected layer.

Hide - Hides the layer. Same as clicking on the eye icon.

Delete - Deletes the selected Layer.

These options are also available in the Attribute section represented by the icons and the "More" menu as shown here:

Alt text

3D Surface Attributes

You can adjust the attributes or settings if you will of the loaded 3D Surface layer in the bottom part of the Project View settings area for the layer as shown here

Alt text

The Layer Attribute/Settings section has two tabs namely Common and Layers.

Common

The Common tab is comprised of the general common attributes/settings for a layer.

  • Name - The name of the uploaded 3D surface. You can change this by editing the name directly. Use Edit button to the right for multi line text.

  • Position - Edit the X,Y,Z position of the layer, which is inserted to a 0 origin position by default. Negative values will shift left or down. Positive values will shift right or up.

  • Heading - Set the rotation in degrees (0-359) for the layer.

  • Scale (Surface) - Allows you to scale the 3D surface layer. Useful to better see elevation changes.

  • Opacity - Allows you to adjust the transparency of the layer by adjusting the value between 1 (Fully Visible) and 0(Invisible).

Layers

The layers tab is comprised of specific settings related to the 3D surface data format.

Alt text

  • Use as Bathymetry - Check this box if this 3D surface layer should be used as Bathymetry/Survey data that you will sample against.

  • Render as contour - Select this option for e.g. simulating rendering of HCPT (Hydrocarbon Pore Column Thickness) data and represent these as contour plots based on assign the color gradient for the Z value. When loading such a file set “Always negate depth” to “No”. Then select this option. You can change the Z color sample values, by clicking on the Edit Gradient button. This will display the dialog for setting the Z depth color association for rendering.

  • Seabed Texture - You can change between different textures to be used in 3D view to better illustrate the seabed type e.g. sand or rocks. You set your selection using the drop-down list as shown here:

Alt text

Picture

This will allow you to add images/pictures as new layers to your Field layout. This will display a dialog that will allow you to select a file and add it as a new layer with a descriptive name of your choosing.

Alt text

Supported picture formats are; JPEG, GIF, BMP, and Tiff.

The upload picture will appear as a new Layer under Pictures in Project View as shown here:

Alt text

Picture Attributes

You can adjust the attributes or settings if you will of the loaded picture layer in the bottom part of the Project View settings area for the layer as shown here

Alt text

The Layer Attribute/Settings section has two tabs namely Common and Layers.

Common

The Common tab is comprised of the general common attributes/settings for a layer.

  • Name - The name of the uploaded picture. You can change this by editing the name directly. Use Edit button to the right for multi line text.

  • Position - Edit the X,Y,Z position of the picture, which is inserted to a 0 origin position by default. Negative values will shift left or down. Positive values will shift right or up.

  • Heading - Set the rotation in degrees (0-359) for the picture.

  • Scale (Picture) - Allows you to scale the picture layer. Useful to match the image to another content layer or an area on the stage.

  • Opacity - Allows you to adjust the transparency of the layer by adjusting the value between 1 (Fully Visible) and 0(Invisible).

Layers

The layers tab is comprised of specific settings related to the Picture content category.

Alt text

  • Height Sampling - Enable this to allow the selected picture layer to be height sampled or draped if you will onto a 3D Surface Layer.

  • Sampling Layer - This allows you to select a 3D surface layer from a drop down list of loaded 3D surface layers to height sample the picture image onto e.g bathymetry data as an example.

  • Center on sampling layer - This will center the image onto the selected sampling layer.

If you right click on the selected picture layer, a menu of available options will be displayed as shown here:

Alt text

Locate - This will locate the layer on stage.

Clone - This will create a copy of the currently selected layer.

Hide - Hides the layer. Same as clicking on the eye icon.

Delete - Deletes the selected Layer.

These options are also available in the Attribute Settings.

WMS

The use of geography data is becoming more and more important for oil and gas operators and service providers to make informed decisions. This can be in terms of locating and extracting new resources, better field design and planning, information retrieval and offers deeper insight into relationships and patterns as part of everyday operations. You can add a map layer to Field Activity Planner using the WMS (Web Mapping Service) Module.

Alt text

As an example, if you are working on project on the Norwegian continental shelf you can now access the Norwegian Petroleum Directory open map service and visualize information such as wellbores, surveys, fields and discoveries, production licenses, agreement-based areas, permanent facilities and more as part of your layout to facilitate more effective discussions for e.g. equipment and piping scenarios. You can also directly connect your on-premise GIS software e.g. ArcGIS servers or similar.

To add a map layer to FieldAP simply select WMS from the Create menu. Note! You can configure as many WMS layers using the same or different WMS servers.

Alt text

WMS Configuration

Enter the WMS service URL in the WMS URL field.

As an example this is the WMS URL for the NPD map service:

https://factmaps.npd.no/arcgis/services/FactMaps_ogc/3_0_ED50_z32/MapServer/WMSServer

The application will then display the various configuration options returned by the WMS GetCapabilities and populate the available Projection Systems, Image Formats, and available Map Layers. These you can then configure as you see fit.

Alt text

If no information is loaded and depending on your network settings, you may need to use some of the following options:

  • Use Proxy - If you want to access a non HTTPS WMS you will have to check this option.

  • Use Windows Credentials - If your network configuration requieres Windows Credentials select this option.

  • Use Authentification - If your authentication is over HTTP(S) etc. check this option and supplu user name and password.

  • Login and Password - Enter your username and password here if you checked the Use Authentication option.

When content is returned you can then set the following options:

  • Project Projection System - Select the correct ESPG/SRS value for you project.

  • Format - Allows you to select from a list of the image formats that are returned from the WMS server.

  • Transparent - Check this option if the image data should be returned with transparency for the WMS Layer. Note! If supported by the WMS Server.

  • Layers - This will display a treestructure of all the Layers available in the WMS service. Select the layers you are interested in.

Press Ok to add the new WMS Layer, or press Cancel to abort.

WMS Attributes

The Layer Attribute/Settings section has two tabs namely Common and Layers.

Alt text

Common

The Common tab is comprised of the general common attributes/settings for a layer.

  • Name - The name of the WMS Service. You can change this by editing the name directly. Use Edit button to the right for multi line text.

  • Opacity - Allows you to adjust the transparency of the layer by adjusting the value between 1 (Fully Visible) and 0 (Invisible).

If you right click on the selected WMS layer, a menu of available options will be displayed as shown here:

Alt text

Locate - This will locate the layer on stage.

Clone - This will create a copy of the currently selected layer.

Hide - Hides the layer. Same as clicking on the eye icon.

Delete - Deletes the selected Layer.

These options are also available in the Attribute Settings.

Layers

The layers tab is comprised of specific settings related to the WMS Layer.

Alt text

  • Z - This is the layer rendering order or Z value if you will. As you can have multiple Layers the Z order decides the order the layers are rendered on screen with the largest negative number being rendered first.

  • Up and Down - Changes the layer rendering order Up and Down respectively.

  • Configure WMS - Brings up the WMS Configuration dialog. See above.

  • Get Feature Info - Click on the stage where the map is shown, and the WMS server will return GetFeature Information if any in a seperate dialog as shown here.

Alt text

  • Legend - Display the WMS service Legend information if any.

Port

To better and more accurately visualize marine operations and installation planning - FieldAP has built in functionality for port related vessels activity management. To access the port functionalty, simply select "Port" from the Create menu.

Alt text

Clicking on the "Port" icon will display the port layout area on the stage illustrated by a semi-transparent border area surrounding the stage with a moveable port icon that can be placed anywhere in the border area.

Alt text

Simply move the mouse around and the port icon to be placed will move around the rectangular border until you have your desired position, and click the left mouse button. Normally each side of the rectangle will also represent a heading for the port for more accurate visualization of marine operations e.g. left border equals "West", the top border area equals "North" and so forth.

Alt text

You will then be presented with a "Port" icon and the possibility to name your port. To do this, simply type in the desired port name in the "Edit field". To "Delete" the port, simply click on the "Trashcan" icon.

You will now notice a "Dotted Circle" highlighting your "Ports" whenever you select an asset from the "Vessel" category as shown here:

Alt text

To place or "Dock" an asset from the "Vessel" category inside a port, simply drag it over the desired port while holding down the left mouse button and release it. The vessel will now be docked inside the port, and you will also see a numerical indicator highlighting the number of docked vessels in the port as shown here:

Alt text

With "Ports" functionality you can now visualize task such as "Mobilizing", "Transit" from/to port etc. in your "Activity Planning", and it will be likewise indicated when you "Play" or operate the timeline function. To access or to assign an activity to an asset docked in port, simply click on a port icon, and the port dialog will appear.

Alt text

From the port dialog you can select a vessel for an activity, delete a vessel by clicking on the trashcan icon next to its name, or you can select a vessel using your mouse and dragging it back onto the stage to undock it. You can also edit the port name.

Text Layer

Use this function to freely annotate your field layouts at any position on the stage. To add a text/comment etc. to the Text Layer simply select "Text" from the Create menu, and click anywhere on the field.

Alt text

This will add the text "Text" on your layout at the position you clicked on the stage. This will create a new entry in the Text Layer section in Project View with the Common attributes as shown here:

Alt text

  • Tags - This allows you to assign user tags for group operations to the text object.

  • Name - Write you text here. If you wish to write a longer text simply click on the edit text icon to the right to display an "edit dialog" on screen where you can add multiple lines of text.

Alt text

After adding your text, simply click "Save" to add your text, or click "Cancel" to exit!

  • Label - Allows you to change the font color and font size. Use the Show check box to select if the text should be On or Off.

If you right click on a selected Text layer, a menu of available options will be displayed as shown here:

Alt text

Locate - This will locate the text layer on stage.

Hide - Hides the text layer. Same as clicking on the eye icon.

Delete - Deletes the selected Text Layer.

These options are also available in the Common Attribute Settings for the Text Layer.

Well

Well trajectories can be added to your project either manually, or by loading well trajectories from file, or programatically by using the REST API. See the illustration below for a project with well data:

Alt text

This allows you to manually create well trajectories by providing a top hole location and adding additional trajectory points. To get started select "Well" from the Create menu.

Alt text

This will display the Well Editor dialog box as shown here:

Alt text

  • Name - Specify the name of the new well you want to create.

  • Top Hole X and Y - Specify the top hole x,y coordinates.

  • +Add Point - This commands allows you to define the well trajectory downwards from the defined top hole x,y location by adding X, Y, and Z coordinates for each point you add.

The click on Create to create the new well, or press Cancel to abort.

Well Attributes

The Well Attribute/Settings section has two tabs namely Common and Layers.

Alt text

Common

The Common tab is comprised of the general common attributes/settings for a Well layer.

  • Tags - This allows you to assign user tags for group operations to the well object.

  • Name - Specify/change the name of the well here. If you wish to write a longer text simply click on the edit text icon to the right to display an "edit dialog" on screen where you can add multiple lines of text.

  • Label - Allows you to change the font color and font size for the well name. Use the Show check box to select if the text should be On or Off.

  • Length - Displays the length of the selected well trajectory in meters.

If you right click on a selected Well layer, a menu of available options will be displayed as shown here:

Alt text

Locate - This will locate the well on stage.

Hide - Hides the well. Same as clicking on the eye icon.

Edit - Brings up the Well Editor dialog.

Export - Allows you to Export the well trajectory as either a text file with XYZ coordinates, GeoJSON format, or GeoJSON Unprojected e.g without any coordinate conversion.

Delete - Deletes the selected Well Layer.

These options are also available in the Common Attribute Settings for the Text Layer.

Wells

The Wells tab holds the well specific settings for a Well layer.

Alt text

  • Radius - Specifies the size of the radius for the well trajectory rendering. Increase this for better visibility in 2D and 3D Mode by entering a number or using the slider control.

  • From Sea Level - If this is selected the Well Top hole location starts from Sea Level instead of Seabed Level (Default).

  • View Dependent Radius - If this is checked the radius will follow the stage scale settings.

  • Actions - Select Export to export the current trajectory out as a text file with the x,y,z coordinates. Select Edit to display the Well Editor dialog.

Well from File

This command allows you to import a well trajectory from a text file into your project where they will be displayed in 2D and in 3D if Reservoir mode is enabled. You can select multiple files to load several wells at once. To import a well just select the Well from File option from the Create menu.

Alt text

This will display a dialog for selecting the well data text files to load.

Alt text

At the moment we support some of the most common well formats for well trajectory data. This will typically look like the following format as shown here:

Alt text

If the well format is not recognized, an import helper dialog will be displayed:

Alt text

This will allow you to describe the well format file by using the following parameters.

First line - This number specfies which line number the x,y,z data should be read from e.g. this allows you to skip well data headers. Typically the first 3-7 lines of text.

Northing - This drop down list will display the first 3 columns of values read from the file as Col 0-2. Assign the appropriate column value as the Northing coordinate value.

Easting - This drop down list will display the first 3 columns of values read from the file as Col 0-2. Assign the appropriate column value as the Easting coordinate value.

Depth - This drop down list will display the first 3 columns of values read from the file as Col 0-2. Assign the appropriate column value as the Depth value.

Use for all selected files - Check this option if you are importing multiple well files at once and they all have the same format.

The loaded Well trajectories will the show up as new entries in the Wells Layer as shown here:

Alt text

The well will be placed in 3D according to the coordinates from the well data text file. If you switch to 2D View the loaded wells are visualized as red circle(s) with a color inside (the color is selectable).

Alt text

In 3D mode you will see the entire trajectory of the well (reservoir mode enabled).

Alt text

To adjust the Well Attributes section for more information.

View Point

This allows you to create a View Point of the current scene view location in either 2D or 3D mode. You can later select the created View Point from Project View to navigate back to that exact scene. To create a "View Point" select it from the Create Menu

Alt text

The created View Point will then be displayed under the View Points section in Project View:

Alt text

To go to a created View Point double click on the one you want and the stage view will update accordingly.

View Point attributes

  • Name - Specify/change the name of the View Point here. If you wish to write a longer text simply click on the edit text icon to the right to display an "edit dialog" on screen where you can add multiple lines of text.

If you right click on a selected Well layer, a menu of available options will be displayed as shown here:

Alt text

Locate - This updates the current stage view to your selected View Point.

Delete - Deletes the selected View Point.

These options are also available in the Common Attribute Settings for the Text Layer.

Create Connection from File

This option allows you to import connection profiles in x,y,z format from other engineering SW/tools into Field Activity Planner for more accurate display of connections. To create a new connection from file, select this option from the Create menu.

Alt text

In addition to text files in X,Y,Z format this function supports the import of GeoJSON and Shape (SHP) files.

Support for GeoJSON files

Many WMS (mapping) servers like ArcGIS allows you to extract/export pipelines in GeoJSON format if you store your facility data there. GeoJSON is an open standard format designed for representing simple geographical features, along with their non-spatial attributes. It is based on the JavaScript Object Notation (JSON).

Support for SHP files import

Most CAD software will allow you to save or export your pipelines as “SHP” files. The shapefile format is a geospatial vector data format for geographic information system (GIS) software. It is developed and regulated by Esri as a mostly open specification for data interoperability among Esri and other GIS software products. The shapefile format can spatially describe vector features: points, lines, and polygons, representing, for example, water wells, rivers, and lakes. Each item usually has attributes that describe it, such as name or temperature.

To import these type of data formats into FieldAP, select the “Create Connection from File”. This will present the following dialog:

Alt text

Then select from the following options:

  • Connection(s) will follow the seabed - If checked this will force the imported connection data’s Z values to follow the existing seabed/bathymetry or retain the original Z values in the file e.g. if you are importing a riser.

  • “Add tie-in connections” - Select this to add one additional point at both ends of the imported connection file. E.g. there is a long distance between the first and second point in the pipeline and you want to adjust the beginning of the pipe to tie in to a plem or similar, you have to add a new point to create the last bend. So selecting this option creates these "tie-in" points automaticly.

  • Force curved connection to be straight - If this is checked the imported connection will be of type Straight.

Pressing “Confirm” will then display a file selection dialog:

Alt text

And the file will be imported into FieldAP and displayed as shown below:

Alt text

Create Connection from WFS

This feature supports direct import from WFS (read: Web Feature Service) mapping servers/services such as e.g. ArcGIS. You can directly import e.g. existing pipeline data as new connections in FieldAP. To create a new connection from a WFS mapping service, select this option from the Create menu.

Alt text

Import Profile From WFS

This will bring up the following dialog box where you select project projection system to be used from the drop-down list. If you want to restrict the import to the current on screen view you select the “Restrict to import current view” check box as shown below.

Alt text

Then select “Next” and the following dialog will be shown:

Alt text

Here you input the WFS server address that you will query for data. This example retrieves data from the Norwegian Petroleum Directorate free mapping service, which you can read about here https://www.npd.no/en/facts/factpages/

Then press “Next“ to continue the process.

This brings up a dialog that list all the available described data layers from WFS query (read: GetFeature) as shown below:

Alt text

In this sample we selected “pplAll” e.g. all pipelines, and that will present a dialog listing all the available pipelines from this layer:

Alt text

You also have filtering options for “Attribute” and “Value”. For this sample we set “pplName” to “troll”. You can use the “+” and “-“ buttons shown to add or delete filters.

Then press the “Import” button to start the import from the WFS server. A message when the import process is complete will appear. Note! The imported connection might not show up on the screen as that depends on the current field location. The easiest is to select the “Asset Locator” module and use the “Locate” function to be taken to the imported pipeline as shown below.

Alt text

Press “Locate” to jump to the imported pipeline as shown here:

Alt text