Release notes

These release notes cover Harmony Enterprise versions 2021.1 – 2017.1. For prior release information, contact our Customer Care team:

Harmony Enterprise 2021.1 Release Notes

Probabilistic Decline (beta)

Account for production uncertainty by creating decline forecasts for user-specified percentiles (for example, P90 / P50 / P10). You can specify the range of b values sampled. After creating your percentiles, Probabilistic Declines can be modified, exported, and used throughout Harmony Enterprise in the same way as traditional declines.

Quickly produce sensitivities on numerical model forecasts

Previously, numerical model calculations always ran from the beginning of production. Now, when only the forecast parameters have changed since the model was last run, only the forecast period is being recalculated, making the forecast optimization workflow faster. This enhancement applies to all single-well numerical models.

Import of VirtuWell analyses

We now support importing VirtuWell analyses from .harmony files. Existing VirtuWell analyses are imported as the corresponding Optimize analyses. This includes Gas AOF / TPC, Oil IPR / TPC, Pressure Gradient, and Advanced Forecast analyses.

Note: Scenario wellbores in the Wellbore editor are imported as additional wellbore configurations of the Physical wellbore, with a date of 2095 (which can be customized).

Linear Fit Custom Gas IPR

Enhanced line fit for custom table IPR curves. You now have the option to use a linear interpolation in addition to the Forchheimer pseudo-pressure curve fit.

Push IPR from Advanced Forecast to Nodal worksheets

Send up to 10 IPR curves at a time from an Advanced Forecast worksheet to an IPR / TPC worksheet using the new Send To functionality.

Minor improvements and resolved issues from Harmony Enterprise 2020.3

  • Decline forecasts pulled to Analytics Explorer can use a combination of early time daily resolution followed by monthly resolution. A tool can be accessed from the Entity Viewer to easily update existing declines in bulk.
  • An Expand All icon has been added to the Entity Viewer toolbars.
  • The Entity Viewer – Hierarchy now includes a count of the selected wells and scenarios.
  • To save time, the Production vs. Forecast Monitor date defaults to the last day of production.
  • The Analysis Type column has been added to the Results Viewer - Grid View.
  • Analyses in the Analysis Manager are now sorted alphanumerically.
  • Templates and workflows are now sorted alphanumerically.
  • The formula for a diagnostic line can now be displayed as an annotation.
  • The Results Viewer – Grid view has a new icon to export the grid to a .csv file.
  • .hldb files have a size limit of 10 GB. A warning is now displayed when opening projects larger than 8 GB.
  • An option has been added to the Help menu to restore the docking panes and toolbars to their default locations.
  • As Propnum is now a built-in attribute, if a custom attribute exists with this name, it is renamed, which no longer prevents your Harmony Enterprise database from upgrading.
  • Default workflows are now provided if no previous workflows have been created.
  • Fixed the Time axis issue that could occur when Time was on the x-axis, and all axes were changed to Coordinate or Log using the plot’s drop-down list.
  • LocalDB 2019 is now used for *.hldb files (we previously used LocalDB 2014).
  • Gauge depth is now included when copying a Wellbore configuration.
  • The option to “Do not show again” has been added for warnings that are displayed when deleting a worksheet or analysis.
  • To determine how long a license has been in use, the Start Date column in the Current Users dialog box now includes the date and time to differentiate between users who obtained a license on the same day, but at different times (for example, 1 hour vs. 7 hours of use).
  • Fixed a crash that occurred when displaying the Wellbore Configuration column in the Production editor for a group.
  • Drop-down lists in the Options dialog box now display correctly for higher-resolution monitors.
  • CoalAPI and ODBC trace logging can be enabled from the Options dialog box.
  • The build number is now included in the Harmony Enterprise title bar.
