Petro.ai Documentation 4.3

# Changelog

# 4.3.2 Release

December 16th, 2019

# Application and WebApp Fixes

ARIES Export

To correct the issue where the ARIES export allows 0 forecast to exist will require the user to drop those models and recalculate using the Single Well Forecast.

Security

The jobs page is now accessible and visible only to administrators.

  • Fixed bug where QI was not captured for exponential models.
  • Fixed bug where an autoforcasted well could have -infinity for Qi.
  • Fixed bug where ratio declines would not import properly.
  • Fixed bugs relating to exporting ratio declines (impacts Single Flat, Plateau, and Incremental Increase to Life).
  • Resolved issue in PetroPanel were all of the action buttons for data function loaders were missing.
  • Jobs views/pages now follows a more linear path to access each page. Cleaned up some of the UI element lifecycles for job pages.
  • Fixed a bug that intermittently showed the wrong status on jobs (i.e. running when complete or failed).
  • Fixed a bug that prevented PATCH requests to /api/Jobs from updating the job payload.
  • Fixed an issue that caused job logs to overwhelm database--job logs are now limited to last 10,000 logs.
  • Fixed a bug that caused recurring jobs to be run after their end date.
  • Fixed a bug that allowed for a job to be created without a name.
  • Fixed a bug that showed running results for the last execution of a jobs on a recurring schedule, jobs that were deleted.
  • Updated the badge coloring on job results page to reflect overall job status coloring.
  • Comments Service has been restored after correcting CORS policy issues.

# 4.3.1 Release

December 10th, 2019

# Application and WebApp Fixes

  • Zoom buttons were returned to the map page enabling incremental zooming.
  • Resolved an issue where users were unable to submit a model after having retracted their submission.
  • The Spotfire extension, PetroPanel, would previously not allow the edit of data functions. This and other data function lifecycle issues were resolved.
  • The 'Months On' option now displays a badge with the type of normalization to provide context for the user.
  • Map type curve editor no longer throws error when opened, curve now generates when prompted.

# 4.3.0 Release

December 2nd, 2019

# Drag-and-drop file loading

We are pleased to announce the ability to drop files into Petro.ai directly. Now users can load well headers and production directly into their petrons. Once loaded, the files are mapped to the Petro.ai data types and instantly usable in the web application, REST API, as well as the Spotfire extensions. Think- I can go from a CSV to a forecast in minutes!

# Overview and Item pages

The overview page has been updated to show production history and what's more, you can individually select wells to view their own detailed production volumes. The well pages are accessible from the forecast table and inside the Single Well Forecast app.

# Geomechanics Toolkit

A new tab is available for tools. In this pass, we've introduced the density stress log tool which allows you to calculate stress from vertical density logs. Use well log data, set the parameters that affect stress such as pore pressure gradient and faulting regime, and then analyze the stress polygon, pore pressure, and other stress measures.

# Application and WebApp Fixes

  • Significant functional improvements to the jobs manager; improved progress reporting, large query performance via connectionTimeout flag, and restored job scheduling and recurring runs.
  • Updated workflow when creating and executing jobs to take user back to jobs table. Added toast notifications about actions and errors as they occur.
  • Fixed a bug that preventing portal.petro.ai from loading after signing in with a Microsoft account that was not tied to a portal organization. Users can now log out if they accidentally logged in with an incorrect Microsoft account.
  • Added additional log outputs to the following jobs: Load Well Data, Load Well Identifiers, Load Monthly Production, and Load Daily Production. Jobs that are completed in batches now show additional information about the batch.
  • Fixes issue where wells newly added to a petron would appear to be attached but then disappear.
  • Fixed several issues with the single well forecast input fields: resolved issue with q values not changing, resolved issue with De input field disapearing, and resolved issue with chart comment box not closing.

# 4.2.6 Patch

November 18th, 2019

# Application and WebApp Fixes

  • Decreased the load time when moving from one well to the next from within the Single Well Forecast tool.
  • Corrected an issue regarding the export of ratios from the Single Well Forecast tool to ARIES.

# 4.2.5 Patch

November 11th, 2019

# Application and WebApp Fixes

  • Fixed an issue where opening and adding wells from the Overview page was causing the application to stall.
  • Reduced the impact of removing wells from the Map page.

