User Tools

Site Tools


dream:tools

Save and save as

Save your workspace into your *.dream project. DREAM use a parametric approach. This means that all your settings for the current workspace are saved but not the data themselves. Data are stored into *.bin files. Only the reference to the *.bin file is stored. This means that if a *.bin file is modified or deleted, modification or suppression will be shown next time you open the workspace.

A workspace can be saved as template. Templates are visible inside all projects. In templates, references to vectors or segmentations is done via the TAG. Non-tagged vectors/segments will not be saved in a template. When you open a template, DREAM search vectors/segments with corresponding TAG and used them.

Import

Import tool allow to import data into DREAM environment. Select your file and check the settings for each vectors to be imported: Name and unit. A preview is available on the right.
You can select one of the vector to be the reference in depth or in time. To do so, right click on the vector in the list and select “use as reference”. Note that you can change of unit category by right-clicking on the unit drop-down menu.

Accepted format are: TXT, CSV, MAT, LAS, TDMS
Do not hesitate to contact us at contact@epslog.com if you have specific format to be imported.

Printscreen

The printscreen button capture an image of the current workspace and place it in the clipboard.

Toolbox mover

When you click on a toolbox icon from the menubar, the corresponding toolbox is added on your workspace. His location and size can be modified using the toolbox mover button.
Toggle it and you will be able to move any toolbox in the workspace with click-and-drag. Possible location and sizes are predefined.
Click in the top zone of a toolbox and drag it to the desired location. Once you have dropped the toolbox at his new location, don't forget to toggle off the toolbox mover button.

Alternatively, toggle on and off can be done with keyboard key. this key can be set in the preferences. For version below 2020.89, the key is CTRL (not configurable).

Time/length slider

The time/length slider is the most used toolbox to navigate into the data. By default it is located on top or on the right of your workspace.
The Time Slider is a toolbox to navigate in time or depth. The display shows only an horizontal axis representing the time or depth. The blue zone represents the interval currently displayed in graphics like the simple axes for example. This interval is common to all elements displayed in the workspace. In the center of this blue zone, the time/depth interval length is mentionned.

  • Click-drag on the center part of the blue zone allows to displace the blue zone to the right or left.
  • Click-drag on the left or right edge of the blue zone allow to extend or reduce the blue zone from the right or left side.
  • Scrolling allows to zoom in and out. This has no effect on the interval displayed in the workspace.
  • Right-click allow to specify manually start time/depth and duration.
  • Dropping a vector on the TimeSlider will display a secondary horizontal axis below the first one. you can remove this vector using the Right-click action.

Inter workspace linker

When using multiple workspaces, all workspaces with this button toggle on are linked together. This means that navigating into one of them will force the others to display the same interval. This is especially useful when multiple screens are used. Open a workspace in full window mode on each screens and synchronize them easily with this button. There is no limits to the number of linked workspaces.

To link time and depth based workspaces together, DREAM must know how to convert time to depth of vice versa. This can be done by tagging a vector that represent a depth recorded in time with the tag “TotalDepth”. By doing this, when you navigate in time, the corresponding depth is extracted from this vector and applied to the depth workspace. Navigating in depth use the same process.
Note that the tagged vector must not absolutely monotonically increase. DREAM will simply ignore values that are not monotonically increasing.

Vector list

The vector list is probably the most used tool. 3 columns are available by default:

  • vector's name
  • frequency
  • default unit

Multiple selection is allowed using the CTRL or SHIFT key. After having selected the vectors, use a drag-drop operation starting from the upper zone of the vector list to the axes.
By right clicking in the uppermost zone, the user can

  • sort differently the vectors
  • choose to display their attributes (name, frequency, measurement device,…)
  • apply a filter based on “Type” property to display only a part of them

On top of the list, a check box allow to display only the preferred vectors. To mark a vector as “preferred”, tick the preferred box in the vector properties. If the checkbox is not selected, preferred vectors are displayed in grey.
An edit box allow to filter the list using a criteria on a property that you can choose: Name, Type, Source, Unit, Frequency.
Since version 2020.89, obsolete vectors are displayed in red.

Vector properties