Imports + Exports
  • Well Scenarios can now be included when calculating sandface pressures following an import.
  • When importing through the Enerdeq Direct Connection or from .98c files, you can now elect to import oil and condensate data as reported (default setting), or import to a single column (as oil or condensate).
  • Simplified importing from FieldDIRECT, so you can simply browse to your FieldDIRECT database.
  • TLS 1.2 is now the preferred security protocol, which is used when importing from Enerdeq.
  • Added the “New” import option for wellbore data updates. If the “New” option is selected, a wellbore configuration for a given well is imported only if there is no existing wellbore configuration on the same date.
  • When importing analyses from ARIES, a worksheet is only created if one does not already exist, which prevents accumulating duplicate worksheets.
  • You can now specify whether declines imported from ARIES were completed on calendar or operated rate.
  • When configuring a new database import connection, the source database units default to the Harmony global display unit system (that is, field / imperial or metric).
  • The production preview in the Database Import Wizard displays data in the same units mapped for the source database.
  • The option to import new custom attributes and datasets has been changed to deselected by default (applies when importing .harmony and .hldb files).
  • The field “Area Name” has been renamed to “Property” in the Database Import wizard to match the Attributes tab’s field that it is mapped to. Note that existing connections are unaffected.
  • Fixed an issue that caused a custom group to not import, if a member well already existed but with a different internal ID.
  • The fields “Primary Fluid” and “Reservoir” are now included when importing wells from IHDC.
  • Imports from IHDC now support company names that include an ampersand (&).
  • Fixed a crash that could occur when calculating sandface pressures following an import, if multiple wells failed to update due to required inputs being incomplete.
  • The bulk forecast export now includes an option to export with daily resolution when available.
  • When opening the Export wizard or Filters dialog box, selections are only initialized from the Entity Viewer if fewer than 200 wells are selected (otherwise, these dialog boxes take too long to open).
  • Added the option to specify a minimum b value for the initial best fit on a traditional decline.
  • Deleting a reference date now also deletes any classified analyses associated with that date.
  • Added a new parameter “dlim Date”’ for declines with dlim specified. This parameter indicates when the analysis transitions from hyperbolic to exponential.
  • The decline best fit has been modified to allow the dlim Date to occur prior to the forecast start date.
  • The b value of a decline segment with dlim specified can now be finely adjusted through line manipulation.
  • The default setting for several Arps decline analysis fields can now be set in the Options dialog box:

    • Calc Method.
    • Decline rate (dsec vs. dtan vs. a).
    • Limiting decline rate method (dlim exp vs. dlim hyp).
  • Well offsets in Typewell can now be positive or negative, which allows the dataset to be shifted forward or backward.
  • Corrected the plotting on cumulative vs. time worksheets to the end of the period (previously mid-period was used).
  • The default maximum value for b for an initial best fit on a traditional decline analysis is now set to 2 (the previous default setting was 5).
  • You can now set the gridding to be used by default for single and multi-well numerical models in the Options dialog box.
  • For analytical and numerical models that include nf, this parameter now defaults to the Attributes tab value. This parameter is not populated by default for URM analyses, but the Attributes tab value is available in the Defaults and Limits dialog box.
  • The conventional multi-well model has been fixed to immediately update after changes are made to group properties.
  • Fixed the calculation of absolute permeability in URM for gas-water systems.
  • Fixed the calculation of fluid produced for group Typecurves if production includes empty values.
  • FMB correctly uses dry vs. recombined gas for liquid-rich gas wells depending on whether multiphase is enabled.
  • Filtering has been fixed in FMB, so that it is synchronized between all datasets.
  • APE is now disabled for analytical and numerical models until at least one parameter is selected.
  • Fixed the plot headers for Typecurves, so that the current well name is displayed when worksheets are added via a workflow.
  • Corrected the material balance for certain multi-layer numerical models for flow into 0% saturation cells.
  • Parameters in the conventional multi-well model can now be edited in bulk if any of the well names include a “/”.
  • Fixed the broken link to online help from the conventional multi-well model’s gridding parameters.
  • Fixed a crash in the conventional multi-well model that occurred if the reservoir boundary included a cut out.
  • Fixed the crash that occurred when the path to the installation directory included Unicode characters, and a Typecurve was opened. Note that the Typecurve stems are not displayed if this occurs.
  • CBM numerical models are now ignored when importing *.harmony files.
  • Advanced Forecast now defaults to the wellbore configuration active at the forecast start date for wellhead forecasts.
  • Fixed the liquid-loading step calculation, so that it is consistent between the Liquid Loading Monitor and Advanced Forecast.
  • Fixed a crash that could occur when pasting improperly formatted data into the custom IPR table.
  • Forchheimer Gas Inflow now populates with reservoir properties specified in the Properties tab.
  • Flowing Gradient now properly handles simultaneous injection of oil and gas.

Harmony Enterprise 2020.3 Release Notes

The Harmony VirtuWell functionality, Advanced Forecast, has been added to the Harmony Optimize module for our 2020.3 release.

Advanced Forecast leverages your analytical model forecasts from your Reservoir module to:

  • Create and compare dynamic production forecasts
  • Vary your wellbore configurations and their implementation dates
  • Identify liquid loading for wellhead forecasts
  • Generate correlation-based IPRs for any forecast at any time