# 4.2.4 Patch

November 6th, 2019

# Application and WebApp Fixes

  • Resolved an issue where Swagger API documentation was not building in the application; users were unable to view the API from the on-premise Petro.ai.

# 4.2.3 Patch

November 4th, 2019

# Copying behavior

Copying behavior from filter menu has been clarified:

Item Description
Copy wells table This affixes the entire wells table on that Petron to your clipboard.
Copy marked wells The well identifiers of the wells selected, regardless of the filtering, will be affixed to the clipboard.
Copy filtered wells The well identifiers of the filtered wells, regardless of the marking, will be affixed to the clipboard.
Copy selected filtered wells The intersection of well identifiers, marked and filtered, will be copied. You can think of this as the 'visibly selected' wells to the right.

# Application and WebApp Fixes

  • Fixed issue where adding and removing wells didn't refresh on the map. The marker will now change to the primary color once added.
  • Resolved issue where basic authentication failed on newer endpoints.
  • Fixed issues with dropping web sockets- a major improvement to the stability of the platform.
  • Fixed the time window computation for Model flag and R^2
  • Added different metrics, and using Kendell Tau^2 instead of Pearson Correlation Coefficient^2 to evaluate the performance. Can easily switch back to R^2 if needed.
  • Selection issues on the forecast table have been resolved. The Select All feature present matches the Select All on the data browser table.
  • Uploading models from ARIES will now create fit evaluation flags on the model.

# Spotfire Extensions Fixes

An issue with binning on the DCA Wrangler was resolved. Previously, binning used a fixed size of 30.5 days bins by default, while technically sound, makes visual verification of the type curves quite difficult. This strategy would lead to grouping multiple month production data into the same type curve bin, introducing slight intermittent deviation of the type curve from the actual production curves. Our solution to that has been to introduce a new option called Binning Strategy in the Decline Parameters tab in DCA Wrangler.

# 4.2.2 Patch

October 28th, 2019

# Selection Tool

Add and remove wells from the Map page using the new and improved selection tool. The arithmetic selection modes automatically add and remove wells from the Petron. You can use Ctrl to add and Shift to delete.

# Application and WebApp Fixes

  • Forecast will now fill in gaps present in production data with null values.
  • Fixed bug where transitioning from map page to forecast page would trim selection to the filtered selection.
  • Added Append and Remove lasso modes.
  • Added the ability to Ctrl + Click a single well into the selection
  • Fixes bug that caused map styling to change when altering the state of the petron from the map page. Affectionately known as 'wild mode'.
  • Added Petro.ai version to the bottom of the left drawer.

# 4.2.0 Release

October 21st, 2019

# Power Law Decline Modeling

Power Law Exponential (PLE) Model is first in a series of models that will account for changing loss ratio (1/D) and changing derivative of the loss ratio (b factor) with respect to time.

This is in contrast to Arps model which assumes them to be constant. We are releasing this for the segment editor in the Single Well Forecast.

# Application and WebApp Fixes

  • Well markers correctly refresh after adding and removing wells from the map
  • Fixed an issue where Basic Auth was failing on newly created REST endpoints
  • Batched the selection of SignalR messages to the backend when a selection event has occurred.
  • Fixes bug that caused the Petro.ai tab to crash while visiting the map page and viewing type curves.
  • Removes context menu from appearing on cards in the Petron Map
  • Moved the Petro.ai version to the bottom of the left drawer.
  • User interface for the SWF segment editor has been cleaned up and condensed. Menu buttons on the top bar are now highlighted purple when opened. The Petron filter button now shows the total number of filters that are active. Filters can now be removed via the Petron filter button. SWF chart header options have been condensed into drop downs. Unused, the SWF download button dropdown has been removed.
  • Improves map panning experience when zoomed in on a region

# 4.1.1 Patch

October 14th, 2019

# Global Forecasting Limit

This setting allows an administrator to throttle the number of wells that the server will process at a given time. The limit acts as a knob for controlling the amount of load an administrator is willing to allow the server to go under.

  • If the server is small, this limit should be decreased as it can result in stability issues.
  • If the Petro.ai manager is deployed on a more powerful server, it would make sense to increase this limit. From a user experience perspective, they will see a longer time to forecast if the server is under a heavy load as forecasts will be queued until there is enough space available or the admin increases the forecasting limit.

