Release notes

These release notes cover Harmony Enterprise versions 2019.2 – 2017.1. For prior release information, contact our customer care team:

Harmony Enterprise 2019.2 Release Notes

This release has the following features:

Enhancements for Multi-well models

  • Multiple layers for the unconventional model: model several layers with unique reservoir properties per layer: net pay, saturations, porosity, and matrix permeability. Layers may communicate through fractures and stimulated reservoir volumes (SRVs) of the wells and/or through the matrix.
  • Simulate gas condensate: for conventional and unconventional reservoirs.
  • Saturation distribution map: display saturations in a convenient weighted-color scheme (red = gas, green = oil, blue = water).
  • Improved initialization of group properties: property correlations and the gas type are initialized for a group based on the values you have specified for its constituent wells.

Performance improvements

The time to perform these tasks was reduced to increase productivity:

  • Load / toggle between entities in the Analysis tab.
  • Load / toggle between Decline / Typewell / Consolidation worksheets.
  • View several Typewell operations: append forecast, color by attribute, daily resolution, and rate per attribute.
  • View the Editors tab.
  • Display production in the Diagnostics tab.
  • View and edit large amounts of Attribute data.
  • Create / modify a well filter.
  • Delete wells.
  • Delete custom datasets.
  • Promote scenarios.
  • Import *.harmony files that include custom datasets.

Enhancements to deployment utilities

  • Installers have been built for the Well Security Manager application and the Database Manager application.
  • Database Manager:

    • Includes a report listing the database changes between the current and previous version.
    • Supports SQL Server authentication.
    • Remains open after performing a task (for example, when creating a database).
    • Improved handling and error messaging, if sqlcmd.exe is not in the default location.
    • Added notification if a user does not have permission to create or upgrade a database.
    • Errors are logged to a file in the same directory as the application.

New role-based permission: Modify Editors

A Modify Editors role has been added to control which groups / users can change data in the Editors: Properties, Wellbore, Production, and Static Pressure. Note that when this role is not granted, and the Import / Update Wells role is granted, only the Database Connection is available for import.

Model a destructive refrac

Shrinking fractures can be modeled in the history or forecast of a numerical model by specifying a negative Δ(xf)Extension within the Refrac parameters section.

Typewell analysis linking

Typewell declines of different fluid types can now be linked (for example, oil and gas Typewell declines). Additionally, a ratio forecast can be applied to a Typewell decline in the Forecast worksheet.

Condensate decline analysis

Condensate decline worksheets have been added alongside other decline worksheets for ease of use.

Eliminated the limit on number of custom calculated datasets

The 2019.1 release introduced a custom dataset limit of 100 to improve performance. This limit remains for custom input datasets, while the number of calculated custom datasets is no longer limited.

Comparison plot includes the source name

When sending a plot to the Comparison Plot, if only one entity is selected, its name is set as the source.

Liquid ratio units have been added for custom datasets

Liquid ratio units have been added to the available list for custom datasets. Custom datasets with these units can be linked to default datasets with liquid ratio units.

Resolved issues from Harmony Enterprise 2019.1

  • If duplicate production records exist for a well during import, previously all subsequent wells failed to import. Now, only the wells with duplicate records fail. The import also no longer continues to fail after the underlying data has been fixed.
  • Fixed crashes that occurred when using a hierarchy structure based on at least two custom attributes.
  • Fixed the hide disabled points option in the unconventional reservoir analysis. Now all four plots on the dashboard function correctly.
  • Reduced the well batch size when importing *.harmony files to prevent large file imports from running out of memory.
  • Fixed WOR analyses, which failed to import from *.harmony files.
  • Resolved the crash during import if the database connection Sandface temperature is mapped, but not Wellhead temperature.
  • Resolved the crash during import where the database connection’s Sandface temperature was mapped, but the Wellhead temperature was not.
  • Resolved the infrequent crash that occurred when importing plots from *.harmony files.
  • Database upgrades no longer fail when a user has been removed from an active directory group, but still has access to the Harmony Enterprise database.
  • When first specified, the input number of steps in a model’s forecast persists.