Minor Improvements

  • Flowing Gradient now supports AGA8 Detail gas PVT tables. If a propane content value is populated using AGA8, this value is populated into the C3H8 Content box in the Hydrates sub-tab.
  • In Gas IPR / TPC, the Wellhead Non-Flowing Pressure analysis now defaults the Average Liquid Gradient to 0.433 psi/ft, reflecting the water static-pressure gradient

Harmony Enterprise 2020.2 Release Notes

Lift-and-shift support for Azure and AWS

We now support hosting Harmony Enterprise on Azure and Amazon Web Services (AWS). Guidance, including requirements and configurations for cloud deployment, is provided for clients who want to set up Harmony Enterprise in the cloud.

Enhancements for multi-well models

Multiple layers for the conventional model

  • Layers are communicating with each other through wellbores only.
  • All layers share the same set of PVT properties and relative permeability curves.
  • Each layer can have its own initial pressure, boundary polygon, and aquifer(s).
  • Geological properties are set up per layer, per well.
  • Each well can be modeled with rate (commingled) or flowing pressure control; layer rates are not required and are not used.
  • Calculated results include commingled well and layer rates; calculated flowing pressures are reported for each layer.
  • Schedule opening and closing of individual layers.

Include the area beyond the lateral for the unconventional model — you can account for the additional matrix region beyond the ends of the lateral, which may be significant for long-term forecasts.

Including the effect of gravity — calculations account for gravity, which is important for multilayer cases with significant flow in the vertical direction. There is also an option to initialize initial pressure distribution according to hydrostatic equilibrium.

Plot enhancements

  • Calculated datasets (synthetic rates and pressures) are displayed on the plots as the simulation progresses.
  • Icons have been added to the plots, so that you can easily show / hide individual phases, which improves readability.
  • To select which plot is displayed, click the Change Plot button on the dashboard.

Clone forecast settings — to copy forecast settings from one well to all the other wells in the model, click the Push Defaults icon. This sets up the model’s forecast quickly.

Analytics Explorer — an enhanced version of Harmony Analytics

Harmony Analytics is being replaced by Analytics Explorer, which in addition to connecting to Harmony Enterprise, can connect to Kingdom and Dynamic North America (DNA). Analytics Explorer contains powerful artificial intelligence and machine-learning tools to gain new insights into your data.

Automatically refresh FMB and URM analyses

Results for flowing material balance (FMB) and unconventional reservoir module (URM) analyses can be refreshed using the Windows Task Scheduler. This ensures the analyses are current after a production update, and are ready to be exported to Analytics Explorer.

FieldDIRECT database import

As specialized views are now generated by the FieldDIRECT database tool, FieldDIRECT data can be easily imported using the database connection.

Optimize enhancements

Flowing Gradient Hydrates tab — the Details table can be accessed without specifying C3H8 content, but the hydrate curve is not displayed.

Oil custom IPR curves — create oil inflow performance relationship (IPR) curves using your field-tested rate data. Fit your historical production with a Vogel- or Fetkovich-based curve fit, or a linear interpolation.

H2S release rate — for oil and gas wells, the H2S release rate is now reported at each operating point in the Operating Points table. This requires non-zero H2S content in the Editors tab, and a specified GOR for oil wells.

Analytics Explorer — the Liquid Loading Monitor results are now included with Analytics Explorer.

Annular gas lift

A new flowpath has been added to calculate sandface pressures when operating an annular gas lift (that is, flow up the annulus, injection down the tubing).

High-resolution displays and Windows scaling

Extensive changes have been made to support high-resolution displays (for example, 4K) and the Windows setting for "scale and layout" greater than 100%.

Release locked entities from the Database Manager

To easily find-and-release entities locked by a user, a “Locks” tab has been added to the Database Manager.

SQL Server 2019 supported for Harmony Enterprise databases

The following SQL Server versions are currently supported for deployments on premises: 2014, 2016, 2017, and 2019. If SQL 2019 is to be used with an existing Harmony Enterprise database, we recommend migrating the database to SQL 2019 before using the Harmony Database Manager to upgrade it to the 2020.2 version.

Note:   Before you can deploy Harmony Enterprise with Well Security, you need to have SQL Server 2016 or later.

