Getting Started

Main commands

After you log in you will be presented with the following available commands in the vertical left hand side toolbar as shown below:

Screenshot

Learn more about Dashboard, Assets, People, or Accounts options.

Field Designer

The "Field Designer" module allows you with quick and easy "drag and drop" operations to create new or replicate existing field layouts in a very short time. Connecting assets are as simple as drawing lines/splines between asset/structure connection points. The layouts can be as simple or as advanced as your imagination allows. See a field layout example shown in the screenshot below:

Screenshot

Project Toolbar

The topmost toolbar is the project toolbar for your current project.

Screenshot

On the left side of the toolbar you will see the following icons before and after your Project Name:

Screenshot

The icon to the left of the project name will take you back to the Dashboard.

The cogwheel icon to the right of the project name will take you to the Project Settings

Screenshot

The central part of the project toolbar as shown above is comprised of the following commands:

Screenshot

This will allow you to add descriptive information for a project. See Sub-Projects for more information.

Screenshot

This will allow you to add a new sub-project to your project. See Sub-Projects for more information.

Screenshot

This will present a drop down list where you select the sub-project to load. See Sub-Projects for more information.

Screenshot

This is a drop down list for the available project actions namely Clone, Rename, and Delete. See Sub-Projects for more information.

Screenshot

The Lock button toggles the current sub-project between locked/unlocked if you want to e.g. put the current (sub-)project in a locked state where no edits can be made. Click again to unlock it.

Screenshot

The user menu gives you access to a wide range of functions for Export/Import functionaliy, Revisions, Help resources, and User Settings. See User Settings for more information.

Stage Area

The stage area is your drawing canvas where you do your field layout design work as shown in the illustration below:

Alt text

Stage Coordinates

Alt text

When you move the mouse cursor around the stage area the top toolbar will show the current x, y, and Z coordinate. Note! The Z coordinate will be equal to the project Sea bed level value unless Bathymetry data is loaded for the project. If that is loaded then the current Z value of the Bathymetry data in the X, Y position will be shown.

Alt text

We support real world coordinates that allows you allows you to start designing a field layout without having to load “Bathymetry” data first to set a position. You can correctly place you topside/subsea assets at their designated location directly by entering in the x,y coordinates and set the heading when an asset is selected in the Asset Editor. See the Asset Edior section of the documentation for more information.

2D and 3D View

The stage area can be viewed in either "2D", which is also the "Design" or "layout mode" e.g. this is where you will do most of your design/layout work for your field.

The illustration below shows the stage view in 2D:

Alt text

The 3D view is a primarely a view only mode that allows you to view your subsea and topside layout in 3D. You switch between 2D and 3D by clicking on the designated 2D or 3D icon at the stage toolbar.

Alt text

The 3D view does allow you to select, move and rotate assets etc., but for general layout/design work this is better done in 2D view. The 3D view is then displayed as shown here

Alt text

2D Mouse Navigation

You can zoom in and out on the stage area by using mouse wheel scroller to seamlessly zoom in and out of the stage.

Alt text

You can pan around the stage area by clicking on the stage area background and holding down the left mouse button and move the mouse in the desired pan direction.

Alt text

3D Mouse Navigation

As for the "2D" mode you can zoom in and out on the stage area by using the mouse scroll wheel to gradually zoom in and out. You can pan around the stage area by clicking on the stage area background and holding down the left mouse button and move the mouse in the desired direction.

If you click and hold the right mouse button while moving the mouse pointer sideways either left or right it will then rotate the 3D view around. If you move the mouse pointer upwards or downwards while holding the right mouse button down you will then tilt the 3D view up or down.

If you press and hold down the mouse scroll wheel while moving the mouse in either direction you will enable a smooth directional navigation movement.

Alt text

3D Navigation Tips

For complex subsea layouts where you have also have a lot of subsurface data 3D navigation can sometimes be a bit tricky when you try to zoom in on specific details of e.g. topside and subsea assets. If you experience that even with small mouse movements that you zoom by the asset you are probably experiencing difficulty with the system raycasting algorithm. This sends a ray ahead of your viewpoint and try to collide with what is in front of it to decide on the navigation control sensitivity. If there is maybe 1000 meters before it collides with something then the zoom factor will be large. To alleviate this we recommend trying to adjust the following settings:

  • Water Opacity - If this is below 0.2 the navigation raycasting will ignore the current water level so if you try to view a topside asset we recommend that this is at least 0.2 or higher. See World Settings

  • Layer Opacity - If you have e.g. a 3D Surface layer loaded (bathymetry/survey) and the layer opacity is set to less then 0.2 the navigation raycasting will ignore if you try to view subsea or subsurface assets. We recommend that the layer opacity is at least 0.2 or higher. See 3D Surface

