Metadata-Version: 2.1
Name: mplfinance
Version: 0.12.6a1
Summary: Utilities for the visualization, and visual analysis, of financial data
Home-page: http://github.com/matplotlib/mplfinance
Author: MPL Developers
Author-email: matplotlib-users@python.org
Maintainer-email: dgoldfarb.github@gmail.com
License: BSD-style
Description: [![Build Status](https://travis-ci.org/matplotlib/mplfinance.svg?branch=master)](https://travis-ci.org/matplotlib/mplfinance)
        
        # mplfinance
        ## matplotlib utilities for the visualization, and visual analysis, of financial data
        
        ---
        
        # Installation
        ## &nbsp;&nbsp;&nbsp;`pip install --upgrade mplfinance`
           - mplfinance requires [matplotlib](https://pypi.org/project/matplotlib/) and [pandas](https://pypi.org/project/pandas/)
        
        ---
        
        # <a name="announcements"></a>Announcing Version 0.12.5 and 0.12.6 Enhancements
        ### [Version 0.12.5 and 0.12.6 bring a number of enhancements to mplfinance. Click here for full details.](https://github.com/matplotlib/mplfinance/blob/master/RELEASE_NOTES.md)
        
        ---
        
        # <a name="tutorials"></a>Contents and Tutorials
        
          - **[The New API](https://github.com/matplotlib/mplfinance#newapi)**
          - **[Tutorials](https://github.com/matplotlib/mplfinance#tutorials)**
            - **[Basic Usage](https://github.com/matplotlib/mplfinance#usage)**
            - **[Customizing the Appearance of Plots](https://github.com/matplotlib/mplfinance/blob/master/markdown/customization_and_styles.md)** (**New** features June 2020)
            - **[Adding Your Own Technical Studies to Plots](https://github.com/matplotlib/mplfinance/blob/master/examples/addplot.ipynb)**
            - **[Subplots: Multiple Plots on a Single Figure](https://github.com/matplotlib/mplfinance/blob/master/markdown/subplots.md)** (**New** June 2020)
            - **[Price-Movement Plots (Renko, P&F, etc)](https://github.com/matplotlib/mplfinance/blob/master/examples/price-movement_plots.ipynb)**
            - **[Trends, Support, Resistance, and Trading Lines](https://github.com/matplotlib/mplfinance/blob/master/examples/using_lines.ipynb)**
            - **[Saving the Plot to a File](https://github.com/matplotlib/mplfinance/blob/master/examples/savefig.ipynb)**
          - **[Latest Release Info](https://github.com/matplotlib/mplfinance/blob/master/RELEASE_NOTES.md)**
          - **[Some Background History About This Package](https://github.com/matplotlib/mplfinance#history)**
          - **[Old API Availability](https://github.com/matplotlib/mplfinance#oldapi)**
        
        ---
        ## <a name="newapi"></a>The New API
        
        This repository, `matplotlib/mplfinance`, contains a new **matplotlib finance** API that makes it easier to create financial plots.  It interfaces nicely with **Pandas** DataFrames.  
        
        *More importantly, **the new API automatically does the extra matplotlib work that the user previously had to do "manually" with the old API.***   (The old API is still available within this package; see below).
        
        The conventional way to import the new API is as follows:
        
        ```python
            import mplfinance as mpf
        ```
        
        The most common usage is then to call
        
        ```python
            mpf.plot(data)
        ```
        
        where `data` is a `Pandas DataFrame` object containing Open, High, Low and Close data, with a Pandas `DatetimeIndex`.
        
        Details on how to call the new API can be found below under **[Basic Usage](https://github.com/matplotlib/mplfinance#usage)**, as well as in the jupyter notebooks in the **[examples](https://github.com/matplotlib/mplfinance/blob/master/examples/)** folder.
        
        I am very interested to hear from you regarding what you think of the new `mplfinance`, plus any suggestions you may have for improvement.  You can reach me at **dgoldfarb.github@gmail.com**  or, if you prefer, provide feedback or a ask question on our **[issues page.](https://github.com/matplotlib/mplfinance/issues/new/choose)**
        
        ---
        
        # <a name="usage"></a>Basic Usage
        Start with a Pandas DataFrame containing OHLC data.  For example,
        
        
        ```python
        import pandas as pd
        daily = pd.read_csv('examples/data/SP500_NOV2019_Hist.csv',index_col=0,parse_dates=True)
        daily.index.name = 'Date'
        daily.shape
        daily.head(3)
        daily.tail(3)
        ```
        
            (20, 5)
        
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>Open</th>
              <th>High</th>
              <th>Low</th>
              <th>Close</th>
              <th>Volume</th>
            </tr>
            <tr>
              <th>Date</th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>2019-11-01</th>
              <td>3050.72</td>
              <td>3066.95</td>
              <td>3050.72</td>
              <td>3066.91</td>
              <td>510301237</td>
            </tr>
            <tr>
              <th>2019-11-04</th>
              <td>3078.96</td>
              <td>3085.20</td>
              <td>3074.87</td>
              <td>3078.27</td>
              <td>524848878</td>
            </tr>
            <tr>
              <th>2019-11-05</th>
              <td>3080.80</td>
              <td>3083.95</td>
              <td>3072.15</td>
              <td>3074.62</td>
              <td>585634570</td>
            </tr>
          </tbody>
        </table>
        
        ...
        
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>Open</th>
              <th>High</th>
              <th>Low</th>
              <th>Close</th>
              <th>Volume</th>
            </tr>
            <tr>
              <th>Date</th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>2019-11-26</th>
              <td>3134.85</td>
              <td>3142.69</td>
              <td>3131.00</td>
              <td>3140.52</td>
              <td>986041660</td>
            </tr>
            <tr>
              <th>2019-11-27</th>
              <td>3145.49</td>
              <td>3154.26</td>
              <td>3143.41</td>
              <td>3153.63</td>
              <td>421853938</td>
            </tr>
            <tr>
              <th>2019-11-29</th>
              <td>3147.18</td>
              <td>3150.30</td>
              <td>3139.34</td>
              <td>3140.98</td>
              <td>286602291</td>
            </tr>
          </tbody>
        </table>
        
        
        ---
        <br>
        
        After importing mplfinance, plotting OHLC data is as simple as calling `mpf.plot()` on the dataframe
        
        
        ```python
        import mplfinance as mpf
        mpf.plot(daily)
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_4_1.png)
        
        
        ---
        <br>
        
        The default plot type, as you can see above, is `'ohlc'`.  Other plot types can be specified with the keyword argument `type`, for example, `type='candle'`, `type='line'`, `type='renko'`, or `type='pnf'`
        
        
        ```python
        mpf.plot(daily,type='candle')
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_6_1.png)
        
        
        
        ```python
        mpf.plot(daily,type='line')
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_7_1.png)
        
        
        
        ```python
        year = pd.read_csv('examples/data/SPY_20110701_20120630_Bollinger.csv',index_col=0,parse_dates=True)
        year.index.name = 'Date'
        mpf.plot(year,type='renko')
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_8_1.png)
        
        
        ```python
        mpf.plot(year,type='pnf')
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_5_1.png)
        
        ---
        <br>
        
        We can also plot moving averages with the `mav` keyword
        - use a scalar for a single moving average 
        - use a tuple or list of integers for multiple moving averages
        
        
        ```python
        mpf.plot(daily,type='ohlc',mav=4)
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_9_1.png)
        
        
        
        ```python
        mpf.plot(daily,type='candle',mav=(3,6,9))
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_10_1.png)
        
        
        ---
        We can also display `Volume`
        
        
        ```python
        mpf.plot(daily,type='candle',mav=(3,6,9),volume=True)
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_12_1.png)
        
        
        Notice, in the above chart, there are no gaps along the x-coordinate, even though there are days on which there was no trading.  ***Non-trading days are simply not shown*** (since there are no prices for those days).
        
        - However, sometimes people like to see these gaps, so that they can tell, with a quick glance, where the weekends and holidays fall.  
        
        - Non-trading days can be displayed with the `show_nontrading` keyword.
        - For example, in the chart below, you can easily see weekends, as well as a gap at Thursday, November 28th for the U.S. Thanksgiving holiday.
        
        
        ```python
        mpf.plot(daily,type='candle',mav=(3,6,9),volume=True,show_nontrading=True)
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_14_1.png)
        
        
        ---
        
        We can also plot intraday data:
        
        
        ```python
        intraday = pd.read_csv('examples/data/SP500_NOV2019_IDay.csv',index_col=0,parse_dates=True)
        intraday = intraday.drop('Volume',axis=1) # Volume is zero anyway for this intraday data set
        intraday.index.name = 'Date'
        intraday.shape
        intraday.head(3)
        intraday.tail(3)
        ```
        
            (1563, 4)
        
        
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>Open</th>
              <th>Close</th>
              <th>High</th>
              <th>Low</th>
            </tr>
            <tr>
              <th>Date</th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>2019-11-05 09:30:00</th>
              <td>3080.80</td>
              <td>3080.49</td>
              <td>3081.47</td>
              <td>3080.30</td>
            </tr>
            <tr>
              <th>2019-11-05 09:31:00</th>
              <td>3080.33</td>
              <td>3079.36</td>
              <td>3080.33</td>
              <td>3079.15</td>
            </tr>
            <tr>
              <th>2019-11-05 09:32:00</th>
              <td>3079.43</td>
              <td>3079.68</td>
              <td>3080.46</td>
              <td>3079.43</td>
            </tr>
          </tbody>
        </table>
        
        ...
        
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>Open</th>
              <th>Close</th>
              <th>High</th>
              <th>Low</th>
            </tr>
            <tr>
              <th>Date</th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>2019-11-08 15:57:00</th>
              <td>3090.73</td>
              <td>3090.70</td>
              <td>3091.02</td>
              <td>3090.52</td>
            </tr>
            <tr>
              <th>2019-11-08 15:58:00</th>
              <td>3090.73</td>
              <td>3091.04</td>
              <td>3091.13</td>
              <td>3090.58</td>
            </tr>
            <tr>
              <th>2019-11-08 15:59:00</th>
              <td>3091.16</td>
              <td>3092.91</td>
              <td>3092.91</td>
              <td>3090.96</td>
            </tr>
          </tbody>
        </table>
        
        
        
        The above dataframe contains Open,High,Low,Close data at 1 minute intervervals for the S&P 500 stock index for November 5, 6, 7 and 8, 2019.  Let's look at the last hour of trading on November 6th, with a 7 minute and 12 minute moving average.
        
        
        ```python
        iday = intraday.loc['2019-11-06 15:00':'2019-11-06 16:00',:]
        mpf.plot(iday,type='candle',mav=(7,12))
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_18_1.png)
        
        
          The "time-interpretation" of the `mav` integers depends on the frequency of the data, because the mav integers are the *number of data points* used in the Moving Average (not the number of days or minutes, etc).  Notice above that for intraday data the x-axis automatically displays TIME *instead of* date.  Below we see that if the intraday data spans into two (or more) trading days the x-axis automatically displays *BOTH* TIME and DATE
        
        
        ```python
        iday = intraday.loc['2019-11-05':'2019-11-06',:]
        mpf.plot(iday,type='candle')
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_20_1.png)
        
        
        ---
        In the plot below, we see what an intraday plot looks like when we **display non-trading time periods** with **`show_nontrading=True`** for intraday data spanning into two or more days.
        
        
        ```python
        mpf.plot(iday,type='candle',show_nontrading=True)
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_22_1.png)
        
        
        ---
        Below: 4 days of intraday data with `show_nontrading=True`
        
        
        ```python
        mpf.plot(intraday,type='ohlc',show_nontrading=True)
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_24_1.png)
        
        
        ---
        Below: the same 4 days of intraday data with `show_nontrading` defaulted to `False`.
        
        
        ```python
        mpf.plot(intraday,type='line') 
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_26_1.png)
        
        
        ---
        Below: Daily data spanning across a year boundary automatically adds the *YEAR* to the DATE format
        
        
        ```python
        df = pd.read_csv('examples/data/yahoofinance-SPY-20080101-20180101.csv',index_col=0,parse_dates=True)
        df.shape
        df.head(3)
        df.tail(3)
        ```
        
            (2519, 6)
        
        
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>Open</th>
              <th>High</th>
              <th>Low</th>
              <th>Close</th>
              <th>Adj Close</th>
              <th>Volume</th>
            </tr>
            <tr>
              <th>Date</th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>2007-12-31</th>
              <td>147.100006</td>
              <td>147.610001</td>
              <td>146.059998</td>
              <td>146.210007</td>
              <td>118.624741</td>
              <td>108126800</td>
            </tr>
            <tr>
              <th>2008-01-02</th>
              <td>146.529999</td>
              <td>146.990005</td>
              <td>143.880005</td>
              <td>144.929993</td>
              <td>117.586205</td>
              <td>204935600</td>
            </tr>
            <tr>
              <th>2008-01-03</th>
              <td>144.910004</td>
              <td>145.490005</td>
              <td>144.070007</td>
              <td>144.860001</td>
              <td>117.529449</td>
              <td>125133300</td>
            </tr>
          </tbody>
        </table>
        
        ...
        
        <table border="1" class="dataframe">
          <thead>
            <tr style="text-align: right;">
              <th></th>
              <th>Open</th>
              <th>High</th>
              <th>Low</th>
              <th>Close</th>
              <th>Adj Close</th>
              <th>Volume</th>
            </tr>
            <tr>
              <th>Date</th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
              <th></th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <th>2017-12-27</th>
              <td>267.380005</td>
              <td>267.730011</td>
              <td>267.010010</td>
              <td>267.320007</td>
              <td>267.320007</td>
              <td>57751000</td>
            </tr>
            <tr>
              <th>2017-12-28</th>
              <td>267.890015</td>
              <td>267.920013</td>
              <td>267.450012</td>
              <td>267.869995</td>
              <td>267.869995</td>
              <td>45116100</td>
            </tr>
            <tr>
              <th>2017-12-29</th>
              <td>268.529999</td>
              <td>268.549988</td>
              <td>266.640015</td>
              <td>266.859985</td>
              <td>266.859985</td>
              <td>96007400</td>
            </tr>
          </tbody>
        </table>
        
        
        ```python
        mpf.plot(df[700:850],type='bars',volume=True,mav=(20,40))
        ```
        
        
        ![png](https://raw.githubusercontent.com/matplotlib/mplfinance/master/readme_files/readme_29_1.png)
        
        
        For more examples of using mplfinance, please see the jupyter notebooks in the **[`examples`](https://github.com/matplotlib/mplfinance/blob/master/examples/)** directory.
        
        ---
        
        ## <a name="history"></a>Some History
        My name is Daniel Goldfarb.  In November 2019, I became the maintainer of `matplotlib/mpl-finance`.  That module is being deprecated in favor of the current `matplotlib/mplfinance`.  The old `mpl-finance` consisted of code extracted from the deprecated `matplotlib.finance` module along with a few examples of usage.  It has been mostly un-maintained for the past three years.  
        
        It is my intention to archive the `matplotlib/mpl-finance` repository soon, and direct everyone to `matplotlib/mplfinance`.  The main reason for the rename is to avoid confusion with the hyphen and the underscore: As it was, `mpl-finance` was *installed with the hyphen, but imported with an underscore `mpl_finance`.*  Going forward it will be a simple matter of both installing and importing `mplfinance`.
        
        ---
        ### <a name="oldapi"></a>old API availability
        
        **With this new ` mplfinance ` package installed, in addition to the new API, users can still access the old API**.<br> The old API may be removed some day, but for the foreseeable future we will keep it ... at least until we are very confident that users of the old API can accomplish the same things with the new API.
        
        ---
        
        To access the old API with the new ` mplfinance ` package installed, change the old import statments
        
        **from:**
        
        ```python
            from mpl_finance import <method>
        ```
        
        **to:**
        
        ```python
            from mplfinance.original_flavor import <method>
        ```
        
        
        where `<method>` indicates the method you want to import, for example:
        
        
        
        ```python
            from mplfinance.original_flavor import candlestick_ohlc
        ```
        
        ---
        
        
        ```python
        
        ```
        
Keywords: finance,candlestick,ohlc,market,investing,technical analysis
Platform: Cross platform (Linux
Platform: Mac OSX
Platform: Windows)
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Matplotlib
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Description-Content-Type: text/markdown; charset=UTF-8