# Application and WebApp Fixes

  • All data type fields in data browser are now shown by default.
  • Flood of toaster messages was handled in the changes to background task reporting. Should see far fewer green popups and red only when necessary.
  • Fixed issue where data browser delete feature not working.
  • Fixed issue where 'Copy Filtered Wells' button wasn't very obvious.
  • Added a clear button to Petro.ai Filter panel.
  • Added improvements to the column selector window.
  • Selected wells from Map or elsewhere now percolate to the top of the forecasting table.
  • Confirmed filter settings propagate to correct well counts when selecting all in the forecast table.
  • Removed unused features from User Profile page.
  • Fixes bug that caused the Petro.ai tab to crash while visiting the map page and viewing type curves.
  • Notification tab text has been lightened to better accommodate dark theme.
  • Deleting documents via the Data Browser is now limited to portal administrators only.
  • Adds a global forecasting limit to the app settings.

# 4.1.0 Release

October 7th, 2019

# Application and WebApp Fixes

While this is not an exclusive list, it incorporates many of the requested enhancements over the development period. Feel free to contact support regarding any specific feature below or not listed.

  • Tooltip no longer shows the petron name and now shows the curve name.
  • Fixed the bug preventing data from sorting in the Data Browser table. This change required changes to all tables so testing on all tables should be performed. Now it looks for correct pagination, rows per page, and sorting functionality.
  • If there is no value for a stream, the Single Well Forecast plot will no longer list that stream in the tooltip.
  • ARIES exports to monthly units instead of daily units.
  • Adds Merge Extra Options to jobsAdds ReplaceExtra flag in PUT and PATCH methods in the API. Adds unique index on time and PWI to Rig Data and Real-Time Production. Now adds all valid data when inserting with bad data
  • Added pagination to cases detail page
  • Applying a saved decline curve template will no longer replace the start date. Start dates can now be added manually.
  • Resolves Cosmos Hangfire Job issue by removing StringEnumConverter from JsonConvert.DefaultSettings
  • Aries Export Arps now exports De.
  • All models (single well/type curve) can now be layered on a SWF.
  • Fixed an issue in the type curves where arbitrary spikes were occuring. The resolution involved correcting the way normalization occurred in the data model.
  • Selected compared models are saved so when navigating away and then back to well the compare models will persist.
  • Probit Tooltips fixed, decimals adjusted, labels added to tooltip for additional clarification.9/24 Went back and formatted tooltip numbers with commas.
  • Fixed issue where datafiles provided conflicting API entries. The third file does not have the API/UWI entry. Manually changed the two files to have the same API, and the data gets loaded as expected. Just added an additional check for empty string to have a more robust implementation.
  • Load XYZ job will now batch the data sent to the database. If the job is re-run with the same data set, the previously loaded data will be removed before the load job begins. Additional logging has also been added to the job.
  • Added a new job parameter idField which can be specified to pick the right wellId field from the LAS files. Fixed the bug that prevented queued child jobs being ignored if IdField is null, use an intelligent parser to use the right field in the orderwellId > wellApi > wellUwi > fileName
  • Added flag for fit evaluation of a well's primary product.
  • Added a section to easily view a well's primary product. If no primary product was listed, the user can see that notification.
  • Fixed the Drilling Shoe Tracks to have the correct KPI states.
  • Fixed issue where can't load WellLogDataPoints from Marking in PetroPanel. Users can now look up by well and return all of the associated well logs, then by then individual ID.
  • A small number of tooltip changes: Added to the tooltip Well count; removed daily. Added as a label to actions bar and tooltip now correctly reflects rate.
  • Fixed a bug preventing documents from being selected within the data browser. Added ability to search for documents of a certain type. Updated column selection to show all by default with the ability to save columns for each data type.
  • "Job Create" form now resolves job type when pasting job parameters into the editor. Adds more visual clarity when a user can and cannot edit a job's parameters. Minor UI updates to the job details page.
  • All data type fields in data browser are now shown by default.
  • Flood of toaster messages was handled in the changes to background task reporting. Should see far fewer green popups and red only when necessary.
  • Confirmed filter settings propagate to correct well counts when selecting all in the forecast table
  • Added e3m3, km3, mcf, mmcf, bcl, mbbl, mmbbl and associated rates.
  • Load extra for RigData works correctly now.
  • Users now have the ability to leverage Global Effective Dates inside the application. Administrators can opt that Petro.ai will override the forecast cutoff date at the single-well forecast level or the batch forecast level. This new term, Volume Abandonment date, propagates throughout the application, forecast length is then grayed out.
  • Fixes issue where jobs not found would cause a fatal crash
  • Fixed issue in DCA where the scrollbar was missing in Type Curve. Modified the layout to fix margins.
  • Resolved data issue with decline curve result table output
  • Inactive decline badge has been added to the well stats table. After setting a decline to inactive the metadata should show an inactive decline flag, and the user should see a toaster.
  • Identifier type is no longer required when loading in well Identifiers. If no identifier type is provided, 'Other' is applied
  • Added the ability for users to truncate curves to the last date of production when exporting to ARIES
  • Chart comments are now linked to the PWI. Chart comments are no longer shown in the SWF Comments sidebar.
  • Updated API calls for all Petrons that were using UPDATE methods.
  • Added e3m3, km3, mcf, mmcf, bcl, mbbl, mmbbl and associated rates.
  • Fixes bug on fresh installs where a unique index on wellId in prod.RealTimeProduction and drill.RigData disallowed creating new documents.
  • Removed the unused wellGroupId field from the DCAM document. There is no way to track how wells got into the Petron so this field is not able to be used.
  • Fixed issue where removing a group deletes everything from the Petron, even if that group isn't in the Petron. Resolution was to change well group lookup to use well identifiers instead of wells.
  • Batch decline now honors units
  • Incorporates ROP and MSE into the regular schema in WITSML-produced Rig Data
  • Adds exception handling to ensure that when something happens the loader will eventually loop back and pick up remaining data points if something did occur.
  • Fixes issue with comments not showing the correct user for each action in a model's history.
  • Fixes issue in Forecasts Details page with donut chart still appearing when all Wells have been removed from a forecast
  • Added envIds to JWT payload and removed token verification check for user envIds. This check for envId is now performed in PetroAuth.
  • Cumulatives are now calculated when creating a well forecast
  • Job will now check for the existence of a primary product, or it will calculate the primary product on export
  • Fixed the submission of comments when the mentions is still open. Also fixed the arrow navigation for tags, but could not make the arrow navigation for mention working. Also, for reply comments, arrow navigation does not work. For now, c;losing the bug. May want to create new bugs about reply comment and arrow navigation.
  • Added a check for invariant culture in units serialization to handle the case for -Infinity, Infinity.
  • Fixed this at the same time as a related bug; if the last comment was deleted from a page, it would be successfully deleted from the database, but it would still appear in the UI until the browser was refreshed.
  • Changed so the zoom level is preserved; also in the case of deleting a comment.
  • Fixed issue with end criteria button.
  • ESC should now cancel the fullscreen view, provided nothing else in the wrapped components is capturing the key event.
  • Updated data tables to check for selection prop before showing select all buttons.
  • Forecast options discrepancy has been fixedApart from that, the root cause of the problem was just that the rates data is not correct due to incorrect conversion of units. No problem at our end.
  • Fixed bug that prevented users from being able to export multiple Petrons to ARIES.
  • Added index to tables to sort them consistently.
  • Filter drop downs are now searchable and show all items.
  • Fixed a bug that made the search bar in the PetroPanel behave sluggishly.
  • Fixed issue with Petro.ai not starting as a service.
  • Fixes issue where spinner would never go away on reports that had completed.
  • Added flat to aries export when exporting inactive.
  • Added extra check at the FilterWidget to handle duplicate entries.
  • Fixed bug with pulling from the petron store's child state.
  • Changed export format in ARIES to MM/YYYY.
  • Modified store to get Petrons only if Owner, Assignee, Approver, or Public. Fixed bug where first created petron was shown twice.
  • Administrators can see all Petrons in the library. Petrons are now marked with icons indicating private vs. public.
  • Fixed issue where wells with less than 12 months data wouldn't have a model created. The model gets created, though the flags show Insufficient Data.
  • Added the nrmsd, got rid of Accuracy and also changed the color for 'Excellent'.
  • Updated SWF to select well primary product stream on load if present on the well.
  • Fixed the summarize function to respect the decline parameters.
  • Fixed a bug that prevented filter ranges from working correctly.
  • Fixes bug that changes all states when submitting from SWF.
  • Fixed aggressive input field on the segment editor. The value now reformats on blur (i.e. focus loss) rather than each time the user types a character.
  • If a user is missing an organization they will not be issued a petroai-token.
  • Users can now hit ENTER to trigger reactivity when entering decline parameters in SWF mode.
  • Fixed most of the key items regarding toggling WGR and GOR. Removed ratio from auto-forecast. Remove arps as option on streams De/Di updating
  • Forecast years input in App settings are now locked when not in edit mode.
  • Adds logic to check if segment needs end@ duration.
  • Fixed bug when removing start date.
  • Added support for Flat and Values ratios. Updated ARIES import/export to handle ratio streams.
  • Fixed a bug that prevented new comments from being shown when clicking a notification while on the page where the comment is made.
  • Made default sort order to be oil to gas to water. Also modified data tables to sort when clicking title.
  • Fixes first boot issue that caused database writes to incorrectly write units
  • Replaced the complex index (wellId and time) to two single indices. These indices get invoked and prevents the entire collection from being loaded into the memory. After this change, the load job runs fine without throwing the RAM error.
  • Fixed issues with connecting to database via PetroPanel.
  • Bug that caused incorrect ARIES syntax when exporting truncated decline curves was fixed.
  • Autoforecasting no longer returns infinity qi values.
  • Fixed the iterator logic to properly handle the edge cases. Also updated the tests.
  • Fixed a bug that caused Petro.ai to stop if the Portal could not be reached. Petro.ai will now attempt to server license checks with the Portal for 5 days before stopping.

