openseries 1.5.3__py3-none-any.whl → 1.5.4__py3-none-any.whl

openseries/_common_model.py

@@ -163,7 +163,7 @@ class _CommonModel(BaseModel):
         return Series(
             data=mddc,
             index=self.tsdf.columns,
-            name="Max Drawdown in cal yr",
+            name="Max drawdown in cal yr",
             dtype="float64",
         )
 
@@ -275,6 +275,20 @@ class _CommonModel(BaseModel):
             min_accepted_return=minimum_accepted_return,
         )
 
+    @property
+    def omega_ratio(self: Self) -> Union[float, Series[float]]:
+        """
+        https://en.wikipedia.org/wiki/Omega_ratio.
+
+        Returns
+        -------
+        Union[float, Pandas.Series[float]]
+            Omega ratio calculation
+
+        """
+        minimum_accepted_return: float = 0.0
+        return self.omega_ratio_func(min_accepted_return=minimum_accepted_return)
+
     @property
     def z_score(self: Self) -> Union[float, Series[float]]:
         """
@@ -1679,7 +1693,7 @@ class _CommonModel(BaseModel):
         return Series(
             data=result,
             index=self.tsdf.columns,
-            name="Max Drawdown",
+            name="Max drawdown",
             dtype="float64",
         )
 
@@ -1735,7 +1749,7 @@ class _CommonModel(BaseModel):
         return Series(
             data=share,
             index=self.tsdf.columns,
-            name="Positive Share",
+            name="Positive share",
             dtype="float64",
         )
 
@@ -1869,6 +1883,60 @@ class _CommonModel(BaseModel):
             dtype="float64",
         )
 
+    def omega_ratio_func(
+        self: Self,
+        min_accepted_return: float = 0.0,
+        months_from_last: Optional[int] = None,
+        from_date: Optional[dt.date] = None,
+        to_date: Optional[dt.date] = None,
+    ) -> Union[float, Series[float]]:
+        """
+        Omega Ratio.
+
+        The Omega Ratio compares returns above a certain target level
+        (often referred to as the “minimum acceptable return” or “MAR”)
+        to the total downside risk below that same threshold.
+        https://en.wikipedia.org/wiki/Omega_ratio.
+
+        Parameters
+        ----------
+        min_accepted_return : float, optional
+            The annualized Minimum Accepted Return (MAR)
+        months_from_last : int, optional
+            number of months offset as positive integer. Overrides use of from_date
+            and to_date
+        from_date : datetime.date, optional
+            Specific from date
+        to_date : datetime.date, optional
+            Specific to date
+
+        Returns
+        -------
+        Union[float, Pandas.Series[float]]
+            Omega ratio calculation
+
+        """
+        earlier, later = self.calc_range(
+            months_offset=months_from_last,
+            from_dt=from_date,
+            to_dt=to_date,
+        )
+        retdf = self.tsdf.loc[cast(int, earlier) : cast(int, later)].pct_change(
+            fill_method=cast(str, None),
+        )
+        pos = retdf[retdf > min_accepted_return].sub(min_accepted_return).sum()
+        neg = retdf[retdf < min_accepted_return].sub(min_accepted_return).sum()
+        ratio = pos / -neg
+
+        if self.tsdf.shape[1] == 1:
+            return float(cast(float64, ratio.iloc[0]))
+        return Series(
+            data=ratio,
+            index=self.tsdf.columns,
+            name="Omega ratio",
+            dtype="float64",
+        )
+
     def value_ret_func(
         self: Self,
         months_from_last: Optional[int] = None,

openseries/load_plotly.py

@@ -7,6 +7,7 @@ from logging import warning
 from pathlib import Path
 
 import requests
+from requests.exceptions import ConnectionError
 
 from openseries.types import CaptorLogoType, PlotlyLayoutType
 
@@ -32,7 +33,7 @@ def _check_remote_file_existence(url: str) -> bool:
         response = requests.head(url, timeout=30)
         if response.status_code != ok_code:
             return False
-    except requests.exceptions.ConnectionError:
+    except ConnectionError:
         return False
     return True
 
@@ -59,9 +60,9 @@ def load_plotly_dict(
     layoutfile = project_root.joinpath("openseries").joinpath("plotly_layouts.json")
     logofile = project_root.joinpath("openseries").joinpath("plotly_captor_logo.json")
 
-    with Path.open(layoutfile, encoding="utf-8") as layout_file:
+    with Path.open(layoutfile, mode="r", encoding="utf-8") as layout_file:
         fig = load(layout_file)
-    with Path.open(logofile, encoding="utf-8") as logo_file:
+    with Path.open(logofile, mode="r", encoding="utf-8") as logo_file:
         logo = load(logo_file)
 
     if _check_remote_file_existence(url=logo["source"]) is False:

openseries/types.py

@@ -220,6 +220,7 @@ class OpenTimeSeriesPropertiesList(list[str]):
         "downside_deviation",
         "ret_vol_ratio",
         "sortino_ratio",
+        "omega_ratio",
         "z_score",
         "skew",
         "kurtosis",
@@ -276,6 +277,7 @@ class OpenFramePropertiesList(list[str]):
         "downside_deviation",
         "ret_vol_ratio",
         "sortino_ratio",
+        "omega_ratio",
         "z_score",
         "skew",
         "kurtosis",

{openseries-1.5.3.dist-info → openseries-1.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: openseries
-Version: 1.5.3
+Version: 1.5.4
 Summary: Tools for analyzing financial timeseries.
 Home-page: https://github.com/CaptorAB/openseries
 License: BSD-3-Clause
@@ -53,7 +53,7 @@ width="81" height="100" align="left" float="right"/><br/>
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://beta.ruff.rs/docs/)
 [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
 
-`openseries` is a project with tools to analyse financial timeseries of a single
+This is a project with tools to analyze financial timeseries of a single
 asset or a group of assets. It is solely made for daily or less frequent data.
 
 <span style="font-size:2em;">[CHANGELOG](https://github.com/CaptorAB/openseries/blob/master/CHANGELOG.md)</span>
@@ -329,6 +329,7 @@ make lint
 | `downside_deviation`    | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | [Downside deviation](https://www.investopedia.com/terms/d/downside-deviation.asp) is the volatility of all negative return observations. Minimum Accepted Return (MAR) set to zero.                                     |
 | `ret_vol_ratio`         | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Ratio of arithmetic mean return and annualized volatility. It is the [Sharpe Ratio](https://www.investopedia.com/terms/s/sharperatio.asp) with the riskfree rate set to zero.                                           |
 | `sortino_ratio`         | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | The [Sortino Ratio](https://www.investopedia.com/terms/s/sortinoratio.asp) is the arithmetic mean return divided by the downside deviation. This attribute assumes that the riskfree rate and the MAR are both zero.    |
+| `omega_ratio`           | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | The [Omega Ratio](https://en.wikipedia.org/wiki/Omega_ratio) compares returns above a certain target level (MAR) to the total downside risk below MAR.                                                                  |
 | `var_down`              | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Downside 95% [Value At Risk](https://www.investopedia.com/terms/v/var.asp), "VaR". The equivalent of percentile.inc([...], 1-level) over returns in MS Excel. For other confidence levels use the corresponding method. |
 | `cvar_down`             | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Downside 95% [Conditional Value At Risk](https://www.investopedia.com/terms/c/conditional_value_at_risk.asp), "CVaR". For other confidence levels use the corresponding method.                                         |
 | `worst`                 | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Most negative percentage change of a single observation.                                                                                                                                                                |
@@ -355,6 +356,7 @@ properties for subset periods._
 | `downside_deviation_func` | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | [Downside deviation](https://www.investopedia.com/terms/d/downside-deviation.asp) is the volatility of all negative return observations. MAR and riskfree rate can be set.                                                                                     |
 | `ret_vol_ratio_func`      | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Ratio of arithmetic mean return and annualized volatility. It is the [Sharpe Ratio](https://www.investopedia.com/terms/s/sharperatio.asp) with the riskfree rate set to zero. A riskfree rate can be set as a float or a series chosen for the frame function. |
 | `sortino_ratio_func`      | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | The [Sortino Ratio](https://www.investopedia.com/terms/s/sortinoratio.asp) is the arithmetic mean return divided by the downside deviation. A riskfree rate can be set as a float or a series chosen for the frame function. MAR is set to zero.               |
+| `omega_ratio_func`        | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | The [Omega Ratio](https://en.wikipedia.org/wiki/Omega_ratio) compares returns above a certain target level (MAR) to the total downside risk below MAR.                                                                                                         |
 | `var_down_func`           | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Downside 95% [Value At Risk](https://www.investopedia.com/terms/v/var.asp), "VaR". The equivalent of percentile.inc([...], 1-level) over returns in MS Excel. Default is 95% confidence level.                                                                 |
 | `cvar_down_func`          | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Downside 95% [Conditional Value At Risk](https://www.investopedia.com/terms/c/conditional_value_at_risk.asp), "CVaR". Default is 95% confidence level.                                                                                                         |
 | `worst_func`              | `float`, `pandas.Series` | `OpenTimeSeries`, `OpenFrame` | Most negative percentage change for a given number of observations (default=1).                                                                                                                                                                                |

{openseries-1.5.3.dist-info → openseries-1.5.4.dist-info}/RECORD

@@ -1,15 +1,15 @@
 openseries/__init__.py,sha256=W429Ojwa-wPgHV5PDAOQOBOAzPOR4wrVHRwdZQjRKcQ,41
-openseries/_common_model.py,sha256=whzIHppEGjXqv2C5ZBg7c-QTCC6dHWBjNKX40WV_c6g,72469
+openseries/_common_model.py,sha256=ETr8vueNHrMC5dZGHP2V3DowIg-jzgmhdOwCI_4258M,74705
 openseries/_risk.py,sha256=4ckiA-0-uuoUOsuc_uElUA_2rLS_U3xJyiva2BX4W1s,3300
 openseries/datefixer.py,sha256=ZOSPp4kLkMEsZv50GQaSo2vAEDVaXEr9iX3wTO7ZdB4,12378
 openseries/frame.py,sha256=SH1sPUFoJS71o2uVJBLoDl3rSC8AP7wQZw3baMD9T4U,74019
-openseries/load_plotly.py,sha256=V99KNaG3OAYsQYKRmpp2-WHgLAQNxKcgrDXpXZ7K8io,1808
+openseries/load_plotly.py,sha256=L4A3Fa5Jk47FY7pcg0NPZ0gm0JD_uCXjVlGC7FWVSJg,1856
 openseries/plotly_captor_logo.json,sha256=F5nhMzEyxKywtjvQqMTKgKRCJQYMDIiBgDSxdte8Clo,178
 openseries/plotly_layouts.json,sha256=ahx8-dL4_RPzvHtBOX0SiL0AH7xQJzNRSDhGrSmU-Og,1429
 openseries/series.py,sha256=pIpiD3v8z7SyIppBatbsPuqOWCf3qI_us2145JnPUkQ,28313
 openseries/simulation.py,sha256=VYxc-e5VSyC55DdfACpQen-necYbhso-6RMyOhYX-5k,13905
-openseries/types.py,sha256=qOKWorkGsv22Q0b2RvMW8IS2pkO3PJlbhQfAviRYNts,7597
-openseries-1.5.3.dist-info/LICENSE.md,sha256=cPUabMxJ6-ziqzqS6aLGkR-ilIOKe_s3Qtyp0ioTmo0,1521
-openseries-1.5.3.dist-info/METADATA,sha256=3OfZAp-QudbPL2HwXiVCMz-zVAMkSVLV2n4APtzZSLg,43579
-openseries-1.5.3.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-openseries-1.5.3.dist-info/RECORD,,
+openseries/types.py,sha256=fSSg9hzQd9cTY8Q3MVdCOtoSu4zFxX4GSk6778LdCNo,7643
+openseries-1.5.4.dist-info/LICENSE.md,sha256=cPUabMxJ6-ziqzqS6aLGkR-ilIOKe_s3Qtyp0ioTmo0,1521
+openseries-1.5.4.dist-info/METADATA,sha256=JhTQclCLTBKzyUE3uD_P-Oa6Ayfu2pAgljK-yODn_YU,44222
+openseries-1.5.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+openseries-1.5.4.dist-info/RECORD,,