Vector properties editor displays the vector's properties and allows to modify them. The vectors displayed are those currently selected in a vector list. Modifying a property affects all selected vectors. Properties description

  • Name: vector name. Note that name are TEX interpreted. Since v2020.89, if the vector is obsolete (which means that at least on the parent vector used to create this one has been modified since the creation of this one), the name appear in red. In this case, you need to update the vector.
  • Creation date and last modification date: This property is not editable.
  • Locked: if Yes, No modification will be saved for this vector. Delete is also forbidden.
  • File Path: path to the binary file containing the vector values. Click to select another file.
  • Path relative to DB path: Default value is “Yes”. It is useful to keep relative path in case *.bin files or *.dream file are moved to another folder to keep all links operational.
  • Type: 2 different levels are available by default but other value can be set (Select the empty line to create a new one.). Type property is used to sort the vectors in the vector list. Several vectors can have the same Type.
  • Tag: tags are used by templates and some algorythms to refer to the vector. Two vectors from the same project cannot have the same tag. Select the empty line to create a new one.
  • Measurement device: You can assign a measurement device to the vector to distinguish data coming from different sources. Select the empty line to create a new one.
  • Unit: The default unit used in graphic display. To change of unit category, right-click on it. Changing the unit has no effect on the data contained in the *.bin file. Those data are always stored in Standard International Unit.
  • Time or Depth: Define if the data are timebased or depthbased. If you change this value from time to depth. The vector will disapear from the vector list because vector list in a timebased workspace display only timebased vectors. Consequently, the vector will appear in the depth based workspace. Same for changing from depth to time.
  • Start time/depth: This property is always in date-time(time) or meter(depth). It represent the reference of the first value for this vector.
  • Frequency: This property is always in Hz (time) or 1/meter (depth).
  • Display Properties: click on this button if you want to use your own marker type, line stye, colors instead of the default one.
  • Comment: Write down comments that you don''t want to forget about this vector.

Two buttons are also availble:

  • Update (U): depending on vector origin, this will update the vector. For example, if vector has been imported from a TXT file, Update the vector will do the importation process again and replace the values in the *.bin file
  • Delete (X): delete permanently the vector inlcuding the related binary file. Tips: keep in mind that a deleted vector cannot be displayed again in a previously saved workspace.

One check box is available :

  • Preferred: by ticking this check box, the vector is considered has preferred. In the Vector list, you can choose to list only the preferred vectors.

Segmentation list

The segmentation list is similar to the vector list tool except that it displays the segments only.
3 columns are available by default:

  • segmentation name
  • type
  • sub type

Multiple selection is allowed using the CTRL or SHIFT key. After having selected the segments, use a drag-drop operation starting from the upper zone of the segmentation list to the axes.

Segmentation properties

It displays the segmentation's properties and allows to modify them. The segmentation displayed are those currently selected in a segmentation list. Modifying a property affects all selected segmentations. Properties description:

  • Name: Right-click on the name allows to delete permanently the segmentation. Tips: keep in mind that a deleted segmentation cannot be displayed again in a previously saved workspace.
  • Creation date and last modification date: This property is not editable.
  • Database: Only the loaded databases are present in the list. Chose another database to transfer the segmentation to that database.
  • Level: A level corresponding to the 4 levels present in the overview tab can be assigned.
  • Type: Its type can be changed.
  • Sub Type: Its sub type can be changed.
  • Time or Depth: Define if the data are timebased or depthbased.
  • Comment: Write down comments that you don't want to forget about this segmentation.

Two buttons are also availble:

  • Update: depending on segmentation origin, this will update the segment.
  • Delete: delete permanently the segmantation. Tips: keep in mind that a deleted segmentation cannot be displayed again in a previously saved workspace.

Constants

It displays the constants list and allows to modify them. Properties description:

  • Name: name of the constant. This name can be used in calculations.
  • TAG: tag is used by template workspaces and by some algoryhtms
  • Value: constant value
  • Unit: constant unit. To change the unit category, right-click on the unit list.

This tool allow to visualize all the segmentation, list their content and navigate directly to a specific item in the list simply by clicking on it. It is also possible to create new segmentation via the dropdown menu and then by clicking on the “Add” button. Each time the “Add” button is pressed, a new entry in the list is added with the current period of time/depth displayed.

Log view

The simple axes displays a graphic with 2 vertical axes (left/right in a timebased workspace and top/bottom in a depthbased workspace). It allows displaying one or several vectors as well as one or more segmentations. Vectors can have different frequency and/or start time/depht.
Vectors default plotting properties depend on the unit category. Use the vector properties editor to change the plotting properties.
Segmentations are represented by grey zones by default. A NaN mode can be chosed in the axis properties. in NaN mode, grey zones are not plotted but data outside these zones are replaced by NaN (invisible). To display a vector, drag and drop it from a vector list. You can drop several vectors and/or segmentations. When moving the mouse over the graph, the values of the vector at the mouse horizontal position is shown.
Rigth clicking on the upper zone open a contextual menu that allows to:

  • Remove the axes from the workspace figure
  • Enable or disable the “Auto-refresh” property, which synchornize it with the time slider and the other graphs
  • Change the axis properties like axis limits, scale and direction or display mode for segmentations
  • Export the vectors displayed to TXT, MAT file or to a figure (font properties of this figure can be set in DREAM preferences)

Rigth clicking on one of the axis open a contextual menu that allow to:

  • Bring the left or right axis on top
  • Bring the segmentation axis on top

Rigth clicking on the vector graph (if the corresponding axis is placed on top) open a contextual menu that allows to:

  • Change the displayed unit of this vector
  • Send the vector to the left/right axes
  • Remove the vector from the axes (The vector is not deleted from the project)
  • Note: if this menu seems to be not available, it's probably because the axis is not on top. Rigth click on one of the axis and bring the right/left axis on top.

Rigth clicking on the name of the segmentation on top of the graph opens a contextual menu that allows to:

  • choose the way the data are displayed
  • remove the segmentation.

Scrolling the mouse wheel allows to zoom in and out. If you want to zoom on a certain interval, just click-drag horizontaly on the targeted interval. Since v2020.89, it is possible to zoom out completely thanks to a predefined keayboard key. This key is set in the preferences.

XY plot

The XY axes display a graph where you can drop a vector on the X or the Y axis. Note that the 2 vectors don't need to have the same frequency (interpolation is used to match the lowest frequency vectors).
If a “discrete” vector (with NaN frequency) is dropped, the other vectors are interpolated to match this vector.
To add a vector to this display, drag and drop it from a vector list on the horizontal or on the vertical axis. If a vector is already present on this axis, it will be replaced.
You can also drop a segmentation from the segmentation list. This will mask or not the XY points corresponding the segments.
Finally, it is also possible to drop a vector in the upper right corner of the plot to add a colorbar linked to the dropped vector. Rigth clicking on the upper zone opens a contextual menu that allows to:

  • Remove the axes from the !workspace figure
  • Enable or disable the “Auto-refresh” property, which controls the interval displayed with the other graphs or time slider present in the workspace
  • Set the axis and color limits
  • Export the vectors displayed in a *.mat/*.txt file or in a new figure

Rigth clicking inside the graph opens a contextual menu that allows to:

  • Add a regression line that will be displayed on top of the graph.
  • Place a blue point manually
  • Specify the regression line polynomial coefficient passing through the blue points (if present) or the black points (if no blue points)
  • Store a copy of the points on the background with a different color. This is very usefull to compare cloud of points from different portion of data.

Rigth clicking on the name of the segmentation on top of the graph opens a contextual menu that allows to:

  • choose the way the data are displayed
  • remove the segmentation

Histogram

The Histogram displays a graph with 2 vertical axis (left and right) and 2 horizontal axis (top and bottom). It allows displaying one or more vectors distribution.
To add a vector to this display, drag-drop it from a vector list. You can drop vectors on the top or bottom part of the axes zone allowing the utilisation of the top or bottom horizontal axis for the different vectors. When moving the mouse over the axes, the values of the vector at the current horizontal position of the mouse is displayed. Rigth clicking on the upper zone open a contextual menu that allows to:

  • Remove the axes from the workspace figure
  • Enable or disable the “Auto-refresh” property
  • Export the vectors displayed in a *.mat file

Rigth clicking on the axes open a contextual menu that allows to

  • Bring the top or bottom axis on top

Rigth clicking on the vector line itself open a contextual menu that allows to:

  • Change the displayed unit of this vector
  • Send the vector to the top or bottom axes
  • Delete the vector from the axes

Polar plot

The polar plot is used to display two vectors where one should be an angle. Drag-drop vectors from a vector list. Rigth clicking on the upper zone open a contextual menu that allow to:

  • Enable or disable the “Auto-refresh” property
  • Set the axis limits

Surface plot

The XYZ axes display a surface representing on vector (Z) versus 2 others (X and Y). Note that the 3 vectors must have the same frequency (but eventually not the same start time/depth).
To add a vector to this display, drag-drop it from a vector list. You can drop the vector on the X, Y or Z axis. If a vector is already present on this axis, it will be replaced. Rigth clicking on the upper zone open a contextual menu that allow to:

  • Remove the axes from the workspace figure
  • Enable or disable the “Auto-refresh” property
  • Set the axis limits (to set the axis limits mode to “Auto”, let the limits empty)
  • Export the vectors displayed in a *.mat file
  • choose what to plot: value, number of value, number of value (%) or standard deviation

Click-drag on the axis itself allows a 3D rotation. Rigth clicking on the axis open a contextual menu that allow to:

  • Reset the view
  • Switch to X-Y, X-Z or Y-Z view
  • Change Rotation options

Power spectrum

The power spectrum display an axes with 2 vertical axis (left and right) and 2 horizontal axis (top and bottom). It allow to display one or more vectors power spectrum.
To add a vector to this display, drag-drop it from a vector list. You can drop the vector on the left or rigth part of the axe zone allowing the utilisation of the left or rigth vertical axis. When moving the mouse over the axes, the values of the vector at same vertical position is displayed. Rigth clicking on the upper zone open a contextual menu that allow to:

  • remove the axes from the workspace figure
  • Enable or disable the “Auto-refresh” property
  • Set the axis limits
  • Export the vectors displayed in a *.mat file

Rigth clicking on the axes open a contextual menu that allow to:

  • bring the top or bottom axis on top

Rigth clicking on the vector line itself open a contextual menu that allow to:

  • change the displayed unit of this vector
  • send the vector to the left/right axes
  • delete the vector from the axes

Spectrogram

The spectrogram display an image of vector spectrum. The vertical axis represent the frequency while the horizontal axis is the time. The power is represented by color (jet colorbar). Only one vector can be displayed.
To add a vector to this display, drag and drop it from a vector list. When moving the mouse over the axes, the values of the power at mouse location is displayed. Rigth clicking on the upper zone open a contextual menu that allow to:

  • Remove the axes from the workspace figure
  • Enable or disable the “Auto-refresh” property
  • Set the axis limits (to set the axis limits mode to “Auto”, let the limits empty)
  • Export the vectors displayed in a *.mat file

Scrolling allows to zoom in and out. If you want to focus on a certain part of the data, just click and drag horizontaly on this part.

Video player

This tool allow to visualize a video frame. The displayed frame can be the one corresponding to the left/middle/right position of the time slider. In the settings, the user can change the starting time of the video.

Note

The Notes tool serves the user to keep trace and transmit any learning made while analyzing the data visible in the workspace. The display contains a yellow box in which the user can write its comment.

Vector editor

The data editor allow to manually modify vectors. The data displayed by the data editor correspond to the data available in the range specified by the TimeSlider. To modify data, rigth-click on the upper zone of the data editor:

  • Specify one or two conditions to select certain values
  • Specify the research zone:
    1. in the selected lines
    2. in the current displayed interval
    3. in the entire file
  • Specify the new value: you can use numbers (ex: 30), NaN, Inf, or expression (ex: 5*6).
  • Note: modifications are immediately saved in the binary file. It is not possible to cancel a modification.

Statistics

The statistic tool display the mean, standard deviation, minimum and maximum for a certain vector or segmentation. Non finite numbers are ignored.
Simply drop one or several vectors or segmentations on this tool to visualise those informations. The values mentionned are related to the portion of data currently displayed.

Segmentation creator

The Segmentation tool has been developed to create segments from a vector satisfying a defined logical rule. For instance, one may interested to isolate the on-bottom drilling, translated by a positive downhole torque.
Those segments can be extremely useful to synchronize precisely vectors acquired by different measurement sources (for instance downhole sub and surface data).
As for the calculation tool, the input vectors can be selected from a vector list, dragged and droped into the upper box. For each input, you can define a minimum and maximum value. the rule can be reversed (“Exclude” checkbox) to logicaly inverse the rule.
The user can now generate the segmentation by clicking on the “+” button on top right.

Principal Component Analysis

The principal component analysis allow to find the directions with maximal deviation.
Drop input vectors and the principal components will be displayed. To export, tick the box corresponding to the principal component that you want to save and click on the “+” button located on top right.

Clustering

The clustering toolbox allow to find clusters in a dataset.
Drop input vectors and select the number of clusters you want. Change number of cluster to see the differences.
Since v20203.89, it is possible to specify if a vector is in log and to change his weight.
To export cluster results, select the number of cluster you want, choose the “Clusters” tab and click on the “+” button. Once exported, cluster vector can be displayed in a log plot or a XY plot.
Some settings are available like the clustering method, number of iterations and distance method.

Manual vector creator

This tool allow to create a vector manually by imposing certain values and extrapolate others. Using the button “New & Options”, you can create a new vector and specify his name, start time/depth and frequency.
Once created, you can impose the value of certain intervals. To do so, simply zoom on the desired interval and click “Add a new value”. You will be prompted to enter the value for that interval.
Via the Options, you can specify how to fill the zones between defined intervals.

Synchronization

The basic time synchronisation tool has been developped to apply a time or depth shift and to stretch any vectors. The principle is to bring 2 points that can be easily identified to a new position. The procedure to follow yields:

  • Display the reference vector (usually surface vector) and the vector that needs to be synchonized in a simple axes.
  • Drag and drop the vector to be synchronized from the Vector list.
  • Place the first point of the vector to be synchronized in the center of the (using zoom or a Time Slider for example).
  • Click on “Select point 1”. The horizontal position is now appearing on the button.
  • Choose the new position of this first point (by using the reference vector) and place it in the center of the simple axes.
  • Click on “Select new value for point 1”. The horizontal position of this new value is now appearing on the button.
  • Proceed identically for a second point

The result is displayed in the text zone (new start time/depth and new frequency).
Notes:

  • The precision of this method is proportionnal to the distance between point 1 and 2 due to the stretching process.
  • The result is only displayed, there is no modification of the vector. This must be done manualy using a vector properties editor.
  • If you have multiple vectors measured with the same clock or depth source with same start time/depth and same frequency, you can apply the modifications to all of them.

Calculation

One of the most important tool is the calculation tool. It has been developed to calculate a new vector from existing input vectors.
Select the type of calculation to perform, then select the input to used (via the vector list) and click on “Calculate”. Depending of the type of calculation, additional settings may be required.

  • Duplicate: create a copy of the input vectors.
  • Decimate: create a decimated vector. Decimation order can be choosed.
  • Interpolate: create a new vector that is interpolated on the inputs. New frequency and interpolation method can be choosed.
  • Filter: create a new filtered vector. filter order and type and cutoff frequency can be choosed.
  • Stats: create a vector representing statistics of the input. Statistic type and window size can be choosed.
  • FFT: create a vector containing the dominant frequency of the input. Window size and frequency type can be choosed.
  • Convert to depth: a time based vector can be converted to depth base. This process required that a time vector is tagged as “TotalDepth”. The tagged vector is used as transfer function from time to depth.
  • Custom formula: create a new vector based on input and a formula of your choice. Input vectors must have the same frequency.
  • Convert to time: a depth based vector can be converted to time base. This process required that a depth vector is tagged as “Time”. The tagged vector is used as transfer function from depth to time.
  • Merge: create a vector using several inputs having same frequency and unit category. Depending on vectors start time and length, empty zones between vectors will be filled with NaN. If overlap, vector with latest start time is choosed.

Zeroing (not included in the basic licence)

This tool allow to create a vector by imposing certain values based on another vector.
To create a vector, drop the vector that will be used as reference. Specify his name, start time/depth and frequency. Once created, you can impose the value of certain intervals. To do so, simply zoom on the desired interval and click “Add a new value”. Depending of the options, the mean/min/max/std/first or last value of the reference vector will be added. Via the Options, you can also specify how to fill the zones between defined intervals.

Drilling (not included in the basic licence)

This tool is dedicated to the analysis of drilling data. It offer unique insights into drilling performance, downhole dynamics, wellbore conditions, and drilling practices, thus enabling the user to improve drilling efficiency and performance. This includes a range of functionalities for the correction of spurious effects (sheave, hydraulic lift, torque and drag, RPM) and estimation of at the bit parameters (WOB, TOB, MSE@bit…). It also incorporates hydrodynamic calculations and a torque and drag model (soft and stiff string). This tool allow to perform calculation related to drilling. These calculatin are listed in a specific order. For each of them, inputs are required. Inputs and outputs are identified via their tag.
All of these calculation require time-based drilling data.

Connection (not included in the basic licence)

This tool allow to detect connections in time based data and estimate off bottom values.
Before to use this tool, several vectors must be tagged: BitPosition, HookLoad, RotationOnSurfaceTotal, OffBottomHKL and OffBottomTQ.
Using BitPosition vector, connections are detected. Check Options to improve detection. Once detected, you can navigate between connections using “previous” and “next” buttons. When looking at one connection, you can run zeroing routines CP/offHKL and TQ/RPM. The zeroing routines allow to confirm or not zeroing results. When doing that, the vector tagged OffBottomHKL and OffBottomTQ are updated with new values. An automatic process is also available to confirm all connections at one time.
Remark: vectors tagged OffBottomHKL and OffBottomTQ must be created using the “Manual vector” tool or the “Drilling” tool.

dream/tools.txt · Last modified: 2020/11/16 21:36 (external edit)