The leading use-case for the staircase package is for the creation and analysis of step functions.
Pretty exciting huh.
But don't hit the close button on the browser just yet. Let us convince you that much of the world around you can be modelled as step functions.
For example, the number of users viewing this page over time can be modelled as a step function. The value of the function increases by 1 every time a user arrives at the page, and decreases by 1 every time a user leaves the page. Let's say we have this data in vector format (i.e. tuple, list, numpy array, pandas series). Specifically, assume arrive and leave are vectors of times, expressed as minutes past midnight, for all page views occuring yesterday. Creating the corresponding step function is simple. To achieve it we use the Stairs class:
>>> import staircase as sc
>>> views = sc.Stairs()
>>> views.layer(arrive,leave)
We can visualise the function with the plot function:
>>> views.plot()
We can find the total time in minutes the page was viewed:
>>> views.clip(0,1440).integral()
9297.94622521079
We can find the average number of viewers:
>>> views.clip(0,1440).mean()
6.4569071008408265
We can find the average number of viewers, per hour of the day, and plot:
>>> views.slice(pd.interval_range(0, periods=24, freq=60)).mean().plot()
We can find the maximum concurrent views:
>>> views.clip(0,1440).max()
16
We can create histogram data showing relative frequency of concurrent viewers (and plot it):
>>> views.clip(0,1440).hist().plot.bar()
Plotting is based on matplotlib and it requires relatively little effort to take the previous chart and improve the aesthetics:
There is plenty more analysis that could be done. The staircase package provides a rich variety of arithmetic operations, relational operations, logical operations, statistical operations, for use with Stairs, in addition to functions for univariate analysis, aggregations and compatibility with pandas.Timestamp.
Installation
staircase can be installed from PyPI:
python -m pip install staircase
or also with conda:
conda install -c conda-forge staircase
Documentation
The complete guide to using staircase can be found at staircase.dev
Contributing
There are many ways in which contributions can be made - the first and foremost being using staircase and giving feedback.
Bug reports, feature requests and ideas can be submitted via the Github issue tracker.
Additionally, bug fixes. enhancements, and improvements to the code and documentation are also appreciated and can be done via pull requests. Take a look at the current issues and if there is one you would like to work on please leave a comment to that effect.
See this beginner's guide to contributing, or Pandas' guide to contributing, to learn more about the process.
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
License
This project is licensed under the MIT License - see the LICENSE file for details
Acknowledgments
The seeds of staircase began developing at the Hunter Valley Coal Chain Coordinator, where it finds strong application in analysing simulated data. Thanks for the support!
126 Dec 28, 2022
6 Sep 07, 2022
0 Jan 20, 2022
1 Dec 17, 2021
42 Sep 12, 2022
8 Oct 18, 2022
3.7k Jan 03, 2023
2.2k Dec 25, 2022
6.3k Jan 08, 2023
124 Dec 14, 2022
1.9k Jan 03, 2023
5 Sep 18, 2022
3 Aug 24, 2022
1 Jan 12, 2022
1.5k Jan 03, 2023
1 Dec 08, 2021
5 Jun 11, 2022
5 Mar 19, 2022
336 May 25, 2022
76 Nov 30, 2022