Harmony Enterprise 2019.1 Release Notes

This release has the following features:

Identify forecasts deviating from production

Compare actual production with forecasted production for a batch of wells to quickly identify wells requiring attention. This feature calculates the deviation of cumulative volume over a user-specified period (that is, between 1 - 365 days). Reported results include:

  • the difference between produced and forecasted cumulative volumes
  • the percentage of actual production from forecasted volumes

All forecast and fluid types are supported. Results can be sorted, and custom groups created from the results table.

Restrict well access by group / user

Maintain the benefits of having all your company’s wells in one database, while restricting which wells are accessible by active-directory group or user. Permissions are granted by a Security Administrator based on well attributes, ensuring new wells are properly assigned. Role-based security has also been enhanced to incorporate new security roles.

Enhancements to the Unconventional Multi-well model

  • Variable Landing Depths: simulate staggered wells by landing them at different depths. In addition, fractures and stimulated reservoir volume (SRV) for each well do not have to extend through the entire net pay, allowing a portion of the net pay to be drained.
  • Overlapping SRVs and Fractures: simulate communication between wells through overlapping SRVs and fractures, including scenarios where the child well is drilled within the SRV of the parent well. Various types of parent-child interactions can now be simulated.
  • Gridding options: are now displayed.
  • Shaded plots: are now available in side views (in addition to the existing top view). Permeability can now be displayed in the shaded plots.
  • Forecast: the number of Time Steps for each forecast period can now be specified.

Interoperability with WellTest 2012v3 and later

Analyze buildups or drawdowns from your production database without re-entering this data by doing the following:

  • Create an export file for use in WellTest 2016v2 or later
  • Initialize or append wells in Harmony Enterprise by importing WellTest files from 2012v3 or later

The following data can be transferred:

  • Well production
  • Reservoir and fluid properties (excluding advanced properties such as relative permeability and custom property tables)
  • The initial wellbore configuration profile
  • Analytical models
  • Hybrid models

Oil Material Balance

Analyze static pressure data for oil wells or groups to interpret the original oil in-place. With this analysis, you can account for pressure changes due to water encroachment, changes in formation compressibility, and volatile oil.

Import static pressures

Static pressures from a single well or multiple wells can be imported from text file sources (that is, *.csv, *.txt, *.xlsx, etc.).

Reduce data resolution during import

An arithmetic or logarithmic filter can be applied to each flow or build up period to reduce the data resolution when importing WellTest files, undefined text files (for example, *.csv), *.hldb’s, or when using the database connection.

Globally specify defaults units

Build a custom unit set to be used when setting default display units. A mixture of metric and field units can be specified.

Specify classification consolidation aggregation behavior

An option has been added to configure the behavior of classified consolidations, to either include the fluid produced from all constituent wells / groups, or from only those matching the specified classification.

Consolidate custom input attributes

After merging several Harmony files into a Harmony Enterprise database, it is common for multiple duplicate custom attributes to exist. A utility has been added to consolidate multiple fields and their data into a single field (only available for input custom attributes). To prevent further duplicates, options are available to specify whether new custom fields should be added or discarded when importing.

Resolved Issues from Harmony Enterprise 2018.3

  • Fixed an issue where customizing a second dataset in the Diagnostic tab applied this change to all datasets.
  • Wellbore data is always imported for new wells, regardless of the selected import setting.
  • Improved performance when selecting a filter in a database with many wells.
  • Resolved a crash when running hybrid probabilistics caused by the weighted points.
  • Rsoi can now be mapped and imported from a database connection import. However, if pbp is also mapped, it takes precedent.
  • Fixed an issue to ensure that when forecast rates are exported, they are output as calendar rates.
  • The database connection supports source tables / views regardless of case.
  • Fixed a crash caused by using the defaults manager in the unconventional multi-well model when analyzing a single well.
  • Restored persistence of typewell dataset customizations (for example, line thickness).
  • Restored the ability to normalize rates in a typewell worksheet by a unitless attribute.