Stage Tools

In Project View e.g. when you have started a new or loaded an existing project you will always have the "Stage Tools" toolbar visible over the stage area as shown here for 2D mode: Alt text

The available toolbar functionality depends on if you are in 2D or 3D mode, but certain functionality is always available regardless of view mode.

The second part of the toolbar have two drop down menus for "Create" and "Export" functionality followed by the Stage expand/collapse icon:

Alt text

The individual toolbar commands as shown above are as follows:

Hide / Show Project View

Alt text

Hide or shows the Project View and Asset Library window.

Undo / Redo

Alt text

Undo or Redo up to the last twenty (20) operations. You can also press CTRL-Z for Undo, and CTRL-Y for Redo.

Zoom In / Zoom Out

Alt text

Allows you to zoom seamlessly in or out on the stage for a more detailed view.

Zoom Extent

Alt text

Automatically zooms the view outwards to fit all deployed assets/vessels/connections on the stage.

2D / 3D Mode

Alt text

Switch between viewing the stage area in 2D or 3D Mode.

Key combination Command
2 2D View Mode
3 3D View Mode

Note! 3D mode requieres WebGL to be enabled in the Chrome browser. If WebGL is not enabled you will see that the 3D icon will be greyed out. This link will take you to a FAQ article on how to enable it: Help Center Article

Delete Selection

Alt text

Will delete the selected object(s). A dialog box will be presented for confirmation of the action.

Cut Connection

Alt text

After selecting the tool, click on the desired connection you want to cut. This will cut the connection at the click location and create two individual connections. Note! 2D Mode only.

Multiple Select

Alt text

Toggles the selection rectangle for multiple object/connection selection. Then you easily move all selected objects to a new location. If you select just connections, every connection that intersects with the multiple selection area will be selected. Once the selection is complete, you can click on one of the selected connections and move the entire selection set around and all connections will follow. Press and hold down the "CTRL" key and the click on individual assets/connections to add/remove it to/from the selection.

You can also hold down the "SHIFT" button and that will allow you to rotate all the selected connections as well. You can of course also copy/paste, delete and rotate the selection.

Key combination Command
CTRL-C Copy selection
CTRL-V Paste selection
DEL Delete selection
CTRL + Click Add asset/connection to selection
SHIFT Hold SHIFT down to rotate selection

Measure Distance

Alt text

Enables the measurement tool that allows you to measure the distance in meters and view the angle between 2 selected points in the stage (2D only). The measurement function will stay active until you deselect it. To start a new measurement, simply click on a new point you want to measure from. The radius can be determined for e.g. ships or installations for different purposes such as safty distance. Note! 2D Mode only.

Alt text

Topside

Alt text

Will move the 3D camera view topside e.g. above sea level. Note! 3D Mode only.

Subsea

Alt text

Will move the 3D camera view subsea e.g. below sea level. Note! 3D Mode only.

Move Asset

Alt text

You can move an asset in 3D view by selecting the Move icon from the 3D Stage Toolbar. Then click on the desired 3D asset or text object to move. Use the 3D arrow object helper to move your asset to the desired position.

Alt text

To "Move", simply position your mouse cursor over the 3D move helper object and if you are over the arrows they will light up. Clicking and holding the left mouse button over the desired arrow will perform a fixed move in that direction. If you select the filled square area at the arrow intersection on the 3D move object helper you can freely move the desired asset or text around. Release the mouse button once you have your desired location.

Rotate Asset

Alt text

You can rotate an asset in 3D view by selecting the rotate icon from the 3D Stage Toolbar. Then click on the desired 3D asset or text object. That will display a circle around the asset.

Alt text

To "Rotate", simply press the 3D circle helper object and hold the left mouse button down while you rotate the asset to your desired angle and release the button.

Reservoir Mode

By combining information sources such as reservoir, seismic, and real well-data with your visualized field layout in 3D you immediately obtain a better understanding of the complete project.

Alt text

Enables the 3D Reservoir mode for showing the real reservoir data in 3D with any loaded well trajectories. Additionally, you can also see the real world position of both the top and bottom hole for each individual well.

Alt text

When the Reservoir mode is enabled the seabed will turn translucent to allow you to view layers and/or 3D data that are positioned below the actual seabed level e.g. the reservoir data sources.

