v1.0.2 - Production Composite and New Tutorial

Breaking changes in some functions in util.costs. Added _deprecated suffix to deprecated functions, they will be removed from v1.1.0.

New composite functions to gather production data

• get_hourly_production_data
• get_hourly_production_plan_data
• wrapper_hourly_production_plan_and_realized

New streamlit tutorial to calculate imbalance and KÜPST costs

from eptr2.tutorials import run_calc_app

run_calc_app(username="YOUR_USERNAME",password="YOUR_PASSWORD")

v1.0.1 - Price and Cost

• Two new composite functions: get_price_and_costs, get_imbalance_data
• Minor fix in composite function get_hourly_consumption_and_forecast_data. End date was mistakenly filled with start date in demand forecast.

v1.0.0 - A New Era

Finally, after more than a year, we have the v1.0.0. Though v1.0.0 is not an end, but a beginning. We had the complete call coverage at v0.7.3. With v1.0.0+, eptr2 will provide opportunities to actually use Transparency in your reports and dashboards. Therefore v1.0.0 is not an end but a beginning.

We have two major developments.

Tutorial Interfaces

We used to refer people to eptr2demo to figure out which calls to make and how to configure them. Now you can call it inside the package.

from eptr2.tutorials import run_demo_app
run_demo_app(username="YOUR_USERNAME",password="YOUR_PASSWORD")

Tutorial interfaces are currently experimental and they may include breaking changes.

Composite Functions

Each call in eptr2 gets a different data set. But sometimes we need several sets of data together to have the full picture of a time period. We bring in composite functions in this version.

We start with an example. Consumption data is important for many analysts. There is real time consumption, settlement consumption (UECM) and load plan (forecasted consumption). Our first composite function get_hourly_consumption_and_forecast_data brings all three data sources together.

from eptr2 import EPTR2
from eptr2.composite import get_hourly_consumption_and_forecast_data

eptr = EPTR2(username="YOUR_USERNAME",password="YOUR_PASSWORD")
df = get_hourly_consumption_and_forecast_data(eptr, start_date="2024-07-29", end_date="2024-07-29")
print(df)

If you have good ideas about composite functions, please write to us.

Composite functions are currently experimental and they may include breaking changes.

Other changes

We are improving the eptr2 experience continuously. Now, it is possible to register username and password from a file or through environment variables. A credentials json file shall look like this one.

{
    "EPTR_USERNAME": "YOUR_TRANSPARENCY_USER_EMAIL",
    "EPTR_PASSWORD": "YOUR_TRANSPARENCY_PASSWORD"
}

Just add the extra parameter (credentials_file_path) and json file path to the EPTR2 object.

Alternatively you can define environment variables "EPTR_USERNAME" and "EPTR_PASSWORD" and EPTR2 object will take care of those as credentials as well.

v0.7.3 - Penultimate Release

This is the last release before v1.0.0 🎉

• Almost complete command set (excluding some admin commands and commands not functioning since 2016). A total of 213 commands with help documents.
• Default value of minimum 750 TL/MWh in KUPST calculations in line with the new legislation.
• Minor fixes and improvements

v0.7.2 - VEP

• Added VEP / PFM Calls
• Added min_kupst parameter for preparation for minimum unit KUPST price (default: 0 for now)
• Added kgup-v1 call to get KGÜP / FDPP first version

v0.7.1 - YEK-G

• Included YEK-G calls
• Background changes
• New method (get_number_of_calls) to get the number of calls.
• A total of 186 original API calls, in addition some derived calls with specific parameter combinations.

v0.7.0 - Aliases

• There are now aliases that can point to calls. For instance, "ptf" also points to "mcp" call. More aliases to come in the future.
• custom_aliases parameter is introduced (see Readme for detailed explanation) so that you can define your own aliases.
• Some NG-VGP calls had either period and start-end date parameter set distinctions. Wrapper functions are built for the calls.

v0.6.2

• New natural gas calls. Natural gas calls are completely covered.
• Totaling up to 175 calls.
• Some minor fixes and improvements.

v0.6.1 - Natural Gas Calls Part 2

• Added 15 more natural gas calls. Some more to go.
• Some simplifications for the path mapping (background improvements, insignificant at runs)

v0.6.0 - Natural Gas Calls

This version adds new natural gas calls. You can see the list of calls beginning with "ng-" prefix with the command EPTR2().get_available_calls().