6.30.3163#

SDK Version attached to KAPPA-Automate 6.30.3163 is version 6.30.5715.

New Features#

  • BlackOilPVT — new subclass of PVT for black oil fluid models. Exposes fluid_type, reference_phase, has_oil, has_gas, has_water, parameters, properties, flash_black_oil_process(), get_artm_parameters().

  • EosPVT — new subclass of PVT for EOS fluid models. Exposes eos_parameters, flash_inputs, flash_eos_process().

  • BlackOilPvtParameters — new class representing one time-dependent parameter set for a black oil PVT. Accessible via BlackOilPVT.parameters.

  • EosFlashInput — new class representing a stored EOS flash preset (temperature, pressure, options). Accessible via PVT.flash_inputs.

  • EosPvtParameters — new class exposing EOS model configuration (EOS type, number of components, viscosity model). Accessible via PVT.eos_parameters.

  • EosTypeEnum — enum of supported EOS types (Srk, PR2, Gerg2008, PcSaft, Cpa).

  • EosViscosityModelEnum — enum of supported EOS viscosity models (LBC, LBCHeavy, LittleKennedy, Pedersen, Ducoulombier, PedersenHeavy, Chung, Kestin).

  • PVT.parameters — returns a List[BlackOilPvtParameters] with all time-dependent parameter sets (black oil only).

  • PVT.flash_inputs — returns a List[EosFlashInput] with stored flash presets (EOS only).

  • PVT.eos_parameters — returns an Optional[EosPvtParameters] with EOS model configuration (EOS only).

  • PVT.reference_phase — new property exposing the reference phase (black oil only).

Bug Fixes#

Improvements#

  • Data.read(), Data.read_cumulative(), Data.read_by_chunks(), Data.read_cumulative_by_chunks() — the timezone parameter now converts returned dates from UTC to the requested TimezoneEnum timezone using zoneinfo.ZoneInfo.

  • Data.append() — new timezone parameter converts dates from a specific TimezoneEnum timezone to UTC before writing. Naive datetimes are assumed to be in the given timezone; aware datetimes are converted directly.

  • Data.overwrite() — new unit and timezone parameters, forwarded to Data.append().

  • DataQueryService.read_vector() — new timezone parameter converts returned dates from UTC to the requested TimezoneEnum timezone.

  • DataCommandService.add_values(), DataCommandService.replace_data() — new timezone parameter converts dates from a specific TimezoneEnum timezone to UTC before writing. Naive datetimes are assumed to be in the given timezone.

Breaking Changes#

  • PVT.reference_pressure, PVT.reference_temperature, PVT.oil_gravity, PVT.gas_gravity, and PVT.water_gravity have been removed. Use BlackOilPVT.parameters instead (pvt.parameters[i].reference_pressure etc.).

  • PVT is now a base class. Well.pvts and Field.pvts return instances of BlackOilPVT or EosPVT. Update type annotations accordingly (pvt: PVT remains valid; narrow with isinstance(pvt, BlackOilPVT) or pvt.type == PVTTypeEnum.black_oil).

  • Model books have moved from Well to Document:

    • Well.model_books → Document.model_books

    • Well.create_model_book(document, name) → Document.create_model_book(name) (the document argument is no longer needed)

    • Well.delete_model_book(model_book) → Document.delete_model_book(model_book)