With 3D data is loaded in it is placed as an individual layer. But unlike standard bitmap layers you can only manipulate visibility on/off and opacity. This is because the correct scale, position and rotation is embedded in the converted 3D data and is correctly represented in real world scale.

Typical data that can be displayed beneath the seabed is for example:

Reservoir maps
Well placing maps
Geological formations
3D scan of reservoirs
3D well trajectories

FPS Camera

Enables FPS Camera for 3D scene flythrough useful for screen recordings or live presentations.

Alt text

To navigate in the FPS camera mode use the following keyboard commands:

Key combination Command
W or up arrow Move forward
A or left arrow Move Left
S or down arrow Move backward
D or right arrow Move right
SHIFT Accelerate

Create

Alt text

The create drop-down meny allows you to add content or online services to your project as shown in the following menu:

Alt text

Below are the available functions for the various content you can add to your project. For more information see Create Menu.

3D Surface

This allows you to add 3D Surface data such as Bathymetry/Survey data, Reservoir scans etc. to your field layout in GeoTiff or x,y,z (pointcloud) format. See the 3D Surface section.

Picture

This will allow you to add images/pictures as layers to your Field layout in jpeg, bmp, or gif format. See the Picture section.

WMS

This allows you to add an online map service(s) as a content layer that supports WMS (Web Mapping Service). See the WMS section.

Port

Will display the port placement area on screen. See the Port section.

Text

Allows you to freely place text anywhere on the stage. See the Text Tool section for further details.

Well

This allows you to manually create well trajectories by providing a top hole location and adding additional trajectory points. See the Well section.

Well from File

Import a well trajectory from a text file for the well you want to display. You can select multiple files to load several wells at once. See the Well from File section.

View Point

Create a View Point of the current scene view location in either 2D or 3D mode. You can later select the created View Point to navigate back to that exact scene. See the View Point section.

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. See the Create Connection from File section.

Create Connection from WFS

This command allows for direct import from WFS (read: Web Feature Service) mapping servers/services such as e.g. ArcGIS. See the Create Connection from WFS section.

Export

Alt text

The Export drop-down menu allows you export content from your project as shown in the following menu:

Alt text

Connections as GeoJSON

This will export out all connections in the current project in GeoJSON format. See the Connections as GeoJSON section.

Connections as GeoJSON (Unconverted)

This will export out all connections in the current project in GeoJSON format without coordinate conversion. See the Connections as GeoJSON (Unprojected) section.

Connections as XYZ

Exports out all connections in the current project as a text file in x,y,z coordinates. See the Connections as XYZ section.

Wells as GeoJSON

This will export out all well trajectories in the current project in GeoJSON format. See the Wells as GeoJSON section.

Wells as GeoJSON (Unconverted)

This will export out all well trajectories in the current project in GeoJSON format without coordinate conversion.See the Wells as GeoJSON (Unprojected) section.

Wells as XYZ

Exports out all well trajectories in the current project as a text file in x,y,z coordinates. See the Wells as XYZ section.

Assets to MS Excel

Exports out a MEL (Master Equipment List) of all assets in the current project as a MS Excel spreadsheet. See the Assets to MS Excel section.

Activities to MS Project

Exports out all activities entries in the Activity Tab as a MS Project file. See the Activities to MS Project section.

Schematics

Creates a network diagram from the current field layout and saves is out as a SVG (Scalable Vector Graphics) file.

Assets

The first step after completing the Add Project command to create a new project is to start designing your field layout! To populate your field layout you need to choose your structures from the "Asset Library"". You will find the "Asset Library" typically on the left side as shown below:

Screenshot

You will see the Asset Library tab just next to Project View This will reveal the asset library selector catalog. You can have multiple asset libraries including private asset libraries for your own company that depicts your own equipment or vessels. Default libraries available are "Generic" and "User" libraries. The generic library is comprised of the most common subsea and topside assets and in addition various vessels. The "User" library is comprised of your own defined assets that have been added into this library from the asset editor.

To add an asset to your field layout design in the Stage area make sure you are in 2D Mode and simply click it and hold down the left mouse button while you drag it out of the asset list and onto the stage area and release the mouse button. To reposition the asset just click again on the active asset and hold the left mouse button down while you move it to the new position on the stage and release the mouse button.

Copy and Paste Assets

You can copy and paste individual or a selection of assets/connections, by selecting then and then using the following keyboard commands:

Key combination Command
CTRL-C Copy selected asset
CTRL-V Paste selected asset

You can copy and paste assets between individual project tabs, and even copy paste individual assets between different projects.