# 3.4.0 Release

April 8th, 2019

# PetroSuite

  • Added a confirmation for deleting data from the PetroSuite browser which shows the impact of deleting data before it is removed

# ML Modeling

  • Users can now provide range options for sensitivity analysis
  • Fixed a bug where null values were sometimes being interpreted as 0

# Jobs

  • Added Merge Extra Options to jobs. In the extra data object for the for the job, you can now store all with the option to merge (append to) or replace with existing extra data
  • Added helpful Job descriptions on the Job Manager page
  • Added StartDate and EndDate job parameters to the Process Rig Data Job
  • Added unique index on time and pwi to Rig Data and Real Time Production
  • Added logic to Drilling State Classifier for "Drilling Shoe Track" state
  • Jobs now adds all valid data when inserting with bad data

# API

  • Added PUT for WellDrillingEvents
  • Added ReplaceExtra option in PUT and PATCH methods

# 3.1.0 Release

February 8, 2019

# PetroSuite

  • [beta] Added Machine Learning! Now save your ML models and share with colleagues. Predict right in the web with Petro.ai!
  • Added Display Time Zone setting in PetroSuite application settings. All times displayed in PetroSuite and all data accessed via the PetroCore API will be converted to this timezone
  • Added ability for PetroSuite to send notification emails through an SMTP without authentication (anonymously). To connect to an SMTP server anonymously simply remove the SmtpUsername and SmtpPassword fields from the manager-config.json or leave them blank
  • Fixed a bug that caused the Rig Viewer to pull new data every time the Rig Data Sampling Interval field was changed

# 1.2.0 Release

December 17, 2019

# PetroSuite

  • Added Email alerts for job success and failure configurable by super admin via Settings -> Notification Settings
  • Added job variables to store frequently used strings in job files
  • Added SMTP email server connection status to Settings -> Info
  • Improved API documentation with fields required for units
  • Removed the "Try it out" button on API documentation on all methods except GET
  • Added response type of application/json to API documentation
  • Consolidated settings under a single collapsable settings menu
  • Changed default temperature unit to use deg instead of degree symbol (e.g. degC rather than °C)
  • Fixed a bug that returned caused a 404 error to be returned when initially loading PetroSuite
  • Fixed a bug that caused a console error to be shown when viewing Petro.ai Info

←