|
| 1 | +<!DOCTYPE html> |
| 2 | +<html lang="en"> |
| 3 | + <head> |
| 4 | + <meta charset="utf-8"> |
| 5 | + <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| 6 | + <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 7 | + |
| 8 | + |
| 9 | + |
| 10 | + <link rel="shortcut icon" href="../../img/favicon.ico"> |
| 11 | + <title>BasicForecaster - Techtonique/ahead_python</title> |
| 12 | + <link href="../../css/bootstrap.min.css" rel="stylesheet"> |
| 13 | + <link href="../../css/font-awesome.min.css" rel="stylesheet"> |
| 14 | + <link href="../../css/base.css" rel="stylesheet"> |
| 15 | + <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/rainbow.min.css"> |
| 16 | + |
| 17 | + <script src="../../js/jquery-1.10.2.min.js" defer></script> |
| 18 | + <script src="../../js/bootstrap.min.js" defer></script> |
| 19 | + <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script> |
| 20 | + <script>hljs.initHighlightingOnLoad();</script> |
| 21 | + <script> |
| 22 | + (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ |
| 23 | + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), |
| 24 | + m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) |
| 25 | + })(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); |
| 26 | + |
| 27 | + ga('create', 'UA-146345113-2', 'https://techtonique.github.io/ahead_python/'); |
| 28 | + ga('send', 'pageview'); |
| 29 | + </script> |
| 30 | + </head> |
| 31 | + |
| 32 | + <body> |
| 33 | + <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark"> |
| 34 | + <div class="container"> |
| 35 | + <a class="navbar-brand" href="../..">Techtonique/ahead_python</a> |
| 36 | + <!-- Expander button --> |
| 37 | + <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse"> |
| 38 | + <span class="navbar-toggler-icon"></span> |
| 39 | + </button> |
| 40 | + |
| 41 | + <!-- Expanded navigation --> |
| 42 | + <div id="navbar-collapse" class="navbar-collapse collapse"> |
| 43 | + <!-- Main navigation --> |
| 44 | + <ul class="nav navbar-nav"> |
| 45 | + <li class="dropdown active"> |
| 46 | + <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a> |
| 47 | + <ul class="dropdown-menu"> |
| 48 | + |
| 49 | +<li> |
| 50 | + <a href="../armagarch/" class="dropdown-item">ArmaGarch</a> |
| 51 | +</li> |
| 52 | + |
| 53 | +<li> |
| 54 | + <a href="./" class="dropdown-item active">BasicForecaster</a> |
| 55 | +</li> |
| 56 | + |
| 57 | +<li> |
| 58 | + <a href="../dynamicregressor/" class="dropdown-item">DynamicRegressor</a> |
| 59 | +</li> |
| 60 | + |
| 61 | +<li> |
| 62 | + <a href="../eat/" class="dropdown-item">EAT</a> |
| 63 | +</li> |
| 64 | + |
| 65 | +<li> |
| 66 | + <a href="../ridge2regressor/" class="dropdown-item">Ridge2Regressor</a> |
| 67 | +</li> |
| 68 | + |
| 69 | +<li> |
| 70 | + <a href="../var/" class="dropdown-item">VAR</a> |
| 71 | +</li> |
| 72 | + </ul> |
| 73 | + </li> |
| 74 | + <li class="navitem"> |
| 75 | + <a href="../../CONTRIBUTING/" class="nav-link">Contributing</a> |
| 76 | + </li> |
| 77 | + <li class="navitem"> |
| 78 | + <a href="../../LICENSE" class="nav-link">License</a> |
| 79 | + </li> |
| 80 | + <li class="navitem"> |
| 81 | + <a href="../../" class="nav-link">Techtonique</a> |
| 82 | + </li> |
| 83 | + </ul> |
| 84 | + |
| 85 | + <ul class="nav navbar-nav ml-auto"> |
| 86 | + <li class="nav-item"> |
| 87 | + <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal"> |
| 88 | + <i class="fa fa-search"></i> Search |
| 89 | + </a> |
| 90 | + </li> |
| 91 | + <li class="nav-item"> |
| 92 | + <a rel="prev" href="../armagarch/" class="nav-link"> |
| 93 | + <i class="fa fa-arrow-left"></i> Previous |
| 94 | + </a> |
| 95 | + </li> |
| 96 | + <li class="nav-item"> |
| 97 | + <a rel="next" href="../dynamicregressor/" class="nav-link"> |
| 98 | + Next <i class="fa fa-arrow-right"></i> |
| 99 | + </a> |
| 100 | + </li> |
| 101 | + <li class="nav-item"> |
| 102 | + <a href="https://github.com/Techtonique/ahead_python" class="nav-link"><i class="fa fa-github"></i> GitHub</a> |
| 103 | + </li> |
| 104 | + </ul> |
| 105 | + </div> |
| 106 | + </div> |
| 107 | + </div> |
| 108 | + |
| 109 | + <div class="container"> |
| 110 | + <div class="row"> |
| 111 | + <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary"> |
| 112 | + <div class="navbar-header"> |
| 113 | + <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents"> |
| 114 | + <span class="fa fa-angle-down"></span> |
| 115 | + </button> |
| 116 | + </div> |
| 117 | + |
| 118 | + |
| 119 | + <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary"> |
| 120 | + <ul class="nav flex-column"> |
| 121 | + |
| 122 | + <li class="nav-item" data-level="1"><a href="#basicforecaster" class="nav-link">BasicForecaster</a> |
| 123 | + <ul class="nav flex-column"> |
| 124 | + </ul> |
| 125 | + </li> |
| 126 | + </ul> |
| 127 | + </div> |
| 128 | +</div></div> |
| 129 | + <div class="col-md-9" role="main"> |
| 130 | + |
| 131 | +<h1 id="basicforecaster">BasicForecaster</h1> |
| 132 | +<p><em>Basic forecasting functions for multivariate time series (mean, median, random walk)</em></p> |
| 133 | +<p><span style="float:right;"><a href="https://github.com/Techtonique/ahead/ahead/Basic/BasicForecaster.py#L45">[source]</a></span></p> |
| 134 | +<h3 id="basicforecaster_1">BasicForecaster</h3> |
| 135 | +<pre><code class="language-python">ahead.Basic.BasicForecaster.BasicForecaster( |
| 136 | + h=5, level=95, method="mean", type_pi="gaussian", B=100, date_formatting="original", seed=123 |
| 137 | +) |
| 138 | +</code></pre> |
| 139 | +<p>Basic forecasting functions for multivariate time series (mean, median, random walk)</p> |
| 140 | +<p>Parameters:</p> |
| 141 | +<pre><code>h: an integer; |
| 142 | + forecasting horizon |
| 143 | + |
| 144 | +level: an integer; |
| 145 | + Confidence level for prediction intervals |
| 146 | + |
| 147 | +method: a string; |
| 148 | + Forecasting method, either "mean", "median", or random walk ("rw") |
| 149 | + |
| 150 | +type_pi: a string; |
| 151 | + Type of prediction interval (currently "gaussian", |
| 152 | + or "bootstrap") |
| 153 | + |
| 154 | +B: an integer; |
| 155 | + Number of bootstrap replications for `type_pi == bootstrap` |
| 156 | + |
| 157 | +date_formatting: a string; |
| 158 | + Currently: |
| 159 | + - "original": yyyy-mm-dd |
| 160 | + - "ms": milliseconds |
| 161 | + |
| 162 | +seed: an integer; |
| 163 | + reproducibility seed for type_pi == 'bootstrap' |
| 164 | +</code></pre> |
| 165 | +<p>Attributes:</p> |
| 166 | +<pre><code>fcast_: an object; |
| 167 | + raw result from fitting R's `ahead::ridge2f` through `rpy2` |
| 168 | + |
| 169 | +averages_: a list of lists; |
| 170 | + mean forecast in a list for each series |
| 171 | + |
| 172 | +ranges_: a list of lists; |
| 173 | + lower and upper prediction intervals in a list for each series |
| 174 | + |
| 175 | +output_dates_: a list; |
| 176 | + a list of output dates (associated to forecast) |
| 177 | + |
| 178 | +mean_: a numpy array |
| 179 | + contains series mean forecast as a numpy array |
| 180 | + |
| 181 | +lower_: a numpy array |
| 182 | + contains series lower bound forecast as a numpy array |
| 183 | + |
| 184 | +upper_: a numpy array |
| 185 | + contains series upper bound forecast as a numpy array |
| 186 | + |
| 187 | +result_dfs_: a tuple of data frames; |
| 188 | + each element of the tuple contains 3 columns, |
| 189 | + mean forecast, lower + upper prediction intervals, |
| 190 | + and a date index |
| 191 | + |
| 192 | +sims_: currently a tuple of numpy arrays |
| 193 | + for `type_pi == bootstrap`, simulations for each series |
| 194 | +</code></pre> |
| 195 | +<p>Examples:</p> |
| 196 | +<pre><code class="language-python">import pandas as pd |
| 197 | +from ahead import BasicForecaster |
| 198 | + |
| 199 | +# Data frame containing the time series |
| 200 | +dataset = { |
| 201 | +'date' : ['2001-01-01', '2002-01-01', '2003-01-01', '2004-01-01', '2005-01-01'], |
| 202 | +'series1' : [34, 30, 35.6, 33.3, 38.1], |
| 203 | +'series2' : [4, 5.5, 5.6, 6.3, 5.1], |
| 204 | +'series3' : [100, 100.5, 100.6, 100.2, 100.1]} |
| 205 | +df = pd.DataFrame(dataset).set_index('date') |
| 206 | +print(df) |
| 207 | + |
| 208 | +# multivariate time series forecasting |
| 209 | +r1 = BasicForecaster(h = 5) |
| 210 | +r1.forecast(df) |
| 211 | +print(r1.result_dfs_) |
| 212 | +</code></pre> |
| 213 | +<hr /> |
| 214 | +<p><span style="float:right;"><a href="https://github.com/Techtonique/ahead/ahead/Basic/BasicForecaster.py#L156">[source]</a></span></p> |
| 215 | +<h3 id="forecast">forecast</h3> |
| 216 | +<pre><code class="language-python">BasicForecaster.forecast(df) |
| 217 | +</code></pre> |
| 218 | +<p>Forecasting method from <code>BasicForecaster</code> class</p> |
| 219 | +<p>Parameters:</p> |
| 220 | +<pre><code>df: a data frame; |
| 221 | + a data frame containing the input time series (see example) |
| 222 | +</code></pre> |
| 223 | +<hr /></div> |
| 224 | + </div> |
| 225 | + </div> |
| 226 | + |
| 227 | + <footer class="col-md-12"> |
| 228 | + <hr> |
| 229 | + <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p> |
| 230 | + </footer> |
| 231 | + <script> |
| 232 | + var base_url = "../..", |
| 233 | + shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83}; |
| 234 | + </script> |
| 235 | + <script src="../../js/base.js" defer></script> |
| 236 | + <script src="../../search/main.js" defer></script> |
| 237 | + |
| 238 | + <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true"> |
| 239 | + <div class="modal-dialog modal-lg"> |
| 240 | + <div class="modal-content"> |
| 241 | + <div class="modal-header"> |
| 242 | + <h4 class="modal-title" id="searchModalLabel">Search</h4> |
| 243 | + <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button> |
| 244 | + </div> |
| 245 | + <div class="modal-body"> |
| 246 | + <p>From here you can search these documents. Enter your search terms below.</p> |
| 247 | + <form> |
| 248 | + <div class="form-group"> |
| 249 | + <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here"> |
| 250 | + </div> |
| 251 | + </form> |
| 252 | + <div id="mkdocs-search-results" data-no-results-text="No results found"></div> |
| 253 | + </div> |
| 254 | + <div class="modal-footer"> |
| 255 | + </div> |
| 256 | + </div> |
| 257 | + </div> |
| 258 | +</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true"> |
| 259 | + <div class="modal-dialog"> |
| 260 | + <div class="modal-content"> |
| 261 | + <div class="modal-header"> |
| 262 | + <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4> |
| 263 | + <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button> |
| 264 | + </div> |
| 265 | + <div class="modal-body"> |
| 266 | + <table class="table"> |
| 267 | + <thead> |
| 268 | + <tr> |
| 269 | + <th style="width: 20%;">Keys</th> |
| 270 | + <th>Action</th> |
| 271 | + </tr> |
| 272 | + </thead> |
| 273 | + <tbody> |
| 274 | + <tr> |
| 275 | + <td class="help shortcut"><kbd>?</kbd></td> |
| 276 | + <td>Open this help</td> |
| 277 | + </tr> |
| 278 | + <tr> |
| 279 | + <td class="next shortcut"><kbd>n</kbd></td> |
| 280 | + <td>Next page</td> |
| 281 | + </tr> |
| 282 | + <tr> |
| 283 | + <td class="prev shortcut"><kbd>p</kbd></td> |
| 284 | + <td>Previous page</td> |
| 285 | + </tr> |
| 286 | + <tr> |
| 287 | + <td class="search shortcut"><kbd>s</kbd></td> |
| 288 | + <td>Search</td> |
| 289 | + </tr> |
| 290 | + </tbody> |
| 291 | + </table> |
| 292 | + </div> |
| 293 | + <div class="modal-footer"> |
| 294 | + </div> |
| 295 | + </div> |
| 296 | + </div> |
| 297 | +</div> |
| 298 | + |
| 299 | + </body> |
| 300 | +</html> |
0 commit comments