pyscnomics 1.4.0
An economic engine for calculating PSC Scheme in Indonesia.
Requires Python: >=3.11
Keywords: Production Sharing Contract, PSC, Project Economic

# 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:

```python
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:

```python
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:

```bash
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](https://github.com/fajril/pyscnomics/blob/main/LICENSE) file for details.

An economic engine for calculating PSC Scheme in Indonesia.