Energyquantified

-----

More gas data preparations.

**Improvements**

- Add ``Place.areas`` (list of areas), as some places (i.e. gas interconnectors)
are places on borders and should be listed for both areas.
- Add three new place types: ``PlaceType.GAS_STORAGE``,
``PlaceType.GAS_LNG_TERMINAL`` and ``PlaceType.GAS_INTERCONNECTOR``
- Add ``Curve.commodity`` (str) which is either ``Power``, ``Gas``, ``Coal``,
``Oil``, ``Carbon`` or ``None`` at this time.
- Add a ``commodity`` filter for ``eq.metadata.curves()``.

**Deprecations**

- Add ``Place.area`` is deprecated and will eventually be replaced by
``Place.areas``. It will be removed in a future release.

---

Implementing Acer's non-standard Gas Day timezone.

**Improvements**

- Define new timezone in ``pytz`` called ``Europe/Gas_Day``. It follows
Acer's Gas Day, which is from 06:00 – 06:00 in CET/CEST. This timezone is
used for the natural gas market in the European Union. Import it with
``from energyquantified.time import GAS_DAY``, or look it up in ``pytz``
like so: ``pytz.timezone("Europe/Gas_Day")``.

**Bugfixes**

- When invoking ``timeseries.to_dataframe(name="foo", single_level_header=True)``,
the resulting column header in pandas' DataFrame no longer includes the
instance identifier. However, the ensemble/scenario name is still appended
at the end.

-----

**Improvements**

- Increase rate limits.

**Bugfixes**

- Set ``has_instances = True`` in ``CurveType.INSTANCE_PERIOD`` (was ``False``).

-----

**Improvements**

- Add new area Kosovo (``Area.XK``) with these borders:
- XK–AL Explicit
- XK–ME Explicit
- XK–MK Explicit
- Add new border:
- NO2–GB Explicit
- Changes in capacity allocation for these borders:
- IT-Sud–GR Implict and Explicit
- BG–GR Implict and Explicit
- PL–DE Implict and Explicit
- PL–SK Implict and Explicit
- PL–CZ Implict and Explicit
- DE–CZ Implict and Explicit
- AT–CZ Implict
- AT–HU Implict
- GB–FR Explicit
- GB–BE Explicit
- GB–NL Explicit
- Remove border:
- RS–AL

-----

**Improvements**

- Add ``ContractPeriod.WEEKEND`` for OHLC data.

**Bugfixes**

- Fix crashes in ``Border.__str__`` and ``Border.__repr__`` due to missing
implementations of ``__lt__`` and ``__gt__`` in class ``Allocation``
(thanks to stanton119).

---

A release with lots of small improvements.

**Improvements**

- Add borders and parent-child relationships for the Italian price zone
Calabria. The price zone has been in the client for a while, but haven't
placed in the exchange neighbour list for the other price zones in Italy
until now.
- Add the new parameter ``single_level_header`` to all ``to_dataframe()``
methods. By default, the ``to_dataframe()``-method will create
``pandas.DataFrame`` objects with three column headers. When
``single_level_header=True``, the client will merge all three levels into
one header. The parameter defaults to ``False`` (to not break the old
behaviour).
- Remove the parameter ``hhv_to_lhv`` for all SRMC API operations.
- Add a new class ``RealtoConnection``. This class is a drop-in replacement
for the ``EnergyQuantified``-class. It lets Realto users connect to
the Energy Quantified's API on Realto's marketplace.
- Update the documentation on how to authenticate for Realto users.
- Add a quickstart chapter for Realto users.
- Add a section in the pandas documentation on the effects of setting the
``single_level_header`` parameter to ``True`` in ``to_dataframe()``.
- Add documentation on the ``fill`` parameter in
``eq.ohlc.load_delivery_as_timeseries()`` and
``eq.ohlc.load_front_as_timeseries()``.
- Other minor improvements in the documentation.

**Breaking change**

- Remove the HHV-to-LHV option for gas in the SRMC API.

**Bugfixes**

- Slashes (/) weren't escaped in curve names in the URL. While this didn't
cause issues for Energy Quantified's API, it caused an issue while
integrating the client with Realto's marketplace.

**Dependencies**

- Upgrade ``requests`` to v2.25.1.