pyscnomics 1.4.0

An economic engine for calculating PSC Scheme in Indonesia.

Overview

PySCnomics is a package contains tailored functionalities for assessing economic feasibility of oil and gas projects following the state-of-the-art Production Sharing Contract (PSC) schemes in Indonesia.

Developed through a collaborative research between Indonesia's Special Task Force for Upstream Oil and Gas Business Activities (SKK Migas) and the Department of Petroleum Engineering at Institut Teknologi Bandung (ITB), PySCnomics stands as a reliable solution for industry professionals.

Installation

To install PySCnomics, simply run:

pip install pyscnomics

Key Features

PySCnomics offers comprehensive capabilities to evaluate the feasibility of various Indonesian PSC contracts, including a wide range of regime variations of each contract:

• Base Project
• Cost Recovery
• Gross Split
• Transition Cost Recovery - Cost Recovery
• Transition Cost Recovery - Gross Split
• Transition Gross Split - Gross Split
• Transition Gross Split - Cost Recovery

Beyond feasibility assessment, PySCnomics provides advanced tools for:

• PSC Contract Optimization
• PSC Contract Sensitivity
• PSC Contract Uncertainty Analysis

To further streamline the assessment process, PySCnomics includes specialized modules for:

• Depreciation
• Inflation
• Cost Taxing
• Production Profile Generation
• API service
• And much more...

Quick Start

Create a new file, in this case named sample.py with the following code:

from pyscnomics.dataset.object_sample import generate_contract_sample
from pyscnomics.econ.selection import ContractSample
from pyscnomics.tools.table import get_table

# Initiating Contract Object
psc = generate_contract_sample(case=ContractSample.CASE_1)

# Get the cashflow table from the contract
tables = get_table(contract=psc)
print(tables)

Sensitivity Analysis

Create a new file with the following code:

from pyscnomics.dataset.object_sample import generate_contract_sample
from pyscnomics.econ.selection import ContractSample
from pyscnomics.optimize.sensitivity import sensitivity_psc
from pyscnomics.tools.summary import get_summary

# Initiating Contract Object
psc = generate_contract_sample(case=ContractSample.CASE_1)

# Defining the contract arguments
contract_arguments = {
    'effective_tax_rate': 0.40
}

# Defining the summary arguments
summary_arguments = {
    'reference_year':2023,
}

# Executing the sensitivity
result = sensitivity_psc(
    contract=psc,
    contract_arguments=contract_arguments,
    summary_arguments=summary_arguments,
    min_deviation=0.2,
    max_deviation=0.2,
    base_value=1,
    step=10,
)

# Printing the sensitivity result
for i in result.keys():
    print(i)
    print(result[i])
    print('')

API Service with PySCnomics

PySCnomics also supports running as an API service, making it easy to integrate into your applications or workflows. With just a single command, you can set up and start an API server to interact with PySCnomics programmatically.

How to Start the API Server

To run the PySCnomics API service, use the following command:

pyscnomics --api 1 --port 9999

Replace 9999 with the desired port number if needed. By default, the API will be accessible at: http://localhost:9999

Accessing the API Documentation

Once the API server is running, you can view the interactive API documentation by navigating to: http://localhost:9999/docs

License

This project is licensed under the terms of the Apache Software license. See the License file for details.

An economic engine for calculating PSC Scheme in Indonesia.