Resolved issues and minor improvements from Harmony Enterprise 2020.1


  • Sorting of numerical columns on the Monitor tabs has been corrected (previously, numerical columns were sorted alphanumerically).
  • Progress bars are hidden when the application is minimized and are displayed when the application is restored.
  • Improved the positioning of annotations when printing plots as the plot is being stretched.
  • When starting Harmony Enterprise, folder permissions are checked for existing database connection imports, so that if a user makes any changes, these changes can be saved.


  • The database import option “Days to look back” is now supported when connecting to an Oracle database.
  • The database import option “Days to look back” no longer fails, if the source database has spaces in the column names.
  • In addition to being written to the Harmony.log file, warnings are now displayed in the Status Window when importing production with duplicate dates through the database connection import.

Decline and Typewell:

  • The following Typewell and Decline plot customizations now persist: axis titles, gridlines on / off, and dataset properties (for example, color).
  • The tooltip for Decline analyses is now accurate when hovering over the analysis line, and the tooltip does not display erroneous information slightly beyond the start or end of the line.
  • When exporting declines using the Energy Navigator format, the primary fluid in Harmony Enterprise is honored in the export, regardless of the decline fluid types included for a well.
  • The size of the Set Axis Ranges dialog box in a Typewell analysis has been reduced to ensure it is visible regardless of screen resolution.

Typecurves, URM and FMB:

  • Fixed well Typecurve calculations: gas typecurves that used pseudo-time and had water drive were handling shut-ins incorrectly.
  • Fixed group Typecurve calculations: the last data-point before each shut-in was plotted incorrectly.
  • Fixed group Gas Condensate Typecurve calculations: cumulative volumes of dry gas were used instead of using recombined gas cumulative volumes.
  • Fixed the “improper argument” when adding a Water Drive to Gas Compound Linear Typecurve that did not have OGIP defined.
  • Bilinear flow parameters on a URM worksheet are now calculated when a Fourth Root Time plot is added.
  • Diagnostic lines now persist on URM worksheets when the multiphase option is selected or deselected.
  • The liquid loading filter is now available for scenarios.

Numerical models:

  • Fixed a calculation issue with multi-well models when running a forecast with injection rate control: in some isolated cases, wells failed to switch to pressure control after the pressure reached the maximum injection flowing pressure.
  • Historical production ratios on numerical models were incorrectly plotted when the production included preceding zero rates.
  • Multi-well model injection rates can now be displayed on Decline and Forecast worksheets.
  • The default well order for unconventional multi-well models has been improved for the cases when deviation surveys contain Easting and Northing and some of the wells in the pad are drilled in the opposite direction than the rest of the wells.
  • The setting to allow kSRV < kmatrix has been extended to the refrac option for fracture extensions.


  • Fixed a crash on the Flowing Gradient worksheet when copying the Details tab’s grid from the top-left cell.
  • Critical rate is now calculated consistently on the AOF / TPC worksheet between the plot and operating points table.

Harmony Enterprise 2020.1 Release Notes

Harmony Optimize™ is now available — our latest module for integrated engineering solutions

Our newly developed nodal analysis module empowers engineers to do a deeper dive into their wellbore and deliverability studies, with a multi-well approach for more efficient analysis. This module within the Harmony Enterprise platform will be expanded with subsequent releases, to include capabilities such as choke modeling and artificial lift design. The first release of Optimize includes the following capabilities:

Liquid loading monitoring:

A multi-well tool for liquid loading prediction based on your models’ forecasts. Leverage your existing models to predict liquid loading for a group of wells, and quickly sort and prioritize them for possible workovers. Reported results include:

  • Liquid loading onset date within the forecast of each well.
  • Gas rate, wellbore diameter, and percentage drawdown at the time of liquid loading.

Since both rates and pressures are required, only analytical and numerical models with positive gas rates are supported.

Flowing pressure gradients

Understand the unique pressure distribution along your well for a specific combination of wellbore configuration and operating conditions.

  • Perform flow assurance evaluation for each well configuration to predict hydrate formation, liquid loading, or erosion along the wellbore.
  • Access detailed diagnostic parameters for a comprehensive wellbore analysis.
Generate inflow-outflow well models

Produce and optimize your wells in a more efficient way by estimating their productivity for current and future wellbore configurations, using nodal analysis. The following models are supported:

  • Gas well: Forchheimer, Simplified C,n, and custom table
  • Oil well: Vogel

More models will be available in subsequent releases.

Decline analysis enhancements

  • Declines can be created on cumulative vs. time plots and then adjusted using line manipulations, parameter edits, or a best fit. Note that this enhancement has not yet been extended to Typewell worksheets.
  • Line manipulation support has been added for declines with a dlim.