When pasting an asset it will appear where you have the mouse pointer positioned on the layout area. So if you want to paste multiple copies of an asset on stage simply move the mouse around to the desired position and press CTRL-V at each location.

Move Asset 2D

You can easily move an asset by first clicking on the desired asset. That will display a dotted circle around the asset with four (4) icons. These icons will allow you to respectively "Rotate", "Delete", "Display", or "Lock" the asset position.

Alt text

To "Move", simply click anywhere within the circle and hold the left mouse button down while you move the asset to your desired location and release the button.

Rotate Asset 2D

You can easily rotate an asset by first clicking on the desired asset. That will display a dotted circle around the asset with three (4) icons. These icons will allow you to respectively "Rotate", "Delete", "Display" or "Lock" the asset meta data.

Alt text

To "Rotate", simply press the rotate icon and hold the left mouse button down while you rotate the asset to your desired angle and release the button.

Delete Asset

To "Delete" an asset, simply click on the "Trashcan" icon and the asset will be removed from the stage.

Lock Asset

To "Lock" an asset, simply click on the "Lock" icon and the asset will be locked in that stage position. Note! Only available in 2D Mode.

Connect Assets

Field Activity Planner comes with a set of the most typical generic assets that can be used for a simple field layout. Most of these assets can be connected to each other as would be expected for a field layout.

The number of asset connection points depends on the asset you have selected. They can be edited in the asset editor. Connection points are typically located just off the asset outline itself as show in the illustration below:

Alt text

To make a connection between two (2) assets or structures you need to click once on the starting connection point once the mouse cursor changes to a "cross selector". Then move the mouse over to the asset connection point that you want to connect to and click once again when the "cross selector cursor" is shown. The assets will then be connected together. Also, whenever a connection is selected the cross selector indicator will be shown and allow you to move a connection to a different connection point at any time.

Alt text

Note! You can have as many connections between structures as you want such as shown here:

Alt text

No connection when asset is selected

If this option is selected under the stage settings you will not be able to make a connection on an asset, when the asset is in selected mode. If you uncheck it then you can make connection regardless of the asset state.

Edit Connections

If you click on the connection line itself between two assets, you can add curvature edit points, which allows you to modify the layout of the connection line. You will see a small "+" symbol next to the mouse pointer that indicates that by a left mouse click a curve edit point will be added.

To remove an edit point from the connector press and hold the "Shift" key and select the edit point on the connector.

To remove a connection, click on the "Trashcan" icon in the toolbar as illustrated below, or press the Del key.

View Selector Icons

Alt text

On the lower navigation bar pn the right hand side you can find the "View" control that will toggle between the three (3) different application views available to you.

Alt text

The FieldAp "/Split" view displays both the "Stage" area and the Active Module e.g. "Timeline(Gantt)", "Cost" etc. module at the same time.

Selecting the "Stage" view hides the "Active Module" from view so that the entire application view is used for "Stage" layout.

The "Module" view will hide the "Stage" area so that the entire application screen is used for the "Active Module" view.

Sub-Projects

For every project, you can create as many sub-projects you want. This is useful when you operate with different layout designs that you may want to contrast or compare against each other, or to show various stages of the field life cycle.

Screenshot

Project Information

You can add project information for the current sub-project, by pressing the "i" button above. This will present you with a new dialog where you can add text/notes describing the current sub project.

Alt text

New sub-project

You can easily create several versions of a project, or sub-projects (views) if you will of a field layout for the same project by using the New command. Simply press the New button on the top toolbar. This presents the following dialog allowing you to "Add sub-project".

Alt text

Simply type in the name for the new sub-project, and press "Create" . This will create a new Sub-project. Or press "Cancel" to abort!

You can switch between the various Sub-projects by selecting from the sub project drop down list as shown here.

Alt text

The topmost entry is a quick search field that you can start to type in to narrow down the selection if you have many Sub-projects.

Sub Project Actions

Screenshot

You can Clone, Rename, or Delete a sub-project by selecting from this drop-down menu:

Clone

If you want to create a copy or a clone of the active sub-project, simply write in the new desired name in the Name field, and then select the Clone button. Note the Clone to project drop-down-list. This is set to your current project by default, but allows you to clone your current sub-project into another project, which is very useful if you want to reuse a field layout again in another project.

Alt text

Rename

This option will present the following dialog

Alt text

To rename a sub-project simply change the name in the edit box and press Save. Press Cancel to abort.

Delete

To remove a sub-project simply press the "Delete" button. The following dialog will be presented:

Alt text

Pressing Cancel will close the dialog without making any changes. Note! This action cannot be undone!