Harmony Enterprise 2018.3 Release Notes

This release has the following features:


Create alternate scenarios on wells using different well properties, wellbores, and calculated sandface pressures. Wells and their scenarios can be analyzed individually and their results and inputs compared. A scenario can be promoted to replace the primary well and become the official version. Harmony Enterprise saves the following information: scenario name, created by, last modified date, and last modified by.

Unconventional Multi-well model (beta)

With the Unconventional Multi-well model, history-match and forecast a group of wells with Horizontal Multifrac completions.

  • Requirement of symmetry: for this release, all wells within the model are considered parallel, have the same horizontal wellbore length, and the same number of fractures.
  • Flexibility for completions: you can model asymmetrical fractures (i.e., left fracture wing not equal to right), or define stimulated reservoir volume (SRV) that extends less than, or beyond fractures.
  • Clipboard functionality: copy the multi-well model from one group to another.
  • Position Lines: are used to indicate the progress during simulation, and can be moved after the simulation, so you can view spatial distribution of pressures or saturations at any desired date.
  • Ability to exclude wells: specify whether a well is included during simulation to identify interference.
  • Water and gas injection: this model supports injection. For example, injection can be used to simulate water injection during fracturing, and to match water rates during flow-back.

Enhancements to the Conventional Multi-well model

With the Conventional Multi-well model, you can history-match and forecast groups of wells that are vertical or horizontal. This release features the following enhancements:

  • Clipboard functionality: you can copy the multi-well model from one group to another.
  • Position Lines: are used to indicate the progress during simulation, and can be moved after the simulation, so you can view spatial distribution of pressures or saturations at any desired date.
  • Ability to exclude wells: specify whether a well is included during simulation to identify interference.

Interoperability with Piper 2018.1 or later

Create export files for Piper with calibration data for building models, or analytical models for field forecasting. Wells are validated prior to exporting to ensure only complete and accurate information is imported to Piper. Well forecasts that have been created or updated in Piper 2018.1 or later can be imported into Harmony Enterprise for comparison and update purposes.

Gauge Depth correction

Convert gauge depth pressures (run depth pressures) to sandface pressures. This functionality is available for tubing, pumping, and casing flowpaths for configurations where the gauge and tubing are landed above datum (MPP).

Decline and Multi Segment decline enhancements

Enhancements include the following:

  • Undo: revert analysis changes while making edits (e.g., line manipulation, parameter edits, best fit, etc.).
  • Change b and dlim as a bulk process: the Bulk Edit Declines dialog box has been expanded to support changing the first segment’s b value, or the dlim value for any segment.

Enerdeq import | new Completion and Production fields

Additional completion and production attributes now exist in the Harmony Enterprise database, and can be directly imported from Enerdeq. Attributes such as Lateral Length, Proppant Amount, IP Oil, and IP Gas have been added.

Importing Numerical models from Harmony

Numerical models created in Harmony are now migrated to Harmony Enterprise as analogous Hybrid models.

Enhancements for Comparison plots

Datasets in Comparison plots are now grouped to indicate that they originated from the same plot. This makes comparing results between different cases easier.

Gas Lift in DB Connection

The Valve Depth when using Gas Lift in the wellbore schematic can now be imported through the Database Connection.