Performance improvements

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

  • Delete large groups of wells.
  • Paste large datasets into the Attributes tab.
  • Display attributes that reference production data, which are found under the Cumulative Volume node in the Attributes tab.

Identify active wellbore configuration

The Production editor can now display the wellbore configuration used at each timestep

Miscellaneous improvements

  • Improved scaling in flowing material balance (FMB) and unconventional reservoir module (URM) plots.
  • Added a Probabilistic setting to control the number of threads used during simulation, which can alleviate running out of memory for intensive cases, or unresponsiveness in other applications.
  • Query supports adding a list of pasted values without first selecting them.
  • The conventional multi-well model now supports shapefiles with polygon z and polyline z formats.
  • Added the column “Sandface DLS (Unformatted)” in Harmony Analytics to link wells from Harmony Enterprise and Accumap together in Spotfire.
  • Improved usage of the tempdb to prevent running out of space.
  • Since an *.hldb file cannot be extracted to a universal naming convention (UNC) path, users are now prompted to select a different location, if a UNC path is specified.
  • Adjusted sandface pressure calculations when the Ovalle correlation is selected. Previously, two methods were being used to calculate the formation volume factor (Bgd), which might overestimate frictional pressure loss. Our solution was to remove the extraneous Bgd calculation.

Resolved issues from Harmony Enterprise 2019.3

  • Changed the units on the Database Connection preview plot to match the mapped import units.
  • Resolved duplicate rows being loaded for forecasts in Harmony Analytics.
  • Probabilistic P90, P50, and P10 forecasts are updated outside of the model when the filter is adjusted.
  • Dataset customizations persist in the Diagnostics tab when moving from a single well to many selected wells.
  • Fixed Typewell rate / cum per attribute values on reload.
  • Condensate saturation is included with reservoir defaults for horizontal multifrac (HZMF) numerical models.
  • For FMB plots within the URM analysis, the plot title and scaling when imported from *.harmony files has been fixed.
  • Fixed unintended symbol changes within FMB, URM, oil material balance, and gas material balance plots.
  • The batch size can be customized when importing *.hldb and *.harmony files to prevent running out of memory.
  • Fixed a crash that occurred on the Analysis tab, if a linked analysis included two declines and a ratio trend.
  • Fixed a crash that occurred in Reporting, if a given well had two linked analyses, and each linked analysis contained two declines.
  • Fixed the situation where a scenario did not get created under a well, if the well had a linked analysis with two ratio trends.
  • Fixed a crash that occurred when exporting wells to Piper without an analysis.
  • Fixed the situation with discarded data during import. If the production option was set to "Discard and Replace" in the Database Connection and a lookback period was specified, that data was discarded for this period but not replaced.
  • The Wellbore editor no longer crashes if no configuration is tagged as the initial configuration.
  • If production was appended in 2019.3 using the option “Append from last production date”, declines on wells that were updated were unavailable using any of the export tools, which includes Harmony Analytics and Forecasts. This behavior when updating production has been fixed, but impacted analyses must be reloaded before they are available for export. To quickly fix this situation, please contact customer care, if your project has been affected.

Harmony Enterprise 2019.3 Release Notes

This release has the following features:

Introducing Harmony Analytics

Harmony Analytics provides an interactive connection between Harmony Enterprise and TIBCO Spotfire®. You can send Harmony Enterprise data to Spotfire, or enhance existing Spotfire projects by pulling data from Harmony Enterprise, making this connector applicable to Harmony and non-Harmony users. Results or identified wells can also be sent back to Harmony Enterprise for further investigation.

Trend ratios to forecast secondary fluids

Use multi-segment linear trends on a log or coordinate scale to extrapolate ratio behavior. These Ratio Trends can be linked to a traditional decline analysis to create a secondary fluid forecast. For example, a GOR trend can be linked to an oil decline or gas decline to calculate a rate forecast of the other fluid.

Create Typewell worksheets of fluid ratios and apply a Ratio Trend to establish average ratio behavior for your groups. These trends can be copied and applied to individual wells.

When connecting to an ARIES database, time-based Ratio Trends connected to a decline analysis are imported. Ratio Trends that are linked to a traditional decline analysis can also be exported to a text file in an ARIES-readable format.

Import enhancements

  • Added an option to discard all existing data during an import. For database imports, a look-back duration can be specified, only discarding the specified length of data starting at the most-recent date within the source database.
  • Removed the requirement to map production data during a database import, so database imports of only attribute data are possible.
  • Automatically include new wells added to your source database by selecting the option “All Present and Future Wells” within a database import. This is especially important when scheduling updates.
  • The batch size can now be customized when importing *.harmony, *.hldb, or text files to support wells with higher frequency data.
  • Improvements to well linking (merging) logic reduce the need for you to manually link wells:

    • You can customize which Entity Header attributes are used to merge incoming data with existing wells, including which attributes are used, and in what order. This customization is available when using the database connection, and for text, *.harmony, and *.hldb file imports.
    • Updated well-linking logic to handle null attributes and non-unique matches.
    • Added the Entity Header attributes Propnum and External Well Key. These attributes can be imported, used to merge incoming wells to existing, and used as the Display Name. When importing from an ARIES database, PropNum is mapped to both the External Key and PropNum fields by default.
    • An incoming attribute can be mapped to multiple Well Information fields in a database connection import. This is important when the incoming attribute is used as the Well Key and is used to populate the well header field.

Introducing Harmony Optimize

Our next-generation nodal analysis package has been branded as Harmony Optimize. This will be available upon request with the 2019.3 release for clients interested in trialing and sharing their feedback. When this module is licensable in 2020 it will also include Pressure Gradient and Advanced Forecasting capabilities. The 2019.3 release includes Gas AOF/TPC and Oil IPR/TPC analysis methods, which can be used to determine the expected operating point under different scenarios.

Enhancements for multi-well models

  • Ability to model Volatile Oil reservoirs: both the conventional and unconventional multi-well models are applicable to volatile oil cases.
  • Fracture completion for the Conventional multi-well model: you can model vertical fractured wells, along with vertical and horizontal wells.
  • Ability to modify gridding for the Conventional multi-well model: you can modify some of the gridding parameters to increase speed or accuracy.
  • Push defaults button: you can quickly set up a model by copying parameters from one well to another well, or to all other wells.
  • Additional parameters on the Shaded plot: for conventional multi-well models, you can now display values for Net Pay, Porosity, and Permeability, as well as Pressure or Saturations.

Bulk rename analyses and worksheets

It is important to have consistent naming when exporting analyses, building visualizations outside of Harmony Enterprise, viewing results on a diagnostic map, etc. To quickly correct existing work, the Bulk Editor now supports changing analysis or worksheet names for multiple wells simultaneously.

Typewell enhancements

Cumulative production can be normalized by an attribute when on either the x- or y-axis.

Export and merge reserve analyses

Previously, the export to *.hldb and import of *.hldb files excluded analyses with reserves classifications. This included traditional decline analyses and forecast consolidations with a classification set. Now, the import / export of *.hldb files has been updated as follows:

  • When exporting to *.hldb, all reference dates and the classified analyses associated with them are exported. The current user’s active reference date is also set.
  • When importing from *.hldb, the current user’s active reference date and all associated classified analyses are imported.

End Date consistency in linked declines

When linking traditional declines of multiple fluid types, the primary fluid now determines the end of the forecast, and all other declines automatically update to maintain a consistent end date.

Installer command line options

The following settings and inputs can be specified as command line arguments when installing Harmony Enterprise:

  • Application type: Harmony Enterprise vs. Harmony Enterprise SE.
  • Universal and application licensing server URLs.
  • For each license, specify the initial checkbox state to get a license during the application’s startup.
  • For each license, we provide the option to show / hide the checkbox used to automatically get a license during the application’s startup.

Resolved issues from Harmony Enterprise 2019.2

  • If the option to calculate sandface pressures was selected when updating production data for existing wells, sandface pressure calculations could be incorrect as the pdew = pbp condition was enforced after the sandface pressure calculations. This has been fixed.
  • Resolved the crash that would occur when virtualizing the application with more than one user viewing Typecurves.
  • Exclusive to 2019.2, a database constraint was removed, which previously prevented duplicate production records from being saved. This constraint has been reinstated.
  • Fixed numerical model forecasting, which would stop when pressure dropped below atmospheric pressure.
  • Fixed numerical model synthesis, which could prematurely end when using Ovalle.
  • Harmony Enterprise no longer crashes if it does not have permission to update a scheduled database import task. If this occurs, an error is written to the log file.
  • Fixed a defect where under certain conditions, multi-well models were failing to forecast gas injection when using pressure control.

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 behavior when extending beyond end of screen