Update README.md

Extended README

Author: K-Ibadullaev

README.md

@@ -1,7 +1,68 @@
 # PY-SSA-LIB PACKAGE
-This package contains python implementations of the  **Singular Spectrum Analysis(SSA)** and **Multichannel Singular Spectrum Analysis(MSSA)**. One can use them for the time series analysis and forecasting.
+## Intro
+Welcome to the page of the **py-ssa-lib** package!
+This package contains python implementations of the  **Singular Spectrum Analysis(SSA)** and **Multichannel Singular Spectrum Analysis(MSSA)**. 
 
+It can be used for the time series analysis and forecasting. 
+
+**Please, take a look on the guides for SSA and MSSA which are available in the [corresponding directory](https://github.com/K-Ibadullaev/py_ssa/tree/main/examples_and_guide) !**
+ 
 ## Installation
 ```shell
 $ python -m pip install py-ssa-lib
 ```
+
+## Requirements
+The required packages are listed in the requirements.txt and can be installed from this file via pip.
+
+However all dependecies should be automatically installed along with installation of the **py-ssa-lib**
+
+The classes in the **py-ssa-lib** heavily rely on the numpy, scipy, sklearn, pandas and matplotlib libraries.
+
+## Similar Python Packages
+Before the development of the **py-ssa-lib** I searched for the 
+the Python packages which implement both MSSA and SSA, and found only few decent packages with the similar functionality:
+
+- https://github.com/AbdullahO/mSSA?tab=readme-ov-file
+- https://github.com/kieferk/pymssa
+  
+However, they seem to be no longer maintained and they provided a limited functionality in comparison to what I need.
+(Arguably) the best functionality is provided by the RSSA-package in R (https://github.com/asl/rssa).
+So the aim of this package is to migrate the most useful functions from the RSSA-package into Python, in order to provide a seamless workflow for the time series analysis.
+
+
+## List of the Used Packages
+- NumPy https://numpy.org/
+- SciPy https://scipy.org/
+- Jupyter Lab https://jupyterlab.readthedocs.io/en/latest/index.html
+- Scikit-learn https://scikit-learn.org/stable/
+- Matplotlib https://matplotlib.org/
+
+
+  
+## Literature about SSA and MSSA
+- https://www.kaggle.com/code/jdarcy/introducing-ssa-for-time-series-decomposition/notebook#2.-Introducing-the-SSA-Method
+- https://link.springer.com/book/10.1007/978-3-642-34913-3
+- https://link.springer.com/book/10.1007/978-3-662-57380-8
+- https://www.gistatgroup.com/gus/mssa2.pdf
+  
+
+
+## Citation 
+If you find this package useful, please, cite:
+
+**Konstantin Ibadullaev, https://github.com/K-Ibadullaev/py_ssa/**
+
+(This file and the citation format will change over time.)
+
+## Issues and Contributions
+I am open to feedbacks and discussion of issues. The contributions are always welcome unless not reasoned.
+
+## Future Updates
+I intend to introduce the updates once per 3 monthes. 
+The comming features might be:
+- Asymptotic Prediction and Confidence Intervals
+- Some new data sets for the demonstration purposes
+- Gap Filling
+- Wiki with a bit more informative description of the mathematical background for SSA/MSSA
+-  ...