Resolved issues from Harmony Enterprise 2018.2

  • If an analysis has multiple fluids, the Typewell history + forecast now displays the correct forecast.
  • Duplicate production rows are deleted when importing a well from a *.harmony file. Previously, the well was not imported, nor any groups the well belonged to.
  • Fixed copying parameters between Analytical and Hybrid Fracture models.
  • Fixed incorrect average pressure calculations for multiphase Hybrid models with adsorption.
  • Fixed the scrolling issue with the Production editor. Previously, if you selected beyond the bottom of the Production editor, it scrolled to the top, which caused incorrect selections.
  • If you use the database connection and have proprietary field names that match IHS Markit views, it is no longer mandatory to map these field names.
  • The latest wellbore configuration data is always imported and used for the linear temperature profile, detailed temperature profile, and deviation survey

Harmony Enterprise 2018.2 Release Notes

This release has the following features:

Multi-well model enhancements

With the Multi-well model, you can history-match and forecast groups of wells while accounting for interference between wells. This release features the following enhancements:

  • Horizontal completions: any well within a multi-well model can now have a vertical or horizontal completion type.
  • Aquifer support: you can now model additional pressure support by connecting an aquifer to the reservoir. You can model an edge aquifer (connected to the reservoir boundary or a part of it) or a bottom aquifer (connected to the reservoir bottom or a part of it).
  • Water and gas injection: the multi-well model supports injection. You can specify water and gas injection rates in the Production editor for individual wells to model injection during the history. You can also set up a forecast to model injection.
  • Display shapefile: shapefiles that are available in the GIS tab can now be displayed on the schematic of the multi-well model. (This enables you to use a shapefile as a reference when creating or editing the reservoir boundary.)
  • Display Lat / Long: the latitude and longitude of the current position of the mouse pointer are displayed in a model schematic and can be copied to the clipboard. (This functionality can be used to add a new infill well at the location you want).
  • Copy a Multi-well model: use defaults manager to copy all the parameters of the existing multi-well model to a new one.

Project Economics

Perform project economics on traditional or rate transient analysis (RTA) forecasts, and compare cash flows and key performance indicators (KPIs) (e.g., net present value, internal rate of return, etc.).

Import PowerTools projects

Import well attributes and production data, along with the analyses associated with them, which includes declines, volumetrics and material balance analyses.

Resolved issues from Harmony Enterprise 2018.1

  • Sandface pressures are now calculated correctly during import when production data is added using the “Append” option, and the pressure source is not explicitly set in the final row of the table.
  • When migrating wells from *.harmony files (when the data is in an invalid state), pressure-loss-calculation settings are now set to default values.

Harmony Enterprise 2018.1 Release Notes

This release has the following features:

Bulk reporting

Create report sets to print one or multiple worksheets for a batch of wells. The report format is selected for each worksheet when printing, instead of upfront when the worksheet is created.

Bulk delete analyses / worksheets

View and delete analyses and worksheets for a selection of entities.

Bulk export production

Export historical production for a selection of wells for use in third party applications.

Multiphase URM and FMB

Now incorporates multiphase pseudo-pressure to account for simultaneous flow of oil / gas / water. The FMB can be used to model flowing pressure, rate, and average reservoir pressure. Additionally, the Productivity Index is available for oil.

Group FMB and Typecurves

Analyze total group production using FMB and Typecurves available on Hierarchy and Custom groups, and account for both production and injection.

Vertical Multi-well model

With the new Multi-well model, you can history-match and forecast groups of vertical wells. This model accounts for interference between wells, while the wells have individual reservoir and completion properties in each well region.

Gas static material balance

Estimate original gas-in-place (OGIP) for gas depletion drive and storage reservoirs using shut-in pressure data in a modified p/Z technique (p/Z**). This technique enhances the conventional gas material balance method to include water drive, connected reservoir concept (composite permeability or layered), and geomechanical effected reservoirs by modifying Z to a Z** formulation. This formulation is based on SPE paper 139428, “Advanced Gas Material Balance in a Simplified Format” by Moghadam, Jeje, and Mattar, first published in the January 2011 edition of the JCPT.

Resolved issues from Harmony Enterprise 2017.3

  • The Typewell Wells pane now sorts consistently with the Entity Viewer.
  • Fixed the issue where a subset of wells failed to update using the database connection, and the Status Window indicated the error: well is locked by current user.
  • The Comments column is now correctly imported from text / Excel files.
  • Wells no longer fail to import using the database connection when the well key includes leading or trailing spaces.
  • All .harmony files are automatically unlocked before importing into Harmony Enterprise (a locked file would previously fail to import).
  • Parsing of Aries declines has been updated to prevent unresponsiveness during updating when non-unique analysis names are produced. Previously imported Aries declines will not be updated following this change.

Harmony Enterprise 2017.3 Release Notes

This release has the following features and resolved issues.

Database Connection: import performance improvement

New well imports through the database connection are now approximately 15-18 times faster. Similar performance improvements can be realized when updating wells with the latest data by using the new option: “Overwrite Past 90 Days”.

Spatial Explorer

To get more context for well locations, use map services, web map services (WMS), or Bing maps in the new Spatial Explorer tab.

Gemalto Sentinel RMS

With the Gemalto Entitlement Management System, clients have a self-service portal to manage their entitlements. This is a new licensing system with enhanced security measures.

Resolved issues from Harmony Enterprise 2017.2

  • Calculated custom datasets are now computed for groups
  • The auto-scale state persists when a Diagnostic template is added as a worksheet
  • Diagnostic lines are always initialized and visible regardless of plot axis ranges
  • Dataset customizations persist on plots (e.g., line thickness, color)
  • Resolved the inability to remap a linked Access table within the IHS database connection
  • Resolved failures when migrating *.harmony files
  • Regardless of the number of series displayed in a comparison plot, the Deselect All Series icon is now responsive when clicked

Harmony Enterprise 2017.2 Release Notes

This release has the following features and resolved issues.

Decline Autoforecast

An automatic rigorous fit of an Arps’ decline to a single or batch of wells. This initial best fit identifies the partition to fit to, excludes outliers, and minimizes b without sacrificing quality of fit.

Schedule Database Connection imports

Using the Windows Task Scheduler, specify the frequency for a scheduled database connection to run (daily, weekly, etc.). The update runs on the machine used to schedule this import. A license is required to set up / modify a scheduled update, but a license is not required when the update is running.

Database Connection support for Property and Wellbore data

The supported data types for the database connection now include almost all the inputs in the Properties and Wellbore editors. If the data is available, wells can be almost fully populated using the database connection.

Well Query

Build a group of wells by specifying attribute criteria, or providing a well list. Groups can be quickly updated by re-running the query.

Calculate sandface pressures during import

Sandface pressures can be calculated for all wells following an import / update, if this option is enabled.

Resolved issues from Harmony Enterprise 2017.1

  • A model’s parameter pane doesn’t scroll when changing units.
  • When importing unsupported Aries decline analyses, Harmony Enterprise no longer crashes.

Harmony Enterprise 2017.1 Release Notes

Probabilistic hybrid analysis

Specify a distribution for parameters with greatest uncertainty to understand the impact on the model forecast and EUR.


Estimate the original hydrocarbon fluid volume in a reservoir or back-calculate well drainage area based on its EUR, recovery factor and certain reservoir and fluid properties.

Active directory

Manager user logins with Microsoft Active Directory

CDF plot

In addition to the cross plot, display attribute or analysis results using a CDF to understand parameter distribution

Resolved issues from Harmony Enterprise 2016b

  • Resolved failure in database connection when both custom attributes or datasets were mapped and more than 50 wells were imported (either crash or data not imported)
  • Wellbore deviation survey retained when updating well via import regardless of update option
  • All references to custom attributes within a custom calculated attribute are persisted when imported using a *.harmony file
  • Line manipulations on a typewell worksheets no longer affect the selected datasets
  • When using a workflow, your typewell custom attributes are now retained
  • Trailing spaces are now trimmed when comparing well keys using the database connection
  • Fixed drag handle behaviour when extending beyond end of screen