Skip to main content

Detection of favorable moments

Project description


PyPI Version License

Detection of local minima with the corresponding local maxima within the given time-frame.

Caerus is a python package that detects points in time that are most probable local minima and local maxima. As an example is shown the last 300 days of BTC. Green are the local minima and red are the local maxima.

This package determines the local-minima with the corresponding local-maxima across time series data without the need of normalization procedures. The method is designed with a forward rolling window where thousands of variable and sliding windows are iteratively evaluated by means of percentage difference (start-to-stop position). The resulting matrix contains N=windows X M=length_dataframe. The windows of interest have a score (percentage) larger then a predefined minimum. The final matrix is then aggregated (sum) per time-point and normalized for the window length (at the end of the time series data, the windows are forced to become smaller). At each time point the score ranges between [0,1], where [0] depicts that no single window contained a desired minimum percentage, and [1] depicts that all windows showed the minimum desired window. The local minima regions of interest are subsequently detected by thresholding. The stop-locations are determined based on the distance and percentage of te start-locations. As an example, if you want to have best regions, use threshold=1, minperc=high and nlargest=1 (small).

About the name

In Greek mythology, Caerus (same as kairos) was the personification of opportunity, luck and favorable moments. He was shown with only one lock of hair. His Roman equivalent was Occasio or Tempus. Caerus was the youngest child of Zeus.



  • Install caerus from PyPI (recommended). caerus is compatible with Python 3.6+ and runs on Linux, MacOS X and Windows. It is distributed under the Apache 2.0 license.
pip install caerus
  • Alternatively, install caerus from the GitHub source:
git clone
cd caerus
python install

Quick Start

  • Import caerus method
import caerus as cs
  • Simple example with constant window, minimum percentage and threshold
out =
fig = cs.makefig(out)

The input is a pandas dataframe or series and looks like this:

The output looks as below:

out =
fig = cs.makefig(out)

The output looks as below:

  • Gridsearch walks over the windows and over the percentages to determine optimal window, minimum percentage and the threshold.
df = pd.read_csv('')['close']
out = cs.gridsearch(df)

The output looks as below:


Please cite caerus in your publications if this is useful for your research. Here is an example BibTeX entry:

  author={Erdogan Taskesen},


© Copyright

See LICENSE for details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for caerus, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size caerus-0.1.1-py3-none-any.whl (79.2 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size caerus-0.1.1.tar.gz (90.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page