From 14782c7fa16073c876728136851ed1541b0935f0 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 15 Sep 2018 17:30:00 +0530 Subject: [PATCH 01/53] Old system file generation changed --- tradingsystem/System.ipynb | 397 +++++++++++++++++++++++-------------- 1 file changed, 245 insertions(+), 152 deletions(-) diff --git a/tradingsystem/System.ipynb b/tradingsystem/System.ipynb index 5ab80f4..a6fab97 100644 --- a/tradingsystem/System.ipynb +++ b/tradingsystem/System.ipynb @@ -38,8 +38,8 @@ "metadata": {}, "outputs": [], "source": [ - "ORDER_FILENAME = 'cm29AUG2018bhav.csv.zip' # File to generate orders\n", - "RESULT_FILENAME = 'cm30AUG2018bhav.csv.zip' # File to compare performance\n", + "ORDER_FILENAME = 'data/cm11SEP2018bhav.csv.zip' # File to generate orders\n", + "RESULT_FILENAME = 'data/cm12SEP2018bhav.csv.zip' # File to compare performance\n", "UNIVERSE = 'NIFTY50' # Universe to be searched\n", "STOP_LOSS = 3 # Stop loss for the order\n", "NUM_STOCKS = 5 # Number of stocks to sell\n", @@ -50,7 +50,7 @@ }, { "cell_type": "code", - "execution_count": 12, + "execution_count": 3, "metadata": {}, "outputs": [], "source": [ @@ -59,60 +59,14 @@ }, { "cell_type": "code", - "execution_count": 3, - "metadata": {}, - "outputs": [ - { - "ename": "FileNotFoundError", - "evalue": "[Errno 2] No such file or directory: 'cm29AUG2018bhav.csv.zip'", - "output_type": "error", - "traceback": [ - "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", - "\u001b[0;31mFileNotFoundError\u001b[0m Traceback (most recent call last)", - "\u001b[0;32m\u001b[0m in \u001b[0;36m\u001b[0;34m()\u001b[0m\n\u001b[1;32m 1\u001b[0m orders = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n\u001b[0;32m----> 2\u001b[0;31m usecols=range(13))\n\u001b[0m\u001b[1;32m 3\u001b[0m \u001b[0msymbols\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mpd\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mread_excel\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m'universe.xlsx'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0msheet_name\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mUNIVERSE\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mheader\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalues\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mravel\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 4\u001b[0m \u001b[0mdf\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0morders\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0morders\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'SYMBOL'\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0misin\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0msymbols\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 5\u001b[0m \u001b[0mdf\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mdf\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mdf\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'SERIES'\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0;34m\"EQ\"\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mreset_index\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mdrop\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mTrue\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36mparser_f\u001b[0;34m(filepath_or_buffer, sep, delimiter, header, names, index_col, usecols, squeeze, prefix, mangle_dupe_cols, dtype, engine, converters, true_values, false_values, skipinitialspace, skiprows, nrows, na_values, keep_default_na, na_filter, verbose, skip_blank_lines, parse_dates, infer_datetime_format, keep_date_col, date_parser, dayfirst, iterator, chunksize, compression, thousands, decimal, lineterminator, quotechar, quoting, escapechar, comment, encoding, dialect, tupleize_cols, error_bad_lines, warn_bad_lines, skipfooter, doublequote, delim_whitespace, low_memory, memory_map, float_precision)\u001b[0m\n\u001b[1;32m 676\u001b[0m skip_blank_lines=skip_blank_lines)\n\u001b[1;32m 677\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 678\u001b[0;31m \u001b[0;32mreturn\u001b[0m \u001b[0m_read\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfilepath_or_buffer\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mkwds\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 679\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 680\u001b[0m \u001b[0mparser_f\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__name__\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m_read\u001b[0;34m(filepath_or_buffer, kwds)\u001b[0m\n\u001b[1;32m 438\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 439\u001b[0m \u001b[0;31m# Create the parser.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 440\u001b[0;31m \u001b[0mparser\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mTextFileReader\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfilepath_or_buffer\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwds\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 441\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 442\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mchunksize\u001b[0m \u001b[0;32mor\u001b[0m \u001b[0miterator\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, f, engine, **kwds)\u001b[0m\n\u001b[1;32m 785\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0moptions\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'has_index_names'\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mkwds\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'has_index_names'\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 786\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 787\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_make_engine\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mengine\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 788\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 789\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mclose\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m_make_engine\u001b[0;34m(self, engine)\u001b[0m\n\u001b[1;32m 1012\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0m_make_engine\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mengine\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;34m'c'\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1013\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mengine\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0;34m'c'\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 1014\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_engine\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mCParserWrapper\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mf\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0moptions\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1015\u001b[0m \u001b[0;32melse\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1016\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mengine\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0;34m'python'\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, src, **kwds)\u001b[0m\n\u001b[1;32m 1706\u001b[0m \u001b[0mkwds\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'usecols'\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0musecols\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1707\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 1708\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_reader\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mparsers\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mTextReader\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0msrc\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwds\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1709\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1710\u001b[0m \u001b[0mpassed_names\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mnames\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32mpandas/_libs/parsers.pyx\u001b[0m in \u001b[0;36mpandas._libs.parsers.TextReader.__cinit__\u001b[0;34m()\u001b[0m\n", - "\u001b[0;32mpandas/_libs/parsers.pyx\u001b[0m in \u001b[0;36mpandas._libs.parsers.TextReader._setup_parser_source\u001b[0;34m()\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/zipfile.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, file, mode, compression, allowZip64)\u001b[0m\n\u001b[1;32m 1088\u001b[0m \u001b[0;32mwhile\u001b[0m \u001b[0;32mTrue\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1089\u001b[0m \u001b[0;32mtry\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 1090\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfp\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mio\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mopen\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfile\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mfilemode\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1091\u001b[0m \u001b[0;32mexcept\u001b[0m \u001b[0mOSError\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1092\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mfilemode\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mmodeDict\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;31mFileNotFoundError\u001b[0m: [Errno 2] No such file or directory: 'cm29AUG2018bhav.csv.zip'" - ] - } - ], - "source": [ - "orders = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n", - " usecols=range(13))\n", - "symbols = pd.read_excel('universe.xlsx', sheet_name=UNIVERSE, header=None).values.ravel()\n", - "df = orders[orders['SYMBOL'].isin(symbols)]\n", - "df = df[df['SERIES'] == \"EQ\"].reset_index(drop=True)\n", - "df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1\n", - "result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS]\n", - "result['OPENPRICE'] = 0\n", - "result[['TIMESTAMP', 'SYMBOL', 'OPENPRICE']].to_excel('output.xlsx', index=False)\n", - "print('Update OPENPRICE in the output.xlsx file')\n", - "result[['TIMESTAMP', 'SYMBOL', 'OPENPRICE']]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Update OPEN PRICE in output.xlsx file and run the below cell" - ] - }, - { - "cell_type": "code", - "execution_count": 14, + "execution_count": 4, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ - "Orders file created\n" + "Update OPENPRICE in the output.xlsx file\n" ] }, { @@ -139,101 +93,90 @@ " TIMESTAMP\n", " SYMBOL\n", " OPENPRICE\n", - " price\n", - " stop_loss\n", - " qty\n", " \n", " \n", " \n", " \n", - " 0\n", - " 2018-08-24\n", - " VEDL\n", - " 225.95\n", - " 225.95\n", - " 232.73\n", - " 18.0\n", + " 9\n", + " 2018-09-11\n", + " COALINDIA\n", + " 0\n", " \n", " \n", - " 1\n", - " 2018-08-24\n", - " ONGC\n", - " 175.45\n", - " 175.45\n", - " 180.71\n", - " 23.0\n", + " 31\n", + " 2018-09-11\n", + " M&M\n", + " 0\n", " \n", " \n", - " 2\n", - " 2018-08-24\n", - " GRASIM\n", - " 1063.10\n", - " 1063.10\n", - " 1094.99\n", - " 4.0\n", + " 25\n", + " 2018-09-11\n", + " INFY\n", + " 0\n", " \n", " \n", - " 3\n", - " 2018-08-24\n", - " AXISBANK\n", - " 643.00\n", - " 643.00\n", - " 662.29\n", - " 6.0\n", + " 1\n", + " 2018-09-11\n", + " ASIANPAINT\n", + " 0\n", " \n", " \n", - " 4\n", - " 2018-08-24\n", - " ZEEL\n", - " 517.00\n", - " 517.00\n", - " 532.51\n", - " 8.0\n", + " 33\n", + " 2018-09-11\n", + " NTPC\n", + " 0\n", " \n", " \n", "\n", "" ], "text/plain": [ - " TIMESTAMP SYMBOL OPENPRICE price stop_loss qty\n", - "0 2018-08-24 VEDL 225.95 225.95 232.73 18.0\n", - "1 2018-08-24 ONGC 175.45 175.45 180.71 23.0\n", - "2 2018-08-24 GRASIM 1063.10 1063.10 1094.99 4.0\n", - "3 2018-08-24 AXISBANK 643.00 643.00 662.29 6.0\n", - "4 2018-08-24 ZEEL 517.00 517.00 532.51 8.0" + " TIMESTAMP SYMBOL OPENPRICE\n", + "9 2018-09-11 COALINDIA 0\n", + "31 2018-09-11 M&M 0\n", + "25 2018-09-11 INFY 0\n", + "1 2018-09-11 ASIANPAINT 0\n", + "33 2018-09-11 NTPC 0" ] }, - "execution_count": 14, + "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ - "trading_capital = CAPITAL * LEVERAGE\n", - "orders = pd.read_excel('output.xlsx')\n", - "num_stock = len(orders)\n", - "orders['price'] = orders['OPENPRICE']\n", - "orders['stop_loss'] = (orders['price'] * 1.03).round(2)\n", - "orders['qty'] = (trading_capital/num_stock/orders['price']).round()\n", - "orders.to_csv('orders.csv', index=False)\n", - "print('Orders file created')\n", - "orders" + "orders = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n", + " usecols=range(13))\n", + "symbols = pd.read_excel('universe.xlsx', sheet_name=UNIVERSE, header=None).values.ravel()\n", + "df = orders[orders['SYMBOL'].isin(symbols)]\n", + "df = df[df['SERIES'] == \"EQ\"].reset_index(drop=True)\n", + "df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1\n", + "result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS]\n", + "result['OPENPRICE'] = 0\n", + "result[['TIMESTAMP', 'SYMBOL', 'OPENPRICE']].to_excel('output.xlsx', index=False)\n", + "print('Update OPENPRICE in the output.xlsx file')\n", + "result[['TIMESTAMP', 'SYMBOL', 'OPENPRICE']]" ] }, { - "cell_type": "code", - "execution_count": 16, + "cell_type": "markdown", "metadata": {}, - "outputs": [], "source": [ - "### Run the below cell to evaluate peformance" + "### Update OPEN PRICE in output.xlsx file and run the below cell" ] }, { "cell_type": "code", - "execution_count": 18, + "execution_count": 11, "metadata": {}, "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Orders file created\n" + ] + }, { "data": { "text/html": [ @@ -257,76 +200,226 @@ " \n", " TIMESTAMP\n", " SYMBOL\n", - " BUY\n", - " SELL\n", - " profit_per_unit\n", - " total_profit\n", + " OPENPRICE\n", + " price\n", + " qty\n", + " stop_loss\n", + " order\n", " \n", " \n", " \n", " \n", " 0\n", - " 2018-08-27\n", - " VEDL\n", - " 225.50\n", - " 225.95\n", - " 0.45\n", - " 8.1\n", + " 2018-09-11\n", + " COALINDIA\n", + " 283.0\n", + " 283.0\n", + " 14.0\n", + " 291.49\n", + " SELL\n", " \n", " \n", " 1\n", - " 2018-08-27\n", - " ONGC\n", - " 176.05\n", - " 175.45\n", - " -0.60\n", - " -13.8\n", + " 2018-09-11\n", + " M&M\n", + " 941.2\n", + " 941.2\n", + " 4.0\n", + " 969.44\n", + " SELL\n", " \n", " \n", " 2\n", - " 2018-08-27\n", - " GRASIM\n", - " 1078.45\n", - " 1063.10\n", - " -15.35\n", - " -61.4\n", + " 2018-09-11\n", + " INFY\n", + " 741.9\n", + " 741.9\n", + " 5.0\n", + " 764.16\n", + " SELL\n", " \n", " \n", " 3\n", - " 2018-08-27\n", - " AXISBANK\n", - " 650.20\n", - " 643.00\n", - " -7.20\n", - " -43.2\n", + " 2018-09-11\n", + " ASIANPAINT\n", + " 1298.3\n", + " 1298.3\n", + " 3.0\n", + " 1337.25\n", + " SELL\n", " \n", " \n", " 4\n", - " 2018-08-27\n", - " ZEEL\n", - " 511.20\n", - " 517.00\n", - " 5.80\n", - " 46.4\n", + " 2018-09-11\n", + " NTPC\n", + " 170.4\n", + " 170.4\n", + " 23.0\n", + " 175.51\n", + " SELL\n", " \n", " \n", "\n", "" ], "text/plain": [ - " TIMESTAMP SYMBOL BUY SELL profit_per_unit total_profit\n", - "0 2018-08-27 VEDL 225.50 225.95 0.45 8.1\n", - "1 2018-08-27 ONGC 176.05 175.45 -0.60 -13.8\n", - "2 2018-08-27 GRASIM 1078.45 1063.10 -15.35 -61.4\n", - "3 2018-08-27 AXISBANK 650.20 643.00 -7.20 -43.2\n", - "4 2018-08-27 ZEEL 511.20 517.00 5.80 46.4" + " TIMESTAMP SYMBOL OPENPRICE price qty stop_loss order\n", + "0 2018-09-11 COALINDIA 283.0 283.0 14.0 291.49 SELL\n", + "1 2018-09-11 M&M 941.2 941.2 4.0 969.44 SELL\n", + "2 2018-09-11 INFY 741.9 741.9 5.0 764.16 SELL\n", + "3 2018-09-11 ASIANPAINT 1298.3 1298.3 3.0 1337.25 SELL\n", + "4 2018-09-11 NTPC 170.4 170.4 23.0 175.51 SELL" ] }, - "execution_count": 18, + "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], + "source": [ + "trading_capital = CAPITAL * LEVERAGE\n", + "orders = pd.read_excel('output.xlsx')\n", + "num_stock = len(orders)\n", + "orders['price'] = orders['OPENPRICE']\n", + "orders['qty'] = (trading_capital/num_stock/orders['price']).round()\n", + "orders['stop_loss'] = (orders['price'] * (1 + STOP_LOSS * 0.01)).round(2)\n", + "orders['order'] = 'SELL'\n", + "orders.to_csv('orders.csv', index=False)\n", + "\n", + "print('Orders file created')\n", + "orders" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Use the below cells to generate orders for your broker\n", + "#### I have included code for **NEST**\n", + "\n", + "Most brokers and software provide an option to place basket orders. So we are going to create a basket order from our orders. We would be using the ``create_order`` function from ``utils.py`` file.\n", + "\n", + "To do this for your specific broker, do the following steps\n", + "\n", + "1. Know the format of your broker; you can do this by placing a basket order and exporting it\n", + "2. The format would usually have a list of columns to be filled up. We need to fill all the columns to import our order.\n", + "3. We separate the columns into columns that are already in our dataframe and columns to be included\n", + "4. We prepare a list of matching columns and rename them\n", + "5. For new columns, we create a python dictionary with keys as column names and values as the value for the column (we assume that these columns have a single value)\n", + "\n", + "All this has been done for NEST.\n", + "\n", + "*Thanks @vjay for providing the necessary support*\n" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [], + "source": [ + "# Change your account id here\n", + "ACCOUNTID = 'XXXXXX' " + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [], + "source": [ + "from utils import create_orders, stop_loss\n", + "\n", + "\n", + "# List of columns to be included in the output\n", + "\n", + "cols = [\n", + " 'Segment', 'InstrumentName', 'Symbol', 'Option Type', 'Strike Price',\n", + " 'ExpiryDate', 'Price', 'Qty', 'LTP', 'Buy/Sell', 'Order Type',\n", + " 'TriggerPrice', 'Pro/Cli', 'P Type', 'Validity', 'AccountId',\n", + " 'Validity Date', 'Remarks', 'Participant code', 'Validity Time',\n", + " 'Market Proc' \n", + "]\n", + "\n", + "# These columns are common for all orders - columns with a single name\n", + "columns = {\n", + " 'Segment': 'NSE',\n", + " 'InstrumentName': 'EQ',\n", + " 'Option Type': 'NA',\n", + " 'Strike Price': 'NA',\n", + " 'ExpiryDate': 'NA',\n", + " 'LTP': 0,\n", + " 'Disclosed Qty': 0,\n", + " 'AccountId': ACCOUNTID,\n", + " 'Pro/Cli': 'CLI',\n", + " 'Validity': 'DAY',\n", + " 'P Type': 'MIS',\n", + " 'Remarks': '',\n", + " 'Validity Date': 'NA',\n", + " 'Participant code': '',\n", + " 'Validity Time': 'NA',\n", + " 'Market Proc': 'NA',\n", + " 'Order Type': 'SL'\n", + "}\n", + "\n", + "# These are columns to be renamed\n", + "rename = {\n", + " 'order': 'Buy/Sell',\n", + " 'price': 'Price',\n", + " 'qty': 'Qty',\n", + " 'trigger_price': 'TriggerPrice',\n", + " 'price': 'Price' ,\n", + " 'SYMBOL': 'Symbol'\n", + "}" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "File generated\n" + ] + } + ], + "source": [ + "# Generating orders in the required format\n", + "entry_orders = orders.copy()\n", + "entry = create_orders(entry_orders, rename=rename, **columns)\n", + "\n", + "# Exit orders order type and price to be changed\n", + "exit_orders = orders.copy()\n", + "exit_orders['order'] = 'BUY'\n", + "exit_orders['price'] = 0\n", + "exit_orders['trigger_price'] = list(stop_loss(orders['price'], STOP_LOSS, order='S').round(2))\n", + "columns.update({'Order Type': 'SL-M'})\n", + "exit = create_orders(exit_orders, rename=rename, **columns)\n", + "\n", + "# File generation\n", + "entry.append(exit, sort=False)[cols].to_csv('orders_to_place.csv', \n", + " index=False, header=False)\n", + "print('File generated')\n", + "\n", + "# If you want header change header to True\n", + "# If you want to export as excel use the to_excel function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Run the below cell to evaluate peformance" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], "source": [ "def isPrice(price, high, low):\n", " if price >= low and price <=high:\n", @@ -369,7 +462,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.6.5" + "version": "3.6.6" } }, "nbformat": 4, From b7859ea44b738e3d18400755edef40303f947761 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 15 Sep 2018 17:40:22 +0530 Subject: [PATCH 02/53] New System notebook added --- tradingsystem/SystemNew.ipynb | 867 ++++++++-------------------------- 1 file changed, 189 insertions(+), 678 deletions(-) diff --git a/tradingsystem/SystemNew.ipynb b/tradingsystem/SystemNew.ipynb index 017de43..79e6e45 100644 --- a/tradingsystem/SystemNew.ipynb +++ b/tradingsystem/SystemNew.ipynb @@ -6,8 +6,7 @@ "source": [ "## This is the updated system\n", "1. Fetch data from NSE\n", - "2. Automatically generate prices and stop loss\n", - "3. " + "2. Automatically generate prices and stop loss" ] }, { @@ -17,16 +16,14 @@ "## Instructions\n", "1. See instructions for each cell\n", "2. You need to change only the PARAMETERS, nothing else\n", - "3. You need to have 2 bhav copy files, one to generate orders and the next to evaluate performance\n", - "4. Based on the previous day orders, **results.xlsx** file is generated. You need to fill in the current day's open price and run the cells below it to generate orders. This would generate **orders.csv** file\n", - "5. At the end of the day, you need to download the bhav copy results to evaluate performance. This would generate a **peformance.csv** file\n", - "\n", - "Save all these files at the end of the day in a new folder. We would automate this process also soon" + "3. Store all your data in data folder\n", + "4. All the orders you generate go into the orders folder\n", + "5. Orders for the present day are created with the filename **orders_to_place.csv** and stored in the current directory" ] }, { "cell_type": "code", - "execution_count": 1, + "execution_count": 55, "metadata": {}, "outputs": [], "source": [ @@ -35,743 +32,257 @@ "import os" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Parameters that could be changed" + ] + }, { "cell_type": "code", - "execution_count": 2, + "execution_count": 56, "metadata": {}, "outputs": [], "source": [ - "%load_ext autoreload" + "UNIVERSE = 'NIFTY50' # Universe to be searched\n", + "ORDER_FILENAME = 'data/cm11SEP2018bhav.csv.zip'\n", + "STOP_LOSS = 3 # Stop loss for the order\n", + "NUM_STOCKS = 5 # Number of stocks to sell\n", + "CAPITAL = 20000\n", + "LEVERAGE = 1\n", + "ORDERFILE_PREFIX = 'orders_' # Prefix file name to store" ] }, { "cell_type": "code", - "execution_count": 5, + "execution_count": 57, "metadata": {}, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
SYMBOLPctChangeOpenPrice
0COALINDIA1.14282.80
1GAIL1.13381.95
2INFRATEL-0.16275.25
3NTPC-0.09169.05
4HINDPETRO-0.02246.60
5AXISBANK-0.02651.65
6LUPIN0.98953.65
7SBIN0.88287.35
8SUNPHARMA0.78643.00
9TECHM0.75772.00
10YESBANK0.73326.00
11ZEEL0.69476.00
12INFY0.69735.90
13VEDL0.67225.00
14GRASIM0.631022.50
15M&M0.60943.00
16WIPRO0.60326.95
17UPL0.60707.50
18DRREDDY0.572578.45
19TATAMOTORS0.56277.25
20ADANIPORTS0.52373.90
21BPCL0.49345.80
22HEROMOTOCO0.483294.00
23HINDALCO0.47236.80
24TCS0.402089.00
25LT0.361341.55
26HDFC0.341890.00
27MARUTI0.338668.00
28CIPLA0.31670.10
29KOTAKBANK0.301227.00
30TITAN0.29860.00
31TATASTEEL0.28615.35
32INDUSINDBK0.271834.10
33HDFCBANK0.252046.30
34RELIANCE0.251259.00
35ICICIBANK0.24333.70
36BAJAJ-AUTO0.222875.00
37EICHERMOT0.2028680.00
38BAJFINANCE0.202621.00
39HINDUNILVR0.171613.00
40ASIANPAINT0.151295.00
41HCLTECH0.121090.00
42BAJAJFINSV0.066351.10
43IBULHSGFIN0.061162.00
44POWERGRID0.05193.05
45BHARTIARTL0.03388.50
46ONGC0.03168.70
47ITC0.03306.65
48IOC0.03151.10
49ULTRACEMCO0.004154.75
\n", - "
" - ], - "text/plain": [ - " SYMBOL PctChange OpenPrice\n", - "0 COALINDIA 1.14 282.80\n", - "1 GAIL 1.13 381.95\n", - "2 INFRATEL -0.16 275.25\n", - "3 NTPC -0.09 169.05\n", - "4 HINDPETRO -0.02 246.60\n", - "5 AXISBANK -0.02 651.65\n", - "6 LUPIN 0.98 953.65\n", - "7 SBIN 0.88 287.35\n", - "8 SUNPHARMA 0.78 643.00\n", - "9 TECHM 0.75 772.00\n", - "10 YESBANK 0.73 326.00\n", - "11 ZEEL 0.69 476.00\n", - "12 INFY 0.69 735.90\n", - "13 VEDL 0.67 225.00\n", - "14 GRASIM 0.63 1022.50\n", - "15 M&M 0.60 943.00\n", - "16 WIPRO 0.60 326.95\n", - "17 UPL 0.60 707.50\n", - "18 DRREDDY 0.57 2578.45\n", - "19 TATAMOTORS 0.56 277.25\n", - "20 ADANIPORTS 0.52 373.90\n", - "21 BPCL 0.49 345.80\n", - "22 HEROMOTOCO 0.48 3294.00\n", - "23 HINDALCO 0.47 236.80\n", - "24 TCS 0.40 2089.00\n", - "25 LT 0.36 1341.55\n", - "26 HDFC 0.34 1890.00\n", - "27 MARUTI 0.33 8668.00\n", - "28 CIPLA 0.31 670.10\n", - "29 KOTAKBANK 0.30 1227.00\n", - "30 TITAN 0.29 860.00\n", - "31 TATASTEEL 0.28 615.35\n", - "32 INDUSINDBK 0.27 1834.10\n", - "33 HDFCBANK 0.25 2046.30\n", - "34 RELIANCE 0.25 1259.00\n", - "35 ICICIBANK 0.24 333.70\n", - "36 BAJAJ-AUTO 0.22 2875.00\n", - "37 EICHERMOT 0.20 28680.00\n", - "38 BAJFINANCE 0.20 2621.00\n", - "39 HINDUNILVR 0.17 1613.00\n", - "40 ASIANPAINT 0.15 1295.00\n", - "41 HCLTECH 0.12 1090.00\n", - "42 BAJAJFINSV 0.06 6351.10\n", - "43 IBULHSGFIN 0.06 1162.00\n", - "44 POWERGRID 0.05 193.05\n", - "45 BHARTIARTL 0.03 388.50\n", - "46 ONGC 0.03 168.70\n", - "47 ITC 0.03 306.65\n", - "48 IOC 0.03 151.10\n", - "49 ULTRACEMCO 0.00 4154.75" - ] - }, - "execution_count": 5, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ - "%autoreload\n", "from utils import *\n", - "fetch_preopen_data()" + "preopen = fetch_preopen_data()" ] }, { - "cell_type": "markdown", + "cell_type": "code", + "execution_count": 58, "metadata": {}, + "outputs": [], "source": [ - "## Parameters that could be changed" + "### Don't change the below cell" ] }, { "cell_type": "code", - "execution_count": 2, + "execution_count": 59, "metadata": {}, "outputs": [], "source": [ - "UNIVERSE = 'NIFTY50' # Universe to be searched\n", - "STOP_LOSS = 3 # Stop loss for the order\n", - "NUM_STOCKS = 5 # Number of stocks to sell\n", - "CAPITAL = 20000\n", - "LEVERAGE = 1" + "eod = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n", + " usecols=range(13))\n", + "symbols = pd.read_excel('universe.xlsx', sheet_name=UNIVERSE, header=None).values.ravel()\n", + "df = eod[eod['SYMBOL'].isin(symbols)]\n", + "df = df[df['SERIES'] == \"EQ\"].reset_index(drop=True)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Trading logic\n", + "\n", + "There is where all your logic goes.\n", + "At present, we short the top n stocks the previous day" ] }, { "cell_type": "code", - "execution_count": 12, + "execution_count": 60, "metadata": {}, "outputs": [], "source": [ - "### Don't change the below cell" + "df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1\n", + "result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS]" ] }, { "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": true, - "jupyter": { - "outputs_hidden": true - } - }, - "outputs": [ - { - "ename": "FileNotFoundError", - "evalue": "[Errno 2] No such file or directory: 'cm29AUG2018bhav.csv.zip'", - "output_type": "error", - "traceback": [ - "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", - "\u001b[0;31mFileNotFoundError\u001b[0m Traceback (most recent call last)", - "\u001b[0;32m\u001b[0m in \u001b[0;36m\u001b[0;34m()\u001b[0m\n\u001b[1;32m 1\u001b[0m orders = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n\u001b[0;32m----> 2\u001b[0;31m usecols=range(13))\n\u001b[0m\u001b[1;32m 3\u001b[0m \u001b[0msymbols\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mpd\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mread_excel\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m'universe.xlsx'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0msheet_name\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mUNIVERSE\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mheader\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalues\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mravel\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 4\u001b[0m \u001b[0mdf\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0morders\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0morders\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'SYMBOL'\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0misin\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0msymbols\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 5\u001b[0m \u001b[0mdf\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mdf\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mdf\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'SERIES'\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0;34m\"EQ\"\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mreset_index\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mdrop\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mTrue\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36mparser_f\u001b[0;34m(filepath_or_buffer, sep, delimiter, header, names, index_col, usecols, squeeze, prefix, mangle_dupe_cols, dtype, engine, converters, true_values, false_values, skipinitialspace, skiprows, nrows, na_values, keep_default_na, na_filter, verbose, skip_blank_lines, parse_dates, infer_datetime_format, keep_date_col, date_parser, dayfirst, iterator, chunksize, compression, thousands, decimal, lineterminator, quotechar, quoting, escapechar, comment, encoding, dialect, tupleize_cols, error_bad_lines, warn_bad_lines, skipfooter, doublequote, delim_whitespace, low_memory, memory_map, float_precision)\u001b[0m\n\u001b[1;32m 676\u001b[0m skip_blank_lines=skip_blank_lines)\n\u001b[1;32m 677\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 678\u001b[0;31m \u001b[0;32mreturn\u001b[0m \u001b[0m_read\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfilepath_or_buffer\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mkwds\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 679\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 680\u001b[0m \u001b[0mparser_f\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__name__\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m_read\u001b[0;34m(filepath_or_buffer, kwds)\u001b[0m\n\u001b[1;32m 438\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 439\u001b[0m \u001b[0;31m# Create the parser.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 440\u001b[0;31m \u001b[0mparser\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mTextFileReader\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfilepath_or_buffer\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwds\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 441\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 442\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mchunksize\u001b[0m \u001b[0;32mor\u001b[0m \u001b[0miterator\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, f, engine, **kwds)\u001b[0m\n\u001b[1;32m 785\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0moptions\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'has_index_names'\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mkwds\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'has_index_names'\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 786\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 787\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_make_engine\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mengine\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 788\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 789\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mclose\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m_make_engine\u001b[0;34m(self, engine)\u001b[0m\n\u001b[1;32m 1012\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0m_make_engine\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mengine\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;34m'c'\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1013\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mengine\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0;34m'c'\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 1014\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_engine\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mCParserWrapper\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mf\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0moptions\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1015\u001b[0m \u001b[0;32melse\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1016\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mengine\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0;34m'python'\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/pandas/io/parsers.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, src, **kwds)\u001b[0m\n\u001b[1;32m 1706\u001b[0m \u001b[0mkwds\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m'usecols'\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0musecols\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1707\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 1708\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_reader\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mparsers\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mTextReader\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0msrc\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwds\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1709\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1710\u001b[0m \u001b[0mpassed_names\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mnames\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32mpandas/_libs/parsers.pyx\u001b[0m in \u001b[0;36mpandas._libs.parsers.TextReader.__cinit__\u001b[0;34m()\u001b[0m\n", - "\u001b[0;32mpandas/_libs/parsers.pyx\u001b[0m in \u001b[0;36mpandas._libs.parsers.TextReader._setup_parser_source\u001b[0;34m()\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/zipfile.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, file, mode, compression, allowZip64)\u001b[0m\n\u001b[1;32m 1088\u001b[0m \u001b[0;32mwhile\u001b[0m \u001b[0;32mTrue\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1089\u001b[0m \u001b[0;32mtry\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 1090\u001b[0;31m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfp\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mio\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mopen\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfile\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mfilemode\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1091\u001b[0m \u001b[0;32mexcept\u001b[0m \u001b[0mOSError\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1092\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mfilemode\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mmodeDict\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;31mFileNotFoundError\u001b[0m: [Errno 2] No such file or directory: 'cm29AUG2018bhav.csv.zip'" - ] - } - ], + "execution_count": 61, + "metadata": {}, + "outputs": [], "source": [ - "orders = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n", - " usecols=range(13))\n", - "symbols = pd.read_excel('universe.xlsx', sheet_name=UNIVERSE, header=None).values.ravel()\n", - "df = orders[orders['SYMBOL'].isin(symbols)]\n", - "df = df[df['SERIES'] == \"EQ\"].reset_index(drop=True)\n", - "df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1\n", - "result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS]\n", - "result['OPENPRICE'] = 0\n", - "result[['TIMESTAMP', 'SYMBOL', 'OPENPRICE']].to_excel('output.xlsx', index=False)\n", - "print('Update OPENPRICE in the output.xlsx file')\n", - "result[['TIMESTAMP', 'SYMBOL', 'OPENPRICE']]" + "trading_capital = CAPITAL * LEVERAGE\n", + "orders = result.merge(preopen, on='SYMBOL')\n", + "num_stock = len(orders)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "### Update OPEN PRICE in output.xlsx file and run the below cell" + "## Pricing logic goes here" ] }, { "cell_type": "code", - "execution_count": 14, + "execution_count": 62, "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Orders file created\n" - ] - }, - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
TIMESTAMPSYMBOLOPENPRICEpricestop_lossqty
02018-08-24VEDL225.95225.95232.7318.0
12018-08-24ONGC175.45175.45180.7123.0
22018-08-24GRASIM1063.101063.101094.994.0
32018-08-24AXISBANK643.00643.00662.296.0
42018-08-24ZEEL517.00517.00532.518.0
\n", - "
" - ], - "text/plain": [ - " TIMESTAMP SYMBOL OPENPRICE price stop_loss qty\n", - "0 2018-08-24 VEDL 225.95 225.95 232.73 18.0\n", - "1 2018-08-24 ONGC 175.45 175.45 180.71 23.0\n", - "2 2018-08-24 GRASIM 1063.10 1063.10 1094.99 4.0\n", - "3 2018-08-24 AXISBANK 643.00 643.00 662.29 6.0\n", - "4 2018-08-24 ZEEL 517.00 517.00 532.51 8.0" - ] - }, - "execution_count": 14, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ - "trading_capital = CAPITAL * LEVERAGE\n", - "orders = pd.read_excel('output.xlsx')\n", - "num_stock = len(orders)\n", - "orders['price'] = orders['OPENPRICE']\n", - "orders['stop_loss'] = (orders['price'] * 1.03).round(2)\n", + "# I prefer a constant percentage change instead of value\n", + "# If you prefer it, make this raw and use the below cell\n", + "\n", + "orders['trigger_price'] = orders['OpenPrice'] - 0.05\n", + "orders['price'] = orders['trigger_price'] - 0.05" + ] + }, + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "# Price calculated at a fixed percentage from open price\n", + "\n", + "orders['trigger_price'] = orders['OpenPrice'] * 0.9985\n", + "orders['price'] = orders['trigger_price'] - 0.05" + ] + }, + { + "cell_type": "code", + "execution_count": 63, + "metadata": {}, + "outputs": [], + "source": [ + "# Stop loss and quantity automatically generated\n", + "\n", + "orders['stop_loss'] = (orders['price'] * (1 + STOP_LOSS * 0.01)).round(2).apply(tick)\n", "orders['qty'] = (trading_capital/num_stock/orders['price']).round()\n", - "orders.to_csv('orders.csv', index=False)\n", - "print('Orders file created')\n", - "orders" + "import datetime\n", + "filename = ORDERFILE_PREFIX + datetime.datetime.today().strftime('%Y-%m-%d') + '.csv'\n", + "orders.to_csv('orders/' + filename, index=False)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Use the below cells to generate orders for your broker\n", + "#### I have included code for **NEST**\n", + "\n", + "Most brokers and software provide an option to place basket orders. So we are going to create a basket order from our orders. We would be using the ``create_order`` function from ``utils.py`` file.\n", + "\n", + "To do this for your specific broker, do the following steps\n", + "\n", + "1. Know the format of your broker; you can do this by placing a basket order and exporting it\n", + "2. The format would usually have a list of columns to be filled up. We need to fill all the columns to import our order.\n", + "3. We separate the columns into columns that are already in our dataframe and columns to be included\n", + "4. We prepare a list of matching columns and rename them\n", + "5. For new columns, we create a python dictionary with keys as column names and values as the value for the column (we assume that these columns have a single value)\n", + "\n", + "All this has been done for NEST.\n", + "\n", + "*Thanks @vjay for providing the necessary support*\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Parameters for order generation\n", + "\n" ] }, { "cell_type": "code", - "execution_count": 16, + "execution_count": 64, "metadata": {}, "outputs": [], "source": [ - "### Run the below cell to evaluate peformance" + "ACCOUNTID = 'XXXXXX' # Your accountId with broker" ] }, { "cell_type": "code", - "execution_count": 18, + "execution_count": 65, + "metadata": {}, + "outputs": [], + "source": [ + "# List of columns to be included in the output\n", + "\n", + "cols = [\n", + " 'Segment', 'InstrumentName', 'Symbol', 'Option Type', 'Strike Price',\n", + " 'ExpiryDate', 'Price', 'Qty', 'LTP', 'Buy/Sell', 'Order Type',\n", + " 'TriggerPrice', 'Pro/Cli', 'P Type', 'Validity', 'AccountId',\n", + " 'Validity Date', 'Remarks', 'Participant code', 'Validity Time',\n", + " 'Market Proc' \n", + "]\n", + "\n", + "# These columns are common for all orders - columns with a single name\n", + "columns = {\n", + " 'Segment': 'NSE',\n", + " 'InstrumentName': 'EQ',\n", + " 'Option Type': 'NA',\n", + " 'Strike Price': 'NA',\n", + " 'ExpiryDate': 'NA',\n", + " 'LTP': 0,\n", + " 'Disclosed Qty': 0,\n", + " 'AccountId': ACCOUNTID,\n", + " 'Pro/Cli': 'CLI',\n", + " 'Validity': 'DAY',\n", + " 'P Type': 'MIS',\n", + " 'Remarks': '',\n", + " 'Validity Date': 'NA',\n", + " 'Participant code': '',\n", + " 'Validity Time': 'NA',\n", + " 'Market Proc': 'NA',\n", + " 'Order Type': 'SL'\n", + "}\n", + "\n", + "# These are columns to be renamed\n", + "rename = {\n", + " 'order': 'Buy/Sell',\n", + " 'price': 'Price',\n", + " 'qty': 'Qty',\n", + " 'trigger_price': 'TriggerPrice',\n", + " 'price': 'Price' ,\n", + " 'SYMBOL': 'Symbol'\n", + "}" + ] + }, + { + "cell_type": "code", + "execution_count": 66, "metadata": {}, "outputs": [ { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
TIMESTAMPSYMBOLBUYSELLprofit_per_unittotal_profit
02018-08-27VEDL225.50225.950.458.1
12018-08-27ONGC176.05175.45-0.60-13.8
22018-08-27GRASIM1078.451063.10-15.35-61.4
32018-08-27AXISBANK650.20643.00-7.20-43.2
42018-08-27ZEEL511.20517.005.8046.4
\n", - "
" - ], - "text/plain": [ - " TIMESTAMP SYMBOL BUY SELL profit_per_unit total_profit\n", - "0 2018-08-27 VEDL 225.50 225.95 0.45 8.1\n", - "1 2018-08-27 ONGC 176.05 175.45 -0.60 -13.8\n", - "2 2018-08-27 GRASIM 1078.45 1063.10 -15.35 -61.4\n", - "3 2018-08-27 AXISBANK 650.20 643.00 -7.20 -43.2\n", - "4 2018-08-27 ZEEL 511.20 517.00 5.80 46.4" - ] - }, - "execution_count": 18, - "metadata": {}, - "output_type": "execute_result" + "name": "stdout", + "output_type": "stream", + "text": [ + "File generated\n" + ] } ], "source": [ - "def isPrice(price, high, low):\n", - " if price >= low and price <=high:\n", - " return True\n", - " else:\n", - " False\n", + "# Generating orders in the required format\n", + "entry_orders = orders.copy()\n", + "entry = create_orders(entry_orders, rename=rename, **columns)\n", "\n", - "orders = pd.read_csv('orders.csv', index_col='TIMESTAMP', parse_dates=True)\n", - "end_of_day = pd.read_csv(RESULT_FILENAME, parse_dates=['TIMESTAMP'],\n", - " usecols=range(13))\n", - "end_of_day = end_of_day[end_of_day['SERIES'] == \"EQ\"]\n", - "orders = orders.merge(end_of_day)\n", - "orders['SELL'] = [price if isPrice(price, high, low) else close for\n", - " price, high, low, close in \n", - " zip(orders['price'], orders['HIGH'], orders['LOW'], orders[REF_PRICE])]\n", - "orders['BUY'] = [price if isPrice(price, high, low) else close for\n", - " price, high, low, close in \n", - " zip(orders['stop_loss'], orders['HIGH'], orders['LOW'], orders[REF_PRICE])]\n", - "orders['profit_per_unit'] = orders['SELL'] - orders['BUY']\n", - "orders['total_profit'] = orders['profit_per_unit'] * orders['qty']\n", - "cols = ['TIMESTAMP', 'SYMBOL', 'BUY', 'SELL', 'profit_per_unit', 'total_profit']\n", - "orders.to_csv('performance.csv', index=False)\n", - "orders[cols]" + "# Exit orders order type and price to be changed\n", + "exit_orders = orders.copy()\n", + "exit_orders['order'] = 'BUY'\n", + "exit_orders['price'] = 0\n", + "exit_orders['trigger_price'] = list(stop_loss(orders['price'], 3, order='S').round(2))\n", + "columns.update({'Order Type': 'SL-M'})\n", + "exit = create_orders(exit_orders, rename=rename, **columns)\n", + "\n", + "# File generation\n", + "entry.append(exit, sort=False)[cols].to_csv('orders_to_place.csv', \n", + " index=False, header=False)\n", + "\n", + "print('File generated')\n", + "\n", + "# If you want header change header to True\n", + "# If you want to export as excel use the to_excel function" ] } ], From 45fdfa6e92fd9bda766a76cedeadde1bbc4bec25 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 15 Sep 2018 17:40:36 +0530 Subject: [PATCH 03/53] stop loss function added --- tradingsystem/utils.py | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/tradingsystem/utils.py b/tradingsystem/utils.py index 1cc53f2..9a7465d 100644 --- a/tradingsystem/utils.py +++ b/tradingsystem/utils.py @@ -7,6 +7,35 @@ def tick(price, tick_size=0.05): """ return round(price / tick_size)*tick_size +def stop_loss(price, stop_loss, order='B', tick_size=0.05): + """ + Return the stop loss for the order + price + price from which stop loss is to be calculated + stop_loss + stop loss percentage from price + order + the original order type - B for Buy and S for Sell + If the original order is buy, then a sell stop + loss is generated and vice-versa + tick_size + tick_size to be rounded off + >>> stop_loss(100, 3) + >>> 97 + + Notes + ------ + * passing a negative value may throw unexpected results + * raises ValueError if order is other than B or S + + """ + if order == 'B': + return tick(price * (1 - stop_loss * 0.01), tick_size) + elif order == 'S': + return tick(price * (1 + stop_loss * 0.01), tick_size) + else: + raise ValueError('order should be either B or S') + def create_orders(data, rename, **kwargs): """ create an orders dataframe from an existing dataframe From ce0c93e3c067dcef7277009140714ad817d19277 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 15 Sep 2018 17:42:36 +0530 Subject: [PATCH 04/53] gitignore file added, orders directory created --- .gitignore | 139 +++++++++++++++++++++ tradingsystem/Backtest.ipynb | 20 +-- tradingsystem/orders/orders_2018-09-15.csv | 6 + 3 files changed, 155 insertions(+), 10 deletions(-) create mode 100644 .gitignore create mode 100644 tradingsystem/orders/orders_2018-09-15.csv diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..d66af95 --- /dev/null +++ b/.gitignore @@ -0,0 +1,139 @@ + +# Created by https://www.gitignore.io/api/python + +### Python ### +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[cod] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +*.egg-info/ +.installed.cfg +*.egg +MANIFEST + +# vscode +.vscode/ + +# databases +*.sqlite3 +*.h5 + +# PyInstaller +# Usually these files are written by a python script from a template +# before PyInstaller builds the exe, so as to inject date/other infos into it. +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +.hypothesis/ +.pytest_cache/ + +# Translations +*.mo +*.pot + +# Django stuff: +*.log +local_settings.py +db.sqlite3 + +# Flask stuff: +instance/ +.webassets-cache + +# Scrapy stuff: +.scrapy + +# Sphinx documentation +docs/_build/ + +# PyBuilder +target/ + +# Jupyter Notebook +.ipynb_checkpoints + +# IPython +profile_default/ +ipython_config.py + +# pyenv +.python-version + +# celery beat schedule file +celerybeat-schedule + +# SageMath parsed files +*.sage.py + +# Environments +.env +.venv +env/ +venv/ +ENV/ +env.bak/ +venv.bak/ + +# Spyder project settings +.spyderproject +.spyproject + +# Rope project settings +.ropeproject + +# mkdocs documentation +/site + +# mypy +.mypy_cache/ +.dmypy.json +dmypy.json + +### Python Patch ### +.venv/ + +### Python.VirtualEnv Stack ### +# Virtualenv +# http://iamzed.com/2009/05/07/a-primer-on-virtualenv/ +[Bb]in +[Ii]nclude +[Ll]ib +[Ll]ib64 +[Ll]ocal +[Ss]cripts +pyvenv.cfg +pip-selfcheck.json + + +# End of https://www.gitignore.io/api/python diff --git a/tradingsystem/Backtest.ipynb b/tradingsystem/Backtest.ipynb index 5d41593..dadbff0 100644 --- a/tradingsystem/Backtest.ipynb +++ b/tradingsystem/Backtest.ipynb @@ -10,7 +10,7 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": 1, "metadata": {}, "outputs": [], "source": [ @@ -30,7 +30,7 @@ }, { "cell_type": "code", - "execution_count": 3, + "execution_count": 2, "metadata": {}, "outputs": [], "source": [ @@ -80,7 +80,7 @@ }, { "cell_type": "code", - "execution_count": 4, + "execution_count": 3, "metadata": {}, "outputs": [], "source": [ @@ -92,16 +92,16 @@ }, { "cell_type": "code", - "execution_count": 5, + "execution_count": 4, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "41881" + "43802" ] }, - "execution_count": 5, + "execution_count": 4, "metadata": {}, "output_type": "execute_result" } @@ -141,7 +141,7 @@ }, { "cell_type": "code", - "execution_count": 6, + "execution_count": 5, "metadata": {}, "outputs": [], "source": [ @@ -163,7 +163,7 @@ }, { "cell_type": "code", - "execution_count": 7, + "execution_count": 6, "metadata": {}, "outputs": [], "source": [ @@ -176,7 +176,7 @@ }, { "cell_type": "code", - "execution_count": 8, + "execution_count": 7, "metadata": {}, "outputs": [], "source": [ @@ -891,7 +891,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.6.5" + "version": "3.6.6" } }, "nbformat": 4, diff --git a/tradingsystem/orders/orders_2018-09-15.csv b/tradingsystem/orders/orders_2018-09-15.csv new file mode 100644 index 0000000..81e93ee --- /dev/null +++ b/tradingsystem/orders/orders_2018-09-15.csv @@ -0,0 +1,6 @@ +SYMBOL,SERIES,OPEN,HIGH,LOW,CLOSE,LAST,PREVCLOSE,TOTTRDQTY,TOTTRDVAL,TIMESTAMP,TOTALTRADES,ISIN,RET,PctChange,OpenPrice,trigger_price,price,stop_loss,qty +COALINDIA,EQ,282.8,288.0,275.8,283.1,284.4,279.6,4990180,1399199906.35,2018-09-11,59416,INE522F01014,0.012517882689556448,0.52,283.0,282.57550000000003,282.5255,291.0,14.0 +M&M,EQ,943.0,961.0,936.3,943.15,947.0,937.35,3909701,3713736740.1,2018-09-11,88297,INE101A01026,0.006187656691737375,0.33,941.2,939.7882000000001,939.7382000000001,967.95,4.0 +INFY,EQ,735.9,744.75,732.0,734.3,733.7,730.85,6963561,5143145755.5,2018-09-11,137146,INE009A01021,0.004720530888691066,-0.13,741.9,740.78715,740.73715,762.95,5.0 +ASIANPAINT,EQ,1295.0,1313.3,1286.7,1297.85,1295.5,1293.1,1676544,2184856922.15,2018-09-11,52951,INE021A01026,0.0036733431289150964,0.6,1298.8,1296.8518,1296.8018,1335.7,3.0 +NTPC,EQ,169.05,171.75,168.75,169.75,170.1,169.2,8091175,1376813726.15,2018-09-11,47967,INE733E01010,0.003250591016548565,0.24,170.4,170.14440000000002,170.0944,175.20000000000002,24.0 From 086d1de39c6ff180fd4b097ffc977eecfb467ecb Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 15 Sep 2018 17:52:37 +0530 Subject: [PATCH 05/53] Orders file deleted from directory --- tradingsystem/orders/orders_2018-09-15.csv | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 tradingsystem/orders/orders_2018-09-15.csv diff --git a/tradingsystem/orders/orders_2018-09-15.csv b/tradingsystem/orders/orders_2018-09-15.csv deleted file mode 100644 index 81e93ee..0000000 --- a/tradingsystem/orders/orders_2018-09-15.csv +++ /dev/null @@ -1,6 +0,0 @@ -SYMBOL,SERIES,OPEN,HIGH,LOW,CLOSE,LAST,PREVCLOSE,TOTTRDQTY,TOTTRDVAL,TIMESTAMP,TOTALTRADES,ISIN,RET,PctChange,OpenPrice,trigger_price,price,stop_loss,qty -COALINDIA,EQ,282.8,288.0,275.8,283.1,284.4,279.6,4990180,1399199906.35,2018-09-11,59416,INE522F01014,0.012517882689556448,0.52,283.0,282.57550000000003,282.5255,291.0,14.0 -M&M,EQ,943.0,961.0,936.3,943.15,947.0,937.35,3909701,3713736740.1,2018-09-11,88297,INE101A01026,0.006187656691737375,0.33,941.2,939.7882000000001,939.7382000000001,967.95,4.0 -INFY,EQ,735.9,744.75,732.0,734.3,733.7,730.85,6963561,5143145755.5,2018-09-11,137146,INE009A01021,0.004720530888691066,-0.13,741.9,740.78715,740.73715,762.95,5.0 -ASIANPAINT,EQ,1295.0,1313.3,1286.7,1297.85,1295.5,1293.1,1676544,2184856922.15,2018-09-11,52951,INE021A01026,0.0036733431289150964,0.6,1298.8,1296.8518,1296.8018,1335.7,3.0 -NTPC,EQ,169.05,171.75,168.75,169.75,170.1,169.2,8091175,1376813726.15,2018-09-11,47967,INE733E01010,0.003250591016548565,0.24,170.4,170.14440000000002,170.0944,175.20000000000002,24.0 From 85fc4e64b3243ccfb96e0b1405ab3e3775caef07 Mon Sep 17 00:00:00 2001 From: machine Date: Mon, 17 Sep 2018 16:00:55 +0530 Subject: [PATCH 06/53] NewSystem updated --- tradingsystem/SystemNew.ipynb | 26 +++++++++++----------- tradingsystem/orders/orders_2018-09-17.csv | 6 +++++ tradingsystem/orders_to_place.csv | 10 +++++++++ 3 files changed, 29 insertions(+), 13 deletions(-) create mode 100644 tradingsystem/orders/orders_2018-09-17.csv create mode 100644 tradingsystem/orders_to_place.csv diff --git a/tradingsystem/SystemNew.ipynb b/tradingsystem/SystemNew.ipynb index 177fee2..9ba4499 100644 --- a/tradingsystem/SystemNew.ipynb +++ b/tradingsystem/SystemNew.ipynb @@ -23,7 +23,7 @@ }, { "cell_type": "code", - "execution_count": 1, + "execution_count": 25, "metadata": {}, "outputs": [], "source": [ @@ -41,12 +41,12 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": 26, "metadata": {}, "outputs": [], "source": [ "UNIVERSE = 'NIFTY50' # Universe to be searched\n", - "ORDER_FILENAME = 'data/cm11SEP2018bhav.csv.zip'\n", + "ORDER_FILENAME = 'data/cm14SEP2018bhav.csv.zip'\n", "STOP_LOSS = 3 # Stop loss for the order\n", "NUM_STOCKS = 5 # Number of stocks to sell\n", "CAPITAL = 20000\n", @@ -56,7 +56,7 @@ }, { "cell_type": "code", - "execution_count": 3, + "execution_count": 27, "metadata": {}, "outputs": [], "source": [ @@ -66,7 +66,7 @@ }, { "cell_type": "code", - "execution_count": 4, + "execution_count": 28, "metadata": {}, "outputs": [], "source": [ @@ -75,7 +75,7 @@ }, { "cell_type": "code", - "execution_count": 5, + "execution_count": 29, "metadata": {}, "outputs": [], "source": [ @@ -98,7 +98,7 @@ }, { "cell_type": "code", - "execution_count": 6, + "execution_count": 30, "metadata": {}, "outputs": [], "source": [ @@ -108,7 +108,7 @@ }, { "cell_type": "code", - "execution_count": 7, + "execution_count": 31, "metadata": {}, "outputs": [], "source": [ @@ -126,7 +126,7 @@ }, { "cell_type": "code", - "execution_count": 8, + "execution_count": 32, "metadata": {}, "outputs": [], "source": [ @@ -149,7 +149,7 @@ }, { "cell_type": "code", - "execution_count": 9, + "execution_count": 33, "metadata": {}, "outputs": [], "source": [ @@ -194,7 +194,7 @@ }, { "cell_type": "code", - "execution_count": 10, + "execution_count": 34, "metadata": {}, "outputs": [], "source": [ @@ -203,7 +203,7 @@ }, { "cell_type": "code", - "execution_count": 11, + "execution_count": 35, "metadata": {}, "outputs": [], "source": [ @@ -251,7 +251,7 @@ }, { "cell_type": "code", - "execution_count": 12, + "execution_count": 36, "metadata": {}, "outputs": [ { diff --git a/tradingsystem/orders/orders_2018-09-17.csv b/tradingsystem/orders/orders_2018-09-17.csv new file mode 100644 index 0000000..832676d --- /dev/null +++ b/tradingsystem/orders/orders_2018-09-17.csv @@ -0,0 +1,6 @@ +SYMBOL,SERIES,OPEN,HIGH,LOW,CLOSE,LAST,PREVCLOSE,TOTTRDQTY,TOTTRDVAL,TIMESTAMP,TOTALTRADES,ISIN,RET,PctChange,OpenPrice,trigger_price,price,stop_loss,qty +IBULHSGFIN,EQ,1153.65,1234.75,1152.0,1227.1,1225.0,1145.1,3623596,4372549715.0,2018-09-14,101918,INE148I01020,0.0716094664221465,-0.42,1222.0,1221.95,1221.9,1258.5500000000002,3.0 +BPCL,EQ,340.15,356.6,340.0,354.5,355.25,334.15,9330736,3260699196.1,2018-09-14,108286,INE029A01011,0.06090079305701046,-0.41,353.05,353.0,352.95,363.55,11.0 +VEDL,EQ,228.8,236.45,226.05,235.6,235.0,223.6,17674079,4097577697.75,2018-09-14,122443,INE205A01025,0.05366726296958846,-0.06,235.45,235.39999999999998,235.34999999999997,242.4,17.0 +HINDPETRO,EQ,245.0,254.4,244.5,252.65,253.85,240.4,7030739,1754195322.5,2018-09-14,80801,INE094A01015,0.05095673876871887,-1.01,250.1,250.04999999999998,249.99999999999997,257.5,16.0 +UPL,EQ,710.0,738.9,709.1,736.75,738.0,703.65,3848531,2810895436.35,2018-09-14,75530,INE628A01036,0.047040432032970925,-0.25,734.9,734.85,734.8000000000001,756.85,5.0 diff --git a/tradingsystem/orders_to_place.csv b/tradingsystem/orders_to_place.csv new file mode 100644 index 0000000..ee1762c --- /dev/null +++ b/tradingsystem/orders_to_place.csv @@ -0,0 +1,10 @@ +NSE,EQ,IBULHSGFIN,NA,NA,NA,1221.9,3.0,0,,SL,1221.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,BPCL,NA,NA,NA,352.95,11.0,0,,SL,353.0,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,VEDL,NA,NA,NA,235.34999999999997,17.0,0,,SL,235.39999999999998,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HINDPETRO,NA,NA,NA,249.99999999999997,16.0,0,,SL,250.04999999999998,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,UPL,NA,NA,NA,734.8000000000001,5.0,0,,SL,734.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,IBULHSGFIN,NA,NA,NA,0.0,3.0,0,BUY,SL-M,1258.55,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,BPCL,NA,NA,NA,0.0,11.0,0,BUY,SL-M,363.55,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,VEDL,NA,NA,NA,0.0,17.0,0,BUY,SL-M,242.4,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HINDPETRO,NA,NA,NA,0.0,16.0,0,BUY,SL-M,257.5,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,UPL,NA,NA,NA,0.0,5.0,0,BUY,SL-M,756.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA From f7bb3e080e191979fa19e42f3e79296b7c920f77 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 18 Sep 2018 09:47:03 +0530 Subject: [PATCH 07/53] SELL, qty as int and price to 2 decimal places --- tradingsystem/SystemNew.ipynb | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/tradingsystem/SystemNew.ipynb b/tradingsystem/SystemNew.ipynb index 9ba4499..babda17 100644 --- a/tradingsystem/SystemNew.ipynb +++ b/tradingsystem/SystemNew.ipynb @@ -23,7 +23,7 @@ }, { "cell_type": "code", - "execution_count": 25, + "execution_count": 1, "metadata": {}, "outputs": [], "source": [ @@ -41,12 +41,12 @@ }, { "cell_type": "code", - "execution_count": 26, + "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "UNIVERSE = 'NIFTY50' # Universe to be searched\n", - "ORDER_FILENAME = 'data/cm14SEP2018bhav.csv.zip'\n", + "ORDER_FILENAME = 'data/cm17SEP2018bhav.csv.zip'\n", "STOP_LOSS = 3 # Stop loss for the order\n", "NUM_STOCKS = 5 # Number of stocks to sell\n", "CAPITAL = 20000\n", @@ -56,7 +56,7 @@ }, { "cell_type": "code", - "execution_count": 27, + "execution_count": 3, "metadata": {}, "outputs": [], "source": [ @@ -66,7 +66,7 @@ }, { "cell_type": "code", - "execution_count": 28, + "execution_count": 4, "metadata": {}, "outputs": [], "source": [ @@ -75,7 +75,7 @@ }, { "cell_type": "code", - "execution_count": 29, + "execution_count": 5, "metadata": {}, "outputs": [], "source": [ @@ -98,7 +98,7 @@ }, { "cell_type": "code", - "execution_count": 30, + "execution_count": 6, "metadata": {}, "outputs": [], "source": [ @@ -108,7 +108,7 @@ }, { "cell_type": "code", - "execution_count": 31, + "execution_count": 7, "metadata": {}, "outputs": [], "source": [ @@ -126,7 +126,7 @@ }, { "cell_type": "code", - "execution_count": 32, + "execution_count": 8, "metadata": {}, "outputs": [], "source": [ @@ -149,14 +149,15 @@ }, { "cell_type": "code", - "execution_count": 33, + "execution_count": 9, "metadata": {}, "outputs": [], "source": [ "# Stop loss and quantity automatically generated\n", "\n", - "orders['stop_loss'] = (orders['price'] * (1 + STOP_LOSS * 0.01)).round(2).apply(tick)\n", - "orders['qty'] = (trading_capital/num_stock/orders['price']).round()\n", + "orders['stop_loss'] = (orders['price'] * (1 + STOP_LOSS * 0.01)).apply(tick).round(2)\n", + "orders['qty'] = (trading_capital/num_stock/orders['price']).astype(int)\n", + "orders['order'] = 'SELL'\n", "import datetime\n", "filename = ORDERFILE_PREFIX + datetime.datetime.today().strftime('%Y-%m-%d') + '.csv'\n", "orders.to_csv('orders/' + filename, index=False)" @@ -194,7 +195,7 @@ }, { "cell_type": "code", - "execution_count": 34, + "execution_count": 10, "metadata": {}, "outputs": [], "source": [ @@ -203,7 +204,7 @@ }, { "cell_type": "code", - "execution_count": 35, + "execution_count": 11, "metadata": {}, "outputs": [], "source": [ @@ -251,7 +252,7 @@ }, { "cell_type": "code", - "execution_count": 36, + "execution_count": 12, "metadata": {}, "outputs": [ { From 7aed76beb1808396962113e4ebfaa97131ab1395 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 18 Sep 2018 21:24:13 +0530 Subject: [PATCH 08/53] rounding error in SELL orders corrected --- tradingsystem/SystemNew.ipynb | 6 +++--- tradingsystem/orders_to_place.csv | 20 ++++++++++---------- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/tradingsystem/SystemNew.ipynb b/tradingsystem/SystemNew.ipynb index babda17..dd2282d 100644 --- a/tradingsystem/SystemNew.ipynb +++ b/tradingsystem/SystemNew.ipynb @@ -133,8 +133,8 @@ "# I prefer a constant percentage change instead of value\n", "# If you prefer it, make this raw and use the below cell\n", "\n", - "orders['trigger_price'] = orders['OpenPrice'] - 0.05\n", - "orders['price'] = orders['trigger_price'] - 0.05" + "orders['trigger_price'] = (orders['OpenPrice'] - 0.05).round(2)\n", + "orders['price'] = (orders['trigger_price'] - 0.05).round(2)" ] }, { @@ -272,7 +272,7 @@ "exit_orders = orders.copy()\n", "exit_orders['order'] = 'BUY'\n", "exit_orders['price'] = 0\n", - "exit_orders['trigger_price'] = list(stop_loss(orders['price'], 3, order='S').round(2))\n", + "exit_orders['trigger_price'] = stop_loss(orders['price'], 3, order='S').round(2)\n", "columns.update({'Order Type': 'SL-M'})\n", "exit = create_orders(exit_orders, rename=rename, **columns)\n", "\n", diff --git a/tradingsystem/orders_to_place.csv b/tradingsystem/orders_to_place.csv index ee1762c..dfca55c 100644 --- a/tradingsystem/orders_to_place.csv +++ b/tradingsystem/orders_to_place.csv @@ -1,10 +1,10 @@ -NSE,EQ,IBULHSGFIN,NA,NA,NA,1221.9,3.0,0,,SL,1221.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,BPCL,NA,NA,NA,352.95,11.0,0,,SL,353.0,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,VEDL,NA,NA,NA,235.34999999999997,17.0,0,,SL,235.39999999999998,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,HINDPETRO,NA,NA,NA,249.99999999999997,16.0,0,,SL,250.04999999999998,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,UPL,NA,NA,NA,734.8000000000001,5.0,0,,SL,734.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,IBULHSGFIN,NA,NA,NA,0.0,3.0,0,BUY,SL-M,1258.55,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,BPCL,NA,NA,NA,0.0,11.0,0,BUY,SL-M,363.55,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,VEDL,NA,NA,NA,0.0,17.0,0,BUY,SL-M,242.4,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,HINDPETRO,NA,NA,NA,0.0,16.0,0,BUY,SL-M,257.5,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,UPL,NA,NA,NA,0.0,5.0,0,BUY,SL-M,756.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,BPCL,NA,NA,NA,364.9,10,0,SELL,SL,364.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HINDPETRO,NA,NA,NA,258.4,15,0,SELL,SL,258.45,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,EICHERMOT,NA,NA,NA,29600.9,0,0,SELL,SL,29600.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,TECHM,NA,NA,NA,769.75,5,0,SELL,SL,769.8,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,POWERGRID,NA,NA,NA,201.4,19,0,SELL,SL,201.45,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,BPCL,NA,NA,NA,0.0,10,0,BUY,SL-M,375.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HINDPETRO,NA,NA,NA,0.0,15,0,BUY,SL-M,266.15,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,EICHERMOT,NA,NA,NA,0.0,0,0,BUY,SL-M,30488.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,TECHM,NA,NA,NA,0.0,5,0,BUY,SL-M,792.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,POWERGRID,NA,NA,NA,0.0,19,0,BUY,SL-M,207.45,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA From aa339901a36ded9fb2733ba32e714744d759f7b7 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 25 Sep 2018 14:22:23 +0530 Subject: [PATCH 09/53] List tutorial updated --- notebooks/List and Dicts.ipynb | 196 +++++++++++++++++++++++++++++++++ 1 file changed, 196 insertions(+) create mode 100644 notebooks/List and Dicts.ipynb diff --git a/notebooks/List and Dicts.ipynb b/notebooks/List and Dicts.ipynb new file mode 100644 index 0000000..23c6770 --- /dev/null +++ b/notebooks/List and Dicts.ipynb @@ -0,0 +1,196 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python primer\n", + "This tutorial assumes you have installed python 3 via [anaconda].(https://www.anaconda.com/download/) and using jupyter notebook\n", + "\n", + "This is an extremely basic introduction to Python to get you started. This is not a python tutorial per se. If you want a more formal and thorough start to python, I recommend this excellent course from [datacamp](https://www.datacamp.com/courses/intro-to-python-for-data-science)." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We need some sort of a structure to store data. These are called data structures. We would now dive into 2 basic data structures provided by Python\n", + " - lists\n", + " - dictionaries\n", + " \n", + "**Lists** are simply arrays that are indexed by numbers.\n", + "\n", + "**Dictionaries** are simple key-value pairs.\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "##\n", + "Lists\n", + "Lists in python start and end with a square bracket; items inside a list are separated by commas. Lists can contain anything within it and not restricted to a particular type; even an another list. Lists are indexed starting with 0.\n", + "\n", + "```python\n", + "# This is a list with 4 elements\n", + "a_list = [1,2,3,4]\n", + "```\n", + "\n", + "You can access the items in a list by using the same square brackets\n", + "```python\n", + "a_list[0] # returns 1 since list index start with zero\n", + "```\n", + "\n", + "See the below examples" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# This is a list with 10 items\n", + "a_list = [0,1,2,3,'a','b','c',0.5,'hello',[10,20,30]]\n", + "print(a_list)\n", + "\n", + "# Get the first item\n", + "print(a_list[0])\n", + "\n", + "# Get the last item\n", + "print(a_list[9])\n", + "\n", + "# Get the second last item, the 9th item\n", + "print(a_list[-2])\n", + "\n", + "# Access the first five elements\n", + "print(a_list[0:5])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "As seen in the above example you could use the minus sign to access items backwards. So -1 mean the last item, -2 mean the second last and so on.\n", + "\n", + "You could also use the colon, *called the slice operator*, to get more than one items. The syntax is ```list[start:end:step]``` where \n", + " - start is the starting item you want to get\n", + " - end is the final item you want to get\n", + " - step is the step size taken at each access\n", + " \n", + "**Note, to get the first 4 items, you should use list[0:4] and not 3 since python doesn't get the last item.**\n", + "\n", + "See the examples below" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# Would fetch the first 3 items, not the fourth one\n", + "print(a_list[0:3])\n", + "\n", + "# Same as above\n", + "print(a_list[:3])\n", + "\n", + "# Get items 1,3,5,7,9\n", + "print(a_list[0::2]) # 2 is the step size\n", + "\n", + "# Get the last 4 items\n", + "print(a_list[-4:]) \n", + "\n", + "# Use the len function to know the length of the list\n", + "len(a_list)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You can add, remove, find an item in a list" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# Append adds an item to the list\n", + "a_list.append('add')\n", + "print(a_list)\n", + "\n", + "# Remove an item by value - removes only the first occurence\n", + "a_list.remove(2)\n", + "print(a_list)\n", + "\n", + "# Find the index of an items - returns only the first index\n", + "print(a_list.index('a'))\n", + "\n", + "# Count the number of occurences of an item\n", + "print(a_list.count('a'))\n", + "\n", + "# Reverse the entire list\n", + "a_list.reverse()\n", + "print(a_list)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Nested lists\n", + "You can have list inside a list inside a list and so on. Use the appropriate number of square brackets to get the required item.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# A deeply nested list. Play with it to understand it\n", + "nested_list = [\n", + " [1,2], \n", + " [3,4,[5,6]], \n", + " [7,8,[9,[10,11,12]]]\n", + "]\n", + "\n", + "print(nested_list[0]) \n", + "print(nested_list[0][0])\n", + "print(nested_list[1][2][1])\n", + "print(nested_list[2][2][1][1])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Dictionaries" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.6.6" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} From 8bb3e866881f4c6b71874561eccde5ffb7c8b80f Mon Sep 17 00:00:00 2001 From: uberdeveloper Date: Tue, 25 Sep 2018 20:36:13 +0530 Subject: [PATCH 10/53] Data Structures updated --- notebooks/DataStructures.ipynb | 495 +++++++++++++++++++++++++++++++++ notebooks/List and Dicts.ipynb | 196 ------------- 2 files changed, 495 insertions(+), 196 deletions(-) create mode 100644 notebooks/DataStructures.ipynb delete mode 100644 notebooks/List and Dicts.ipynb diff --git a/notebooks/DataStructures.ipynb b/notebooks/DataStructures.ipynb new file mode 100644 index 0000000..c44b78f --- /dev/null +++ b/notebooks/DataStructures.ipynb @@ -0,0 +1,495 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python primer\n", + "This tutorial assumes you have installed python 3 via [anaconda].(https://www.anaconda.com/download/) and using jupyter notebook\n", + "\n", + "This is an extremely basic introduction to Python to get you started. This is not a python tutorial per se. If you want a more formal and thorough start to python, I recommend this excellent course from [datacamp](https://www.datacamp.com/courses/intro-to-python-for-data-science)." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We need some sort of a structure to store data. These are called data structures. We would now dive into 2 basic data structures provided by Python\n", + " - lists\n", + " - dictionaries\n", + " \n", + "**Lists** are simply arrays that are indexed by numbers.\n", + "\n", + "**Dictionaries** are simple key-value pairs.\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Lists\n", + "\n", + "Lists in python start and end with a square bracket; items inside a list are separated by commas. Lists can contain anything within it and not restricted to a particular type; even an another list. Lists are indexed starting with 0.\n", + "\n", + "```python\n", + "# This is a list with 4 elements\n", + "a_list = [1,2,3,4]\n", + "```\n", + "\n", + "You can access the items in a list by using the same square brackets\n", + "```python\n", + "a_list[0] # returns 1 since list index start with zero\n", + "```\n", + "\n", + "See the below examples" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[0, 1, 2, 3, 'a', 'b', 'c', 0.5, 'hello', [10, 20, 30]]\n", + "0\n", + "[10, 20, 30]\n", + "hello\n", + "[0, 1, 2, 3, 'a']\n" + ] + } + ], + "source": [ + "# This is a list with 10 items\n", + "a_list = [0,1,2,3,'a','b','c',0.5,'hello',[10,20,30]]\n", + "print(a_list)\n", + "\n", + "# Get the first item\n", + "print(a_list[0])\n", + "\n", + "# Get the last item\n", + "print(a_list[9])\n", + "\n", + "# Get the second last item, the 9th item\n", + "print(a_list[-2])\n", + "\n", + "# Access the first five elements\n", + "print(a_list[0:5])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "As seen in the above example you could use the minus sign to access items backwards. So -1 mean the last item, -2 mean the second last and so on.\n", + "\n", + "You could also use the colon, *called the slice operator*, to get more than one items. The syntax is ```list[start:end:step]``` where \n", + " - start is the starting item you want to get\n", + " - end is the final item you want to get\n", + " - step is the step size taken at each access\n", + " \n", + "**Note, to get the first 4 items, you should use list[0:4] and not 3 since python doesn't get the last item.**\n", + "\n", + "See the examples below" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[0, 1, 2]\n", + "[0, 1, 2]\n", + "[0, 2, 'a', 'c', 'hello']\n", + "['c', 0.5, 'hello', [10, 20, 30]]\n" + ] + }, + { + "data": { + "text/plain": [ + "10" + ] + }, + "execution_count": 2, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Would fetch the first 3 items, not the fourth one\n", + "print(a_list[0:3])\n", + "\n", + "# Same as above\n", + "print(a_list[:3])\n", + "\n", + "# Get items 1,3,5,7,9\n", + "print(a_list[0::2]) # 2 is the step size\n", + "\n", + "# Get the last 4 items\n", + "print(a_list[-4:]) \n", + "\n", + "# Use the len function to know the length of the list\n", + "len(a_list)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You can add, remove, find an item in a list" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[0, 1, 2, 3, 'a', 'b', 'c', 0.5, 'hello', [10, 20, 30], 'add']\n", + "[0, 1, 3, 'a', 'b', 'c', 0.5, 'hello', [10, 20, 30], 'add']\n", + "3\n", + "1\n", + "['add', [10, 20, 30], 'hello', 0.5, 'c', 'b', 'a', 3, 1, 0]\n" + ] + } + ], + "source": [ + "# Append adds an item to the list\n", + "a_list.append('add')\n", + "print(a_list)\n", + "\n", + "# Remove an item by value - removes only the first occurence\n", + "a_list.remove(2)\n", + "print(a_list)\n", + "\n", + "# Find the index of an items - returns only the first index\n", + "print(a_list.index('a'))\n", + "\n", + "# Count the number of occurences of an item\n", + "print(a_list.count('a'))\n", + "\n", + "# Reverse the entire list\n", + "a_list.reverse()\n", + "print(a_list)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Nested lists\n", + "You can have list inside a list inside a list and so on. Use the appropriate number of square brackets to get the required item.\n" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[1, 2]\n", + "1\n", + "6\n", + "11\n" + ] + } + ], + "source": [ + "# A deeply nested list. Play with it to understand it\n", + "nested_list = [\n", + " [1,2], \n", + " [3,4,[5,6]], \n", + " [7,8,[9,[10,11,12]]]\n", + "]\n", + "\n", + "print(nested_list[0]) \n", + "print(nested_list[0][0])\n", + "print(nested_list[1][2][1])\n", + "print(nested_list[2][2][1][1])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Dictionaries\n", + "\n", + "Dictionaries are simple key-value pairs. Dictionaries in python start and end with curly braces, key and value are separated by colon and key value pairs are separated by commas. You can access\n", + "\n", + "```python\n", + "a_dict = {'firstName': 'John', 'lastName': 'Smith', 'age': 25}\n", + "```\n", + "\n", + "You can access the individual values by keys with a square bracket\n", + "```python\n", + "a_dict['firstName'] # returns John\n", + "```\n", + "\n", + "A few points to note\n", + "\n", + "- a dictionary is a hash implementation\n", + "- keys in dictionary are **unique not sorted**; they are not accessible by index\n", + "- you cannot lookup a key for a value directly\n", + "- values could be anything, even an another dictionary\n", + "- keys could also by anything but strings are preferred for consistency\n", + "- you can access only one key at a time" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'firstName': 'John', 'lastName': 'Smith', 'age': 25}\n", + "25\n", + "{'firstName': 'John', 'lastName': 'Smith', 'age': 31, 'gender': 'Male'}\n" + ] + } + ], + "source": [ + "# A simple dictionary\n", + "a_dict = {'firstName': 'John', 'lastName': 'Smith', 'age': 25}\n", + "print(a_dict)\n", + "\n", + "# Get an item\n", + "print(a_dict['age'])\n", + "\n", + "# Set an item\n", + "a_dict['age'] = 31\n", + "# Add a new item\n", + "a_dict['gender'] = 'Male'\n", + "print(a_dict)\n", + "\n", + "# Remove an item\n", + "del a_dict['gender']" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "dict_keys(['firstName', 'lastName', 'age'])\n", + "dict_values(['John', 'Smith', 31])\n", + "{'firstName': 'John', 'lastName': 'Smith', 'age': 31, 'employed': True, 'middleName': 'Richard'}\n" + ] + }, + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 6, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Get all the keys\n", + "print(a_dict.keys())\n", + "\n", + "# Get all the values\n", + "print(a_dict.values())\n", + "\n", + "# Update multiple items\n", + "a_dict.update({'employed': True, 'middleName': 'Richard'})\n", + "print(a_dict)\n", + "\n", + "# Check if a key is in a dictionary\n", + "'middleName' in a_dict" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Nested dictionaries\n", + "\n", + "You could combine dictionaries within dictionaries within dictionaries and so on similar to lists. Use appropriate square brackets to get the value.\n", + "\n", + "You could create any data structure with this approach." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "1\n", + "3\n", + "John\n" + ] + } + ], + "source": [ + "nested_dict = {\n", + " 'a': 1,\n", + " 'b': 2,\n", + " 'points': {'x': 3, 'y': 2, 'z': 10},\n", + " 'person':\n", + " {\n", + " 'name':\n", + " {\n", + " 'first': 'John',\n", + " 'last': 'Smith'\n", + " }\n", + " }\n", + "}\n", + "print(nested_dict['a'])\n", + "print(nested_dict['points']['x'])\n", + "print(nested_dict['person']['name']['first'])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Combining lists and dictionaries\n", + "\n", + "You can combine lists and dictionaries in various ways to create any data structure you need and further build upon them. Since both of them could be nested within each other, they are extremly flexible. \n", + "\n", + "One of the common methods is to either create your data structure as a list of dictionaries or a dictionary of different lists.\n", + "To access such a deeply nested structure use the **right key and index**. \n", + "\n", + "Let's see an example. We would create the following invoice in 2 different ways\n", + "\n", + "product|qty|rate|value|tax|gross\n", + "-------|---|----|-----|---|-----\n", + "a|10|5|50|8|58\n", + "b|1|35|35|0|35\n", + "c|5|8|40|10|50\n" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "a\n", + "a\n" + ] + } + ], + "source": [ + "# A dict of lists\n", + "\n", + "data1 = {\n", + " 'product': ['a', 'b', 'c'],\n", + " 'qty': [10, 1, 5],\n", + " 'rate': [5, 35, 8],\n", + " 'value': [50, 35, 40],\n", + " 'tax': [8, 0, 10],\n", + " 'gross': [58, 35, 50]\n", + "}\n", + "\n", + "# A list of dicts\n", + "data2 = [\n", + " {'product': 'a', 'qty': 10, 'rate': 5, 'value': 50, 'tax': 8, 'gross': 58},\n", + " {'product': 'b', 'qty': 1, 'rate': 35, 'value': 35, 'tax': 0, 'gross': 35},\n", + " {'product': 'c', 'qty': 5, 'rate': 8, 'value': 40, 'tax': 10, 'gross': 50}\n", + "]\n", + "\n", + "print(data1['product'][0])\n", + "print(data2[0]['product'])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Sets\n", + "\n", + "Python also provides a set data structure that works exactly like sets in mathematics. \n", + "See a quick introduction to sets [here](https://www.mathsisfun.com/sets/sets-introduction.html)\n", + "\n", + "Its a very useful one for\n", + " - having a unique set of items\n", + " - do common set operations\n", + " \n", + "You could create a set with a pair of curly braces with items separated by commas." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{1, 2, 3, 4, 5}\n", + "{1, 3}\n", + "{2, 4}\n" + ] + } + ], + "source": [ + "set_one = {1, 2, 3, 4}\n", + "set_two = {1, 3, 5}\n", + "\n", + "# Union\n", + "print(set_one.union(set_two))\n", + "\n", + "# Intersection\n", + "print(set_one.intersection(set_two))\n", + "\n", + "# Difference\n", + "print(set_one.difference(set_two))\n", + "\n", + "# The above are just common functions.\n", + "# Python sets provide a full list of set functions you could explore" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.6.6" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/notebooks/List and Dicts.ipynb b/notebooks/List and Dicts.ipynb deleted file mode 100644 index 23c6770..0000000 --- a/notebooks/List and Dicts.ipynb +++ /dev/null @@ -1,196 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Python primer\n", - "This tutorial assumes you have installed python 3 via [anaconda].(https://www.anaconda.com/download/) and using jupyter notebook\n", - "\n", - "This is an extremely basic introduction to Python to get you started. This is not a python tutorial per se. If you want a more formal and thorough start to python, I recommend this excellent course from [datacamp](https://www.datacamp.com/courses/intro-to-python-for-data-science)." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need some sort of a structure to store data. These are called data structures. We would now dive into 2 basic data structures provided by Python\n", - " - lists\n", - " - dictionaries\n", - " \n", - "**Lists** are simply arrays that are indexed by numbers.\n", - "\n", - "**Dictionaries** are simple key-value pairs.\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "##\n", - "Lists\n", - "Lists in python start and end with a square bracket; items inside a list are separated by commas. Lists can contain anything within it and not restricted to a particular type; even an another list. Lists are indexed starting with 0.\n", - "\n", - "```python\n", - "# This is a list with 4 elements\n", - "a_list = [1,2,3,4]\n", - "```\n", - "\n", - "You can access the items in a list by using the same square brackets\n", - "```python\n", - "a_list[0] # returns 1 since list index start with zero\n", - "```\n", - "\n", - "See the below examples" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [ - "# This is a list with 10 items\n", - "a_list = [0,1,2,3,'a','b','c',0.5,'hello',[10,20,30]]\n", - "print(a_list)\n", - "\n", - "# Get the first item\n", - "print(a_list[0])\n", - "\n", - "# Get the last item\n", - "print(a_list[9])\n", - "\n", - "# Get the second last item, the 9th item\n", - "print(a_list[-2])\n", - "\n", - "# Access the first five elements\n", - "print(a_list[0:5])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As seen in the above example you could use the minus sign to access items backwards. So -1 mean the last item, -2 mean the second last and so on.\n", - "\n", - "You could also use the colon, *called the slice operator*, to get more than one items. The syntax is ```list[start:end:step]``` where \n", - " - start is the starting item you want to get\n", - " - end is the final item you want to get\n", - " - step is the step size taken at each access\n", - " \n", - "**Note, to get the first 4 items, you should use list[0:4] and not 3 since python doesn't get the last item.**\n", - "\n", - "See the examples below" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [ - "# Would fetch the first 3 items, not the fourth one\n", - "print(a_list[0:3])\n", - "\n", - "# Same as above\n", - "print(a_list[:3])\n", - "\n", - "# Get items 1,3,5,7,9\n", - "print(a_list[0::2]) # 2 is the step size\n", - "\n", - "# Get the last 4 items\n", - "print(a_list[-4:]) \n", - "\n", - "# Use the len function to know the length of the list\n", - "len(a_list)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "You can add, remove, find an item in a list" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [ - "# Append adds an item to the list\n", - "a_list.append('add')\n", - "print(a_list)\n", - "\n", - "# Remove an item by value - removes only the first occurence\n", - "a_list.remove(2)\n", - "print(a_list)\n", - "\n", - "# Find the index of an items - returns only the first index\n", - "print(a_list.index('a'))\n", - "\n", - "# Count the number of occurences of an item\n", - "print(a_list.count('a'))\n", - "\n", - "# Reverse the entire list\n", - "a_list.reverse()\n", - "print(a_list)\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Nested lists\n", - "You can have list inside a list inside a list and so on. Use the appropriate number of square brackets to get the required item.\n" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [ - "# A deeply nested list. Play with it to understand it\n", - "nested_list = [\n", - " [1,2], \n", - " [3,4,[5,6]], \n", - " [7,8,[9,[10,11,12]]]\n", - "]\n", - "\n", - "print(nested_list[0]) \n", - "print(nested_list[0][0])\n", - "print(nested_list[1][2][1])\n", - "print(nested_list[2][2][1][1])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Dictionaries" - ] - } - ], - "metadata": { - "kernelspec": { - "display_name": "Python 3", - "language": "python", - "name": "python3" - }, - "language_info": { - "codemirror_mode": { - "name": "ipython", - "version": 3 - }, - "file_extension": ".py", - "mimetype": "text/x-python", - "name": "python", - "nbconvert_exporter": "python", - "pygments_lexer": "ipython3", - "version": "3.6.6" - } - }, - "nbformat": 4, - "nbformat_minor": 2 -} From 076e439447f0fd1f6a21e19f8b593fe82a73f336 Mon Sep 17 00:00:00 2001 From: machine Date: Thu, 27 Sep 2018 19:31:47 +0530 Subject: [PATCH 11/53] NUM_STOCKS variable used for output --- tradingsystem/Backtest.ipynb | 796 ++++++++++++++++++----------------- 1 file changed, 403 insertions(+), 393 deletions(-) diff --git a/tradingsystem/Backtest.ipynb b/tradingsystem/Backtest.ipynb index dadbff0..cd001fd 100644 --- a/tradingsystem/Backtest.ipynb +++ b/tradingsystem/Backtest.ipynb @@ -98,7 +98,7 @@ { "data": { "text/plain": [ - "43802" + "49510" ] }, "execution_count": 4, @@ -155,7 +155,7 @@ "grouped = df.groupby('timestamp')\n", "collect = []\n", "for name, group in grouped:\n", - " temp = group.sort_values(by='ret', ascending=False).iloc[:5]\n", + " temp = group.sort_values(by='ret', ascending=False).iloc[:NUM_STOCKS]\n", " collect.append(temp)\n", "orders = pd.concat(collect)\n", " " @@ -204,7 +204,7 @@ }, { "cell_type": "code", - "execution_count": 9, + "execution_count": 8, "metadata": {}, "outputs": [ { @@ -241,86 +241,86 @@ " \n", " \n", " \n", - " 1060\n", - " DRREDDY\n", - " 2510.0\n", - " 2632.0\n", - " 2495.00\n", - " 2593.40\n", - " 2.0\n", - " 2610.40\n", - " 2510.0\n", - " -200.80\n", + " 1221\n", + " IBULHSGFIN\n", + " 1222.00\n", + " 1222.00\n", + " 1187.50\n", + " 1200.85\n", + " 3.0\n", + " 1200.85\n", + " 1222.00\n", + " 63.45\n", " \n", " \n", - " 1092\n", - " TECHM\n", - " 768.0\n", - " 776.5\n", - " 741.50\n", - " 745.65\n", - " 5.0\n", - " 745.65\n", - " 768.0\n", - " 111.75\n", + " 1207\n", + " BPCL\n", + " 353.05\n", + " 367.25\n", + " 348.10\n", + " 364.00\n", + " 11.0\n", + " 367.17\n", + " 353.05\n", + " -155.32\n", " \n", " \n", - " 1080\n", - " LUPIN\n", - " 936.5\n", - " 957.9\n", - " 931.55\n", - " 936.10\n", - " 4.0\n", - " 936.10\n", - " 936.5\n", - " 1.60\n", + " 1246\n", + " VEDL\n", + " 235.45\n", + " 237.75\n", + " 232.15\n", + " 234.90\n", + " 17.0\n", + " 234.90\n", + " 235.45\n", + " 9.35\n", " \n", " \n", - " 1089\n", - " TATAMOTORS\n", - " 271.4\n", - " 273.0\n", - " 265.25\n", - " 266.60\n", - " 15.0\n", - " 266.60\n", - " 271.4\n", - " 72.00\n", + " 1219\n", + " HINDPETRO\n", + " 250.10\n", + " 260.45\n", + " 248.00\n", + " 258.35\n", + " 16.0\n", + " 260.10\n", + " 250.10\n", + " -160.00\n", " \n", " \n", - " 1064\n", - " HCLTECH\n", - " 1053.0\n", - " 1061.0\n", - " 1044.60\n", - " 1049.15\n", - " 4.0\n", - " 1049.15\n", - " 1053.0\n", - " 15.40\n", + " 1245\n", + " UPL\n", + " 734.90\n", + " 735.95\n", + " 722.00\n", + " 723.50\n", + " 5.0\n", + " 723.50\n", + " 734.90\n", + " 57.00\n", " \n", " \n", "\n", "" ], "text/plain": [ - " symbol open high low close qty buy sell \\\n", - "1060 DRREDDY 2510.0 2632.0 2495.00 2593.40 2.0 2610.40 2510.0 \n", - "1092 TECHM 768.0 776.5 741.50 745.65 5.0 745.65 768.0 \n", - "1080 LUPIN 936.5 957.9 931.55 936.10 4.0 936.10 936.5 \n", - "1089 TATAMOTORS 271.4 273.0 265.25 266.60 15.0 266.60 271.4 \n", - "1064 HCLTECH 1053.0 1061.0 1044.60 1049.15 4.0 1049.15 1053.0 \n", + " symbol open high low close qty buy sell \\\n", + "1221 IBULHSGFIN 1222.00 1222.00 1187.50 1200.85 3.0 1200.85 1222.00 \n", + "1207 BPCL 353.05 367.25 348.10 364.00 11.0 367.17 353.05 \n", + "1246 VEDL 235.45 237.75 232.15 234.90 17.0 234.90 235.45 \n", + "1219 HINDPETRO 250.10 260.45 248.00 258.35 16.0 260.10 250.10 \n", + "1245 UPL 734.90 735.95 722.00 723.50 5.0 723.50 734.90 \n", "\n", " total_profit \n", - "1060 -200.80 \n", - "1092 111.75 \n", - "1080 1.60 \n", - "1089 72.00 \n", - "1064 15.40 " + "1221 63.45 \n", + "1207 -155.32 \n", + "1246 9.35 \n", + "1219 -160.00 \n", + "1245 57.00 " ] }, - "execution_count": 9, + "execution_count": 8, "metadata": {}, "output_type": "execute_result" } @@ -332,16 +332,16 @@ }, { "cell_type": "code", - "execution_count": 10, + "execution_count": 9, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "'Returns for the period = 4.11%'" + "'Returns for the period = 3.11%'" ] }, - "execution_count": 10, + "execution_count": 9, "metadata": {}, "output_type": "execute_result" } @@ -353,27 +353,37 @@ }, { "cell_type": "code", - "execution_count": 15, + "execution_count": 14, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "613.7999999999997" + "timestamp\n", + "2018-08-13 372.90\n", + "2018-08-21 37.35\n", + "2018-08-23 90.00\n", + "2018-08-27 46.40\n", + "2018-08-30 67.15\n", + "2018-09-11 0.00\n", + "2018-09-12 37.50\n", + "2018-09-17 63.45\n", + "Name: total_profit, dtype: float64" ] }, - "execution_count": 15, + "execution_count": 14, "metadata": {}, "output_type": "execute_result" } ], "source": [ - "orders[orders['open'] == orders['high']].total_profit.sum()" + "filtered = orders[orders['open'] == orders['high']]\n", + "filtered.groupby('timestamp').total_profit.sum()" ] }, { "cell_type": "code", - "execution_count": 12, + "execution_count": 11, "metadata": {}, "outputs": [ { @@ -399,7 +409,7 @@ }, { "cell_type": "code", - "execution_count": 13, + "execution_count": 12, "metadata": {}, "outputs": [ { @@ -446,341 +456,341 @@ " \n", " open\n", " 1.000000\n", - " 0.999981\n", + " 0.999989\n", + " 0.999985\n", " 0.999974\n", - " 0.999957\n", - " 0.999960\n", + " 0.999976\n", " 0.999999\n", - " -0.148897\n", - " -0.069653\n", - " -0.150378\n", - " 0.174624\n", + " -0.148407\n", + " -0.084277\n", + " -0.174985\n", + " 0.106600\n", " 1.000000\n", " 1.000000\n", - " -0.351303\n", + " -0.341461\n", " 1.000000\n", - " 0.999955\n", - " 0.892213\n", - " -0.047230\n", + " 0.999973\n", + " 0.940206\n", + " -0.015494\n", " \n", " \n", " high\n", - " 0.999981\n", + " 0.999989\n", " 1.000000\n", - " 0.999985\n", - " 0.999990\n", " 0.999991\n", - " 0.999978\n", - " -0.149135\n", - " -0.068445\n", - " -0.149667\n", - " 0.174166\n", - " 0.999981\n", - " 0.999981\n", - " -0.353789\n", - " 0.999981\n", + " 0.999993\n", + " 0.999994\n", + " 0.999987\n", + " -0.148559\n", + " -0.083319\n", + " -0.174466\n", + " 0.106431\n", " 0.999989\n", - " 0.889674\n", - " -0.050773\n", + " 0.999989\n", + " -0.343225\n", + " 0.999989\n", + " 0.999993\n", + " 0.938756\n", + " -0.017994\n", " \n", " \n", " low\n", - " 0.999974\n", " 0.999985\n", + " 0.999991\n", + " 1.000000\n", + " 0.999994\n", + " 0.999994\n", + " 0.999984\n", + " -0.149443\n", + " -0.084238\n", + " -0.175400\n", + " 0.105659\n", + " 0.999985\n", + " 0.999985\n", + " -0.343661\n", + " 0.999985\n", + " 0.999993\n", + " 0.938542\n", + " -0.017418\n", + " \n", + " \n", + " close\n", + " 0.999974\n", + " 0.999993\n", + " 0.999994\n", + " 1.000000\n", " 1.000000\n", - " 0.999990\n", - " 0.999990\n", " 0.999973\n", - " -0.150328\n", - " -0.069683\n", - " -0.150962\n", - " 0.173019\n", + " -0.149469\n", + " -0.083687\n", + " -0.175015\n", + " 0.105847\n", " 0.999974\n", " 0.999974\n", - " -0.354394\n", + " -0.344469\n", " 0.999974\n", - " 0.999989\n", - " 0.889338\n", - " -0.049820\n", - " \n", - " \n", - " close\n", - " 0.999957\n", - " 0.999990\n", - " 0.999990\n", - " 1.000000\n", - " 1.000000\n", - " 0.999954\n", - " -0.150318\n", - " -0.068979\n", - " -0.150405\n", - " 0.173123\n", - " 0.999957\n", - " 0.999957\n", - " -0.355375\n", - " 0.999957\n", - " 1.000000\n", - " 0.888022\n", - " -0.052584\n", + " 1.000000\n", + " 0.937734\n", + " -0.019398\n", " \n", " \n", " last\n", - " 0.999960\n", - " 0.999991\n", - " 0.999990\n", - " 1.000000\n", - " 1.000000\n", - " 0.999956\n", - " -0.150334\n", - " -0.069011\n", - " -0.150401\n", - " 0.173261\n", - " 0.999960\n", - " 0.999960\n", - " -0.355334\n", - " 0.999960\n", - " 0.999999\n", - " 0.888153\n", - " -0.052516\n", + " 0.999976\n", + " 0.999994\n", + " 0.999994\n", + " 1.000000\n", + " 1.000000\n", + " 0.999975\n", + " -0.149456\n", + " -0.083690\n", + " -0.174994\n", + " 0.105973\n", + " 0.999976\n", + " 0.999976\n", + " -0.344395\n", + " 0.999976\n", + " 1.000000\n", + " 0.937823\n", + " -0.019328\n", " \n", " \n", " prevclose\n", " 0.999999\n", - " 0.999978\n", + " 0.999987\n", + " 0.999984\n", " 0.999973\n", - " 0.999954\n", - " 0.999956\n", + " 0.999975\n", " 1.000000\n", - " -0.148804\n", - " -0.069727\n", - " -0.150461\n", - " 0.174287\n", + " -0.148386\n", + " -0.084348\n", + " -0.175093\n", + " 0.106624\n", " 0.999999\n", " 0.999999\n", - " -0.350977\n", + " -0.341307\n", " 0.999999\n", - " 0.999952\n", - " 0.892328\n", - " -0.047054\n", + " 0.999972\n", + " 0.940172\n", + " -0.015462\n", " \n", " \n", " tottrdqty\n", - " -0.148897\n", - " -0.149135\n", - " -0.150328\n", - " -0.150318\n", - " -0.150334\n", - " -0.148804\n", - " 1.000000\n", - " 0.887464\n", - " 0.872605\n", - " 0.081900\n", - " -0.148897\n", - " -0.148897\n", - " 0.246630\n", - " -0.148897\n", - " -0.150382\n", - " -0.061490\n", - " 0.049446\n", + " -0.148407\n", + " -0.148559\n", + " -0.149443\n", + " -0.149469\n", + " -0.149456\n", + " -0.148386\n", + " 1.000000\n", + " 0.882100\n", + " 0.862401\n", + " 0.077322\n", + " -0.148407\n", + " -0.148407\n", + " 0.259719\n", + " -0.148407\n", + " -0.149516\n", + " -0.088013\n", + " 0.014557\n", " \n", " \n", " tottrdval\n", - " -0.069653\n", - " -0.068445\n", - " -0.069683\n", - " -0.068979\n", - " -0.069011\n", - " -0.069727\n", - " 0.887464\n", - " 1.000000\n", - " 0.950677\n", - " 0.125807\n", - " -0.069653\n", - " -0.069653\n", - " -0.081951\n", - " -0.069653\n", - " -0.069022\n", - " -0.092186\n", - " -0.118504\n", + " -0.084277\n", + " -0.083319\n", + " -0.084238\n", + " -0.083687\n", + " -0.083690\n", + " -0.084348\n", + " 0.882100\n", + " 1.000000\n", + " 0.942020\n", + " 0.103981\n", + " -0.084277\n", + " -0.084277\n", + " -0.081493\n", + " -0.084277\n", + " -0.083722\n", + " -0.104828\n", + " -0.094205\n", " \n", " \n", " totaltrades\n", - " -0.150378\n", - " -0.149667\n", - " -0.150962\n", - " -0.150405\n", - " -0.150401\n", - " -0.150461\n", - " 0.872605\n", - " 0.950677\n", - " 1.000000\n", - " 0.172677\n", - " -0.150378\n", - " -0.150378\n", - " 0.019020\n", - " -0.150378\n", - " -0.150473\n", - " -0.129302\n", - " -0.126903\n", + " -0.174985\n", + " -0.174466\n", + " -0.175400\n", + " -0.175015\n", + " -0.174994\n", + " -0.175093\n", + " 0.862401\n", + " 0.942020\n", + " 1.000000\n", + " 0.121045\n", + " -0.174985\n", + " -0.174985\n", + " 0.021897\n", + " -0.174985\n", + " -0.175068\n", + " -0.160480\n", + " -0.102648\n", " \n", " \n", " ret\n", - " 0.174624\n", - " 0.174166\n", - " 0.173019\n", - " 0.173123\n", - " 0.173261\n", - " 0.174287\n", - " 0.081900\n", - " 0.125807\n", - " 0.172677\n", - " 1.000000\n", - " 0.174624\n", - " 0.174624\n", - " -0.017758\n", - " 0.174624\n", - " 0.173257\n", - " 0.221006\n", - " 0.051175\n", + " 0.106600\n", + " 0.106431\n", + " 0.105659\n", + " 0.105847\n", + " 0.105973\n", + " 0.106624\n", + " 0.077322\n", + " 0.103981\n", + " 0.121045\n", + " 1.000000\n", + " 0.106600\n", + " 0.106600\n", + " -0.021232\n", + " 0.106600\n", + " 0.105952\n", + " 0.130110\n", + " -0.037809\n", " \n", " \n", " price\n", " 1.000000\n", - " 0.999981\n", + " 0.999989\n", + " 0.999985\n", " 0.999974\n", - " 0.999957\n", - " 0.999960\n", + " 0.999976\n", " 0.999999\n", - " -0.148897\n", - " -0.069653\n", - " -0.150378\n", - " 0.174624\n", + " -0.148407\n", + " -0.084277\n", + " -0.174985\n", + " 0.106600\n", " 1.000000\n", " 1.000000\n", - " -0.351303\n", + " -0.341461\n", " 1.000000\n", - " 0.999955\n", - " 0.892213\n", - " -0.047230\n", + " 0.999973\n", + " 0.940206\n", + " -0.015494\n", " \n", " \n", " stop_loss\n", " 1.000000\n", - " 0.999981\n", + " 0.999989\n", + " 0.999985\n", " 0.999974\n", - " 0.999957\n", - " 0.999960\n", + " 0.999976\n", " 0.999999\n", - " -0.148897\n", - " -0.069653\n", - " -0.150378\n", - " 0.174624\n", + " -0.148407\n", + " -0.084277\n", + " -0.174985\n", + " 0.106600\n", " 1.000000\n", " 1.000000\n", - " -0.351303\n", + " -0.341461\n", " 1.000000\n", - " 0.999955\n", - " 0.892213\n", - " -0.047230\n", + " 0.999973\n", + " 0.940206\n", + " -0.015494\n", " \n", " \n", " qty\n", - " -0.351303\n", - " -0.353789\n", - " -0.354394\n", - " -0.355375\n", - " -0.355334\n", - " -0.350977\n", - " 0.246630\n", - " -0.081951\n", - " 0.019020\n", - " -0.017758\n", - " -0.351303\n", - " -0.351303\n", - " 1.000000\n", - " -0.351303\n", - " -0.355410\n", - " -0.116143\n", - " 0.184835\n", + " -0.341461\n", + " -0.343225\n", + " -0.343661\n", + " -0.344469\n", + " -0.344395\n", + " -0.341307\n", + " 0.259719\n", + " -0.081493\n", + " 0.021897\n", + " -0.021232\n", + " -0.341461\n", + " -0.341461\n", + " 1.000000\n", + " -0.341461\n", + " -0.344490\n", + " -0.180435\n", + " 0.050347\n", " \n", " \n", " sell\n", " 1.000000\n", - " 0.999981\n", + " 0.999989\n", + " 0.999985\n", " 0.999974\n", - " 0.999957\n", - " 0.999960\n", + " 0.999976\n", " 0.999999\n", - " -0.148897\n", - " -0.069653\n", - " -0.150378\n", - " 0.174624\n", + " -0.148407\n", + " -0.084277\n", + " -0.174985\n", + " 0.106600\n", " 1.000000\n", " 1.000000\n", - " -0.351303\n", + " -0.341461\n", " 1.000000\n", - " 0.999955\n", - " 0.892213\n", - " -0.047230\n", + " 0.999973\n", + " 0.940206\n", + " -0.015494\n", " \n", " \n", " buy\n", - " 0.999955\n", - " 0.999989\n", - " 0.999989\n", + " 0.999973\n", + " 0.999993\n", + " 0.999993\n", " 1.000000\n", - " 0.999999\n", - " 0.999952\n", - " -0.150382\n", - " -0.069022\n", - " -0.150473\n", - " 0.173257\n", - " 0.999955\n", - " 0.999955\n", - " -0.355410\n", - " 0.999955\n", - " 1.000000\n", - " 0.887912\n", - " -0.052649\n", + " 1.000000\n", + " 0.999972\n", + " -0.149516\n", + " -0.083722\n", + " -0.175068\n", + " 0.105952\n", + " 0.999973\n", + " 0.999973\n", + " -0.344490\n", + " 0.999973\n", + " 1.000000\n", + " 0.937673\n", + " -0.019465\n", " \n", " \n", " profit_per_unit\n", - " 0.892213\n", - " 0.889674\n", - " 0.889338\n", - " 0.888022\n", - " 0.888153\n", - " 0.892328\n", - " -0.061490\n", - " -0.092186\n", - " -0.129302\n", - " 0.221006\n", - " 0.892213\n", - " 0.892213\n", - " -0.116143\n", - " 0.892213\n", - " 0.887912\n", - " 1.000000\n", - " 0.217331\n", + " 0.940206\n", + " 0.938756\n", + " 0.938542\n", + " 0.937734\n", + " 0.937823\n", + " 0.940172\n", + " -0.088013\n", + " -0.104828\n", + " -0.160480\n", + " 0.130110\n", + " 0.940206\n", + " 0.940206\n", + " -0.180435\n", + " 0.940206\n", + " 0.937673\n", + " 1.000000\n", + " 0.169257\n", " \n", " \n", " total_profit\n", - " -0.047230\n", - " -0.050773\n", - " -0.049820\n", - " -0.052584\n", - " -0.052516\n", - " -0.047054\n", - " 0.049446\n", - " -0.118504\n", - " -0.126903\n", - " 0.051175\n", - " -0.047230\n", - " -0.047230\n", - " 0.184835\n", - " -0.047230\n", - " -0.052649\n", - " 0.217331\n", + " -0.015494\n", + " -0.017994\n", + " -0.017418\n", + " -0.019398\n", + " -0.019328\n", + " -0.015462\n", + " 0.014557\n", + " -0.094205\n", + " -0.102648\n", + " -0.037809\n", + " -0.015494\n", + " -0.015494\n", + " 0.050347\n", + " -0.015494\n", + " -0.019465\n", + " 0.169257\n", " 1.000000\n", " \n", " \n", @@ -789,83 +799,83 @@ ], "text/plain": [ " open high low close last prevclose \\\n", - "open 1.000000 0.999981 0.999974 0.999957 0.999960 0.999999 \n", - "high 0.999981 1.000000 0.999985 0.999990 0.999991 0.999978 \n", - "low 0.999974 0.999985 1.000000 0.999990 0.999990 0.999973 \n", - "close 0.999957 0.999990 0.999990 1.000000 1.000000 0.999954 \n", - "last 0.999960 0.999991 0.999990 1.000000 1.000000 0.999956 \n", - "prevclose 0.999999 0.999978 0.999973 0.999954 0.999956 1.000000 \n", - "tottrdqty -0.148897 -0.149135 -0.150328 -0.150318 -0.150334 -0.148804 \n", - "tottrdval -0.069653 -0.068445 -0.069683 -0.068979 -0.069011 -0.069727 \n", - "totaltrades -0.150378 -0.149667 -0.150962 -0.150405 -0.150401 -0.150461 \n", - "ret 0.174624 0.174166 0.173019 0.173123 0.173261 0.174287 \n", - "price 1.000000 0.999981 0.999974 0.999957 0.999960 0.999999 \n", - "stop_loss 1.000000 0.999981 0.999974 0.999957 0.999960 0.999999 \n", - "qty -0.351303 -0.353789 -0.354394 -0.355375 -0.355334 -0.350977 \n", - "sell 1.000000 0.999981 0.999974 0.999957 0.999960 0.999999 \n", - "buy 0.999955 0.999989 0.999989 1.000000 0.999999 0.999952 \n", - "profit_per_unit 0.892213 0.889674 0.889338 0.888022 0.888153 0.892328 \n", - "total_profit -0.047230 -0.050773 -0.049820 -0.052584 -0.052516 -0.047054 \n", + "open 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", + "high 0.999989 1.000000 0.999991 0.999993 0.999994 0.999987 \n", + "low 0.999985 0.999991 1.000000 0.999994 0.999994 0.999984 \n", + "close 0.999974 0.999993 0.999994 1.000000 1.000000 0.999973 \n", + "last 0.999976 0.999994 0.999994 1.000000 1.000000 0.999975 \n", + "prevclose 0.999999 0.999987 0.999984 0.999973 0.999975 1.000000 \n", + "tottrdqty -0.148407 -0.148559 -0.149443 -0.149469 -0.149456 -0.148386 \n", + "tottrdval -0.084277 -0.083319 -0.084238 -0.083687 -0.083690 -0.084348 \n", + "totaltrades -0.174985 -0.174466 -0.175400 -0.175015 -0.174994 -0.175093 \n", + "ret 0.106600 0.106431 0.105659 0.105847 0.105973 0.106624 \n", + "price 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", + "stop_loss 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", + "qty -0.341461 -0.343225 -0.343661 -0.344469 -0.344395 -0.341307 \n", + "sell 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", + "buy 0.999973 0.999993 0.999993 1.000000 1.000000 0.999972 \n", + "profit_per_unit 0.940206 0.938756 0.938542 0.937734 0.937823 0.940172 \n", + "total_profit -0.015494 -0.017994 -0.017418 -0.019398 -0.019328 -0.015462 \n", "\n", " tottrdqty tottrdval totaltrades ret price \\\n", - "open -0.148897 -0.069653 -0.150378 0.174624 1.000000 \n", - "high -0.149135 -0.068445 -0.149667 0.174166 0.999981 \n", - "low -0.150328 -0.069683 -0.150962 0.173019 0.999974 \n", - "close -0.150318 -0.068979 -0.150405 0.173123 0.999957 \n", - "last -0.150334 -0.069011 -0.150401 0.173261 0.999960 \n", - "prevclose -0.148804 -0.069727 -0.150461 0.174287 0.999999 \n", - "tottrdqty 1.000000 0.887464 0.872605 0.081900 -0.148897 \n", - "tottrdval 0.887464 1.000000 0.950677 0.125807 -0.069653 \n", - "totaltrades 0.872605 0.950677 1.000000 0.172677 -0.150378 \n", - "ret 0.081900 0.125807 0.172677 1.000000 0.174624 \n", - "price -0.148897 -0.069653 -0.150378 0.174624 1.000000 \n", - "stop_loss -0.148897 -0.069653 -0.150378 0.174624 1.000000 \n", - "qty 0.246630 -0.081951 0.019020 -0.017758 -0.351303 \n", - "sell -0.148897 -0.069653 -0.150378 0.174624 1.000000 \n", - "buy -0.150382 -0.069022 -0.150473 0.173257 0.999955 \n", - "profit_per_unit -0.061490 -0.092186 -0.129302 0.221006 0.892213 \n", - "total_profit 0.049446 -0.118504 -0.126903 0.051175 -0.047230 \n", + "open -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", + "high -0.148559 -0.083319 -0.174466 0.106431 0.999989 \n", + "low -0.149443 -0.084238 -0.175400 0.105659 0.999985 \n", + "close -0.149469 -0.083687 -0.175015 0.105847 0.999974 \n", + "last -0.149456 -0.083690 -0.174994 0.105973 0.999976 \n", + "prevclose -0.148386 -0.084348 -0.175093 0.106624 0.999999 \n", + "tottrdqty 1.000000 0.882100 0.862401 0.077322 -0.148407 \n", + "tottrdval 0.882100 1.000000 0.942020 0.103981 -0.084277 \n", + "totaltrades 0.862401 0.942020 1.000000 0.121045 -0.174985 \n", + "ret 0.077322 0.103981 0.121045 1.000000 0.106600 \n", + "price -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", + "stop_loss -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", + "qty 0.259719 -0.081493 0.021897 -0.021232 -0.341461 \n", + "sell -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", + "buy -0.149516 -0.083722 -0.175068 0.105952 0.999973 \n", + "profit_per_unit -0.088013 -0.104828 -0.160480 0.130110 0.940206 \n", + "total_profit 0.014557 -0.094205 -0.102648 -0.037809 -0.015494 \n", "\n", " stop_loss qty sell buy profit_per_unit \\\n", - "open 1.000000 -0.351303 1.000000 0.999955 0.892213 \n", - "high 0.999981 -0.353789 0.999981 0.999989 0.889674 \n", - "low 0.999974 -0.354394 0.999974 0.999989 0.889338 \n", - "close 0.999957 -0.355375 0.999957 1.000000 0.888022 \n", - "last 0.999960 -0.355334 0.999960 0.999999 0.888153 \n", - "prevclose 0.999999 -0.350977 0.999999 0.999952 0.892328 \n", - "tottrdqty -0.148897 0.246630 -0.148897 -0.150382 -0.061490 \n", - "tottrdval -0.069653 -0.081951 -0.069653 -0.069022 -0.092186 \n", - "totaltrades -0.150378 0.019020 -0.150378 -0.150473 -0.129302 \n", - "ret 0.174624 -0.017758 0.174624 0.173257 0.221006 \n", - "price 1.000000 -0.351303 1.000000 0.999955 0.892213 \n", - "stop_loss 1.000000 -0.351303 1.000000 0.999955 0.892213 \n", - "qty -0.351303 1.000000 -0.351303 -0.355410 -0.116143 \n", - "sell 1.000000 -0.351303 1.000000 0.999955 0.892213 \n", - "buy 0.999955 -0.355410 0.999955 1.000000 0.887912 \n", - "profit_per_unit 0.892213 -0.116143 0.892213 0.887912 1.000000 \n", - "total_profit -0.047230 0.184835 -0.047230 -0.052649 0.217331 \n", + "open 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", + "high 0.999989 -0.343225 0.999989 0.999993 0.938756 \n", + "low 0.999985 -0.343661 0.999985 0.999993 0.938542 \n", + "close 0.999974 -0.344469 0.999974 1.000000 0.937734 \n", + "last 0.999976 -0.344395 0.999976 1.000000 0.937823 \n", + "prevclose 0.999999 -0.341307 0.999999 0.999972 0.940172 \n", + "tottrdqty -0.148407 0.259719 -0.148407 -0.149516 -0.088013 \n", + "tottrdval -0.084277 -0.081493 -0.084277 -0.083722 -0.104828 \n", + "totaltrades -0.174985 0.021897 -0.174985 -0.175068 -0.160480 \n", + "ret 0.106600 -0.021232 0.106600 0.105952 0.130110 \n", + "price 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", + "stop_loss 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", + "qty -0.341461 1.000000 -0.341461 -0.344490 -0.180435 \n", + "sell 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", + "buy 0.999973 -0.344490 0.999973 1.000000 0.937673 \n", + "profit_per_unit 0.940206 -0.180435 0.940206 0.937673 1.000000 \n", + "total_profit -0.015494 0.050347 -0.015494 -0.019465 0.169257 \n", "\n", " total_profit \n", - "open -0.047230 \n", - "high -0.050773 \n", - "low -0.049820 \n", - "close -0.052584 \n", - "last -0.052516 \n", - "prevclose -0.047054 \n", - "tottrdqty 0.049446 \n", - "tottrdval -0.118504 \n", - "totaltrades -0.126903 \n", - "ret 0.051175 \n", - "price -0.047230 \n", - "stop_loss -0.047230 \n", - "qty 0.184835 \n", - "sell -0.047230 \n", - "buy -0.052649 \n", - "profit_per_unit 0.217331 \n", + "open -0.015494 \n", + "high -0.017994 \n", + "low -0.017418 \n", + "close -0.019398 \n", + "last -0.019328 \n", + "prevclose -0.015462 \n", + "tottrdqty 0.014557 \n", + "tottrdval -0.094205 \n", + "totaltrades -0.102648 \n", + "ret -0.037809 \n", + "price -0.015494 \n", + "stop_loss -0.015494 \n", + "qty 0.050347 \n", + "sell -0.015494 \n", + "buy -0.019465 \n", + "profit_per_unit 0.169257 \n", "total_profit 1.000000 " ] }, - "execution_count": 13, + "execution_count": 12, "metadata": {}, "output_type": "execute_result" } From fc38eee15baef7694af39893ebb12671aec620a7 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 2 Oct 2018 12:59:18 +0530 Subject: [PATCH 12/53] Commission included in backtest --- tradingsystem/Backtest.ipynb | 720 +++-------------------------------- tradingsystem/utils.py | 2 +- 2 files changed, 58 insertions(+), 664 deletions(-) diff --git a/tradingsystem/Backtest.ipynb b/tradingsystem/Backtest.ipynb index cd001fd..a80c17f 100644 --- a/tradingsystem/Backtest.ipynb +++ b/tradingsystem/Backtest.ipynb @@ -10,7 +10,7 @@ }, { "cell_type": "code", - "execution_count": 1, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -30,7 +30,7 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -43,7 +43,7 @@ "CAPITAL = 20000\n", "LEVERAGE = 1\n", "REF_PRICE = 'close'\n", - "COMMISSION = 0 # In percent" + "COMMISSION = 0.03 # In percent" ] }, { @@ -80,7 +80,7 @@ }, { "cell_type": "code", - "execution_count": 3, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -92,20 +92,9 @@ }, { "cell_type": "code", - "execution_count": 4, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "49510" - ] - }, - "execution_count": 4, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ "# Now read the entire table back\n", "df = pd.read_sql_table(TABLENAME, engine)\n", @@ -141,7 +130,7 @@ }, { "cell_type": "code", - "execution_count": 5, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -163,7 +152,7 @@ }, { "cell_type": "code", - "execution_count": 6, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -176,7 +165,7 @@ }, { "cell_type": "code", - "execution_count": 7, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -192,6 +181,8 @@ " zip(orders['stop_loss'], orders['high'], orders['low'], orders[REF_PRICE])]\n", "orders['profit_per_unit'] = orders['sell'] - orders['buy']\n", "orders['total_profit'] = orders['profit_per_unit'] * orders['qty']\n", + "orders['commission'] = orders.eval('qty*(price+stop_loss)')*COMMISSION*0.01\n", + "orders['net_profit'] = orders['total_profit'] - orders['commission']\n", "cols = ['timestamp', 'symbol', 'buy', 'sell', 'profit_per_unit', 'total_profit']\n" ] }, @@ -204,198 +195,38 @@ }, { "cell_type": "code", - "execution_count": 8, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
symbolopenhighlowcloseqtybuyselltotal_profit
1221IBULHSGFIN1222.001222.001187.501200.853.01200.851222.0063.45
1207BPCL353.05367.25348.10364.0011.0367.17353.05-155.32
1246VEDL235.45237.75232.15234.9017.0234.90235.459.35
1219HINDPETRO250.10260.45248.00258.3516.0260.10250.10-160.00
1245UPL734.90735.95722.00723.505.0723.50734.9057.00
\n", - "
" - ], - "text/plain": [ - " symbol open high low close qty buy sell \\\n", - "1221 IBULHSGFIN 1222.00 1222.00 1187.50 1200.85 3.0 1200.85 1222.00 \n", - "1207 BPCL 353.05 367.25 348.10 364.00 11.0 367.17 353.05 \n", - "1246 VEDL 235.45 237.75 232.15 234.90 17.0 234.90 235.45 \n", - "1219 HINDPETRO 250.10 260.45 248.00 258.35 16.0 260.10 250.10 \n", - "1245 UPL 734.90 735.95 722.00 723.50 5.0 723.50 734.90 \n", - "\n", - " total_profit \n", - "1221 63.45 \n", - "1207 -155.32 \n", - "1246 9.35 \n", - "1219 -160.00 \n", - "1245 57.00 " - ] - }, - "execution_count": 8, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ "orders.tail()[['symbol', 'open', 'high', 'low', 'close', \n", - " 'qty', 'buy', 'sell', 'total_profit']]" + " 'qty', 'buy', 'sell', 'total_profit', 'net_profit']]" ] }, { - "cell_type": "code", - "execution_count": 9, + "cell_type": "markdown", "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "'Returns for the period = 3.11%'" - ] - }, - "execution_count": 9, - "metadata": {}, - "output_type": "execute_result" - } - ], "source": [ - "total_profit = orders['total_profit'].sum()\n", - "'Returns for the period = {:.2f}%'.format((total_profit/CAPITAL)*100)" + "Profit calculated on total_profit.\n", + "You can change this to **net profit** to see the real results" ] }, { "cell_type": "code", - "execution_count": 14, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "timestamp\n", - "2018-08-13 372.90\n", - "2018-08-21 37.35\n", - "2018-08-23 90.00\n", - "2018-08-27 46.40\n", - "2018-08-30 67.15\n", - "2018-09-11 0.00\n", - "2018-09-12 37.50\n", - "2018-09-17 63.45\n", - "Name: total_profit, dtype: float64" - ] - }, - "execution_count": 14, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ - "filtered = orders[orders['open'] == orders['high']]\n", - "filtered.groupby('timestamp').total_profit.sum()" + "\n", + "total_profit = orders['total_profit'].sum()\n", + "'Returns for the period = {:.2f}%'.format((total_profit/CAPITAL)*100)" ] }, { "cell_type": "code", - "execution_count": 11, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], + "outputs": [], "source": [ "import seaborn as sns\n", "import matplotlib.pyplot as plt\n", @@ -409,480 +240,43 @@ }, { "cell_type": "code", - "execution_count": 12, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
openhighlowcloselastprevclosetottrdqtytottrdvaltotaltradesretpricestop_lossqtysellbuyprofit_per_unittotal_profit
open1.0000000.9999890.9999850.9999740.9999760.999999-0.148407-0.084277-0.1749850.1066001.0000001.000000-0.3414611.0000000.9999730.940206-0.015494
high0.9999891.0000000.9999910.9999930.9999940.999987-0.148559-0.083319-0.1744660.1064310.9999890.999989-0.3432250.9999890.9999930.938756-0.017994
low0.9999850.9999911.0000000.9999940.9999940.999984-0.149443-0.084238-0.1754000.1056590.9999850.999985-0.3436610.9999850.9999930.938542-0.017418
close0.9999740.9999930.9999941.0000001.0000000.999973-0.149469-0.083687-0.1750150.1058470.9999740.999974-0.3444690.9999741.0000000.937734-0.019398
last0.9999760.9999940.9999941.0000001.0000000.999975-0.149456-0.083690-0.1749940.1059730.9999760.999976-0.3443950.9999761.0000000.937823-0.019328
prevclose0.9999990.9999870.9999840.9999730.9999751.000000-0.148386-0.084348-0.1750930.1066240.9999990.999999-0.3413070.9999990.9999720.940172-0.015462
tottrdqty-0.148407-0.148559-0.149443-0.149469-0.149456-0.1483861.0000000.8821000.8624010.077322-0.148407-0.1484070.259719-0.148407-0.149516-0.0880130.014557
tottrdval-0.084277-0.083319-0.084238-0.083687-0.083690-0.0843480.8821001.0000000.9420200.103981-0.084277-0.084277-0.081493-0.084277-0.083722-0.104828-0.094205
totaltrades-0.174985-0.174466-0.175400-0.175015-0.174994-0.1750930.8624010.9420201.0000000.121045-0.174985-0.1749850.021897-0.174985-0.175068-0.160480-0.102648
ret0.1066000.1064310.1056590.1058470.1059730.1066240.0773220.1039810.1210451.0000000.1066000.106600-0.0212320.1066000.1059520.130110-0.037809
price1.0000000.9999890.9999850.9999740.9999760.999999-0.148407-0.084277-0.1749850.1066001.0000001.000000-0.3414611.0000000.9999730.940206-0.015494
stop_loss1.0000000.9999890.9999850.9999740.9999760.999999-0.148407-0.084277-0.1749850.1066001.0000001.000000-0.3414611.0000000.9999730.940206-0.015494
qty-0.341461-0.343225-0.343661-0.344469-0.344395-0.3413070.259719-0.0814930.021897-0.021232-0.341461-0.3414611.000000-0.341461-0.344490-0.1804350.050347
sell1.0000000.9999890.9999850.9999740.9999760.999999-0.148407-0.084277-0.1749850.1066001.0000001.000000-0.3414611.0000000.9999730.940206-0.015494
buy0.9999730.9999930.9999931.0000001.0000000.999972-0.149516-0.083722-0.1750680.1059520.9999730.999973-0.3444900.9999731.0000000.937673-0.019465
profit_per_unit0.9402060.9387560.9385420.9377340.9378230.940172-0.088013-0.104828-0.1604800.1301100.9402060.940206-0.1804350.9402060.9376731.0000000.169257
total_profit-0.015494-0.017994-0.017418-0.019398-0.019328-0.0154620.014557-0.094205-0.102648-0.037809-0.015494-0.0154940.050347-0.015494-0.0194650.1692571.000000
\n", - "
" - ], - "text/plain": [ - " open high low close last prevclose \\\n", - "open 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", - "high 0.999989 1.000000 0.999991 0.999993 0.999994 0.999987 \n", - "low 0.999985 0.999991 1.000000 0.999994 0.999994 0.999984 \n", - "close 0.999974 0.999993 0.999994 1.000000 1.000000 0.999973 \n", - "last 0.999976 0.999994 0.999994 1.000000 1.000000 0.999975 \n", - "prevclose 0.999999 0.999987 0.999984 0.999973 0.999975 1.000000 \n", - "tottrdqty -0.148407 -0.148559 -0.149443 -0.149469 -0.149456 -0.148386 \n", - "tottrdval -0.084277 -0.083319 -0.084238 -0.083687 -0.083690 -0.084348 \n", - "totaltrades -0.174985 -0.174466 -0.175400 -0.175015 -0.174994 -0.175093 \n", - "ret 0.106600 0.106431 0.105659 0.105847 0.105973 0.106624 \n", - "price 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", - "stop_loss 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", - "qty -0.341461 -0.343225 -0.343661 -0.344469 -0.344395 -0.341307 \n", - "sell 1.000000 0.999989 0.999985 0.999974 0.999976 0.999999 \n", - "buy 0.999973 0.999993 0.999993 1.000000 1.000000 0.999972 \n", - "profit_per_unit 0.940206 0.938756 0.938542 0.937734 0.937823 0.940172 \n", - "total_profit -0.015494 -0.017994 -0.017418 -0.019398 -0.019328 -0.015462 \n", - "\n", - " tottrdqty tottrdval totaltrades ret price \\\n", - "open -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", - "high -0.148559 -0.083319 -0.174466 0.106431 0.999989 \n", - "low -0.149443 -0.084238 -0.175400 0.105659 0.999985 \n", - "close -0.149469 -0.083687 -0.175015 0.105847 0.999974 \n", - "last -0.149456 -0.083690 -0.174994 0.105973 0.999976 \n", - "prevclose -0.148386 -0.084348 -0.175093 0.106624 0.999999 \n", - "tottrdqty 1.000000 0.882100 0.862401 0.077322 -0.148407 \n", - "tottrdval 0.882100 1.000000 0.942020 0.103981 -0.084277 \n", - "totaltrades 0.862401 0.942020 1.000000 0.121045 -0.174985 \n", - "ret 0.077322 0.103981 0.121045 1.000000 0.106600 \n", - "price -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", - "stop_loss -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", - "qty 0.259719 -0.081493 0.021897 -0.021232 -0.341461 \n", - "sell -0.148407 -0.084277 -0.174985 0.106600 1.000000 \n", - "buy -0.149516 -0.083722 -0.175068 0.105952 0.999973 \n", - "profit_per_unit -0.088013 -0.104828 -0.160480 0.130110 0.940206 \n", - "total_profit 0.014557 -0.094205 -0.102648 -0.037809 -0.015494 \n", - "\n", - " stop_loss qty sell buy profit_per_unit \\\n", - "open 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", - "high 0.999989 -0.343225 0.999989 0.999993 0.938756 \n", - "low 0.999985 -0.343661 0.999985 0.999993 0.938542 \n", - "close 0.999974 -0.344469 0.999974 1.000000 0.937734 \n", - "last 0.999976 -0.344395 0.999976 1.000000 0.937823 \n", - "prevclose 0.999999 -0.341307 0.999999 0.999972 0.940172 \n", - "tottrdqty -0.148407 0.259719 -0.148407 -0.149516 -0.088013 \n", - "tottrdval -0.084277 -0.081493 -0.084277 -0.083722 -0.104828 \n", - "totaltrades -0.174985 0.021897 -0.174985 -0.175068 -0.160480 \n", - "ret 0.106600 -0.021232 0.106600 0.105952 0.130110 \n", - "price 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", - "stop_loss 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", - "qty -0.341461 1.000000 -0.341461 -0.344490 -0.180435 \n", - "sell 1.000000 -0.341461 1.000000 0.999973 0.940206 \n", - "buy 0.999973 -0.344490 0.999973 1.000000 0.937673 \n", - "profit_per_unit 0.940206 -0.180435 0.940206 0.937673 1.000000 \n", - "total_profit -0.015494 0.050347 -0.015494 -0.019465 0.169257 \n", - "\n", - " total_profit \n", - "open -0.015494 \n", - "high -0.017994 \n", - "low -0.017418 \n", - "close -0.019398 \n", - "last -0.019328 \n", - "prevclose -0.015462 \n", - "tottrdqty 0.014557 \n", - "tottrdval -0.094205 \n", - "totaltrades -0.102648 \n", - "ret -0.037809 \n", - "price -0.015494 \n", - "stop_loss -0.015494 \n", - "qty 0.050347 \n", - "sell -0.015494 \n", - "buy -0.019465 \n", - "profit_per_unit 0.169257 \n", - "total_profit 1.000000 " - ] - }, - "execution_count": 12, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ + "# Correlation matrix\n", + "# This is useful to find related factors\n", "orders.corr()" ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# Profit by date\n", + "# Add any columns if you like in the cols list\n", + "cols = ['total_profit', 'net_profit']\n", + "orders.groupby('timestamp')[cols].sum().tail()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# Best and worst results\n", + "# Change n for the required number of days\n", + "n = 5\n", + "\n", + "print('Best results')\n", + "print(orders.groupby('timestamp')['total_profit'].sum().sort_values().tail(n))\n", + "\n", + "print('Worst results')\n", + "print(orders.groupby('timestamp')['total_profit'].sum().sort_values().head(n))" + ] } ], "metadata": { diff --git a/tradingsystem/utils.py b/tradingsystem/utils.py index 9a7465d..b3354af 100644 --- a/tradingsystem/utils.py +++ b/tradingsystem/utils.py @@ -59,7 +59,7 @@ def fetch_preopen_data(url=None): """ import requests if url is None: - url = "https://www1.nseindia.com/live_market/dynaContent/live_analysis/pre_open/nifty.json" + url = "https://www1.nseindia.com/live_market/dynaContent/live_analysis/pre_open/all.json" req = requests.get(url) dct = req.json() agg = [] From 6ee104931eb7c4c19264c55e796d118ed15f1fb4 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 2 Oct 2018 14:04:40 +0530 Subject: [PATCH 13/53] Pyfolio added --- tradingsystem/Backtest.ipynb | 50 ++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/tradingsystem/Backtest.ipynb b/tradingsystem/Backtest.ipynb index a80c17f..5365582 100644 --- a/tradingsystem/Backtest.ipynb +++ b/tradingsystem/Backtest.ipynb @@ -230,6 +230,7 @@ "source": [ "import seaborn as sns\n", "import matplotlib.pyplot as plt\n", + "from matplotlib.dates import date2num\n", "sns.set()\n", "by_day = orders.groupby('timestamp').total_profit.sum()\n", "(by_day.cumsum() + CAPITAL).plot(title = 'Portfolio by day')\n", @@ -277,6 +278,55 @@ "print('Worst results')\n", "print(orders.groupby('timestamp')['total_profit'].sum().sort_values().head(n))" ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Pyfolio results\n", + "\n", + "Your backtest period must contain 2 years (dec 2017 - jan 2018 is also fine) for pyfolio to work properly.\n", + "\n", + "I haven't figured out the exact error so far and correcting it requires way too many hacks. So its better to stick with it for now" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# Use this hack if pyfolio doesn't import for you\n", + "\n", + "import pandas\n", + "pandas.core.common.is_list_like = pd.api.types.is_list_like\n", + "import pyfolio as pf\n", + "pf.plotting.plot_rolling_fama_french = pf.plot_returns" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Change to **net_profit** to get actual results." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "returns = (orders.groupby('timestamp')['total_profit'].sum())/CAPITAL\n", + "returns.index = returns.index.tz_localize('UTC')\n", + "\n", + "# Replace this with NIFTY\n", + "import numpy as np\n", + "bench = pd.Series(np.random.randn(len(returns))*0.01,\n", + " index=returns.index)\n", + "pf.create_interesting_times_tear_sheet(returns, benchmark_rets=bench)\n", + "pf.create_returns_tear_sheet(returns, benchmark_rets=bench)" + ] } ], "metadata": { From 217dee747a507f522d542ff9baa85456a6a6bf48 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 5 Oct 2018 09:33:06 +0530 Subject: [PATCH 14/53] New universe added --- tradingsystem/universe.xlsx | Bin 11111 -> 14842 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/tradingsystem/universe.xlsx b/tradingsystem/universe.xlsx index 477c8626f7364913d4f60ff4649a7c6a7a117fb3..f86c5c1b16e06987f947e1a59042e673a796703d 100644 GIT binary patch delta 9842 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 From ebc3c5c6496ef37ec50e09a03e5e1f3b7b5ab46f Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 5 Oct 2018 11:54:52 +0530 Subject: [PATCH 15/53] HTML template for zerodha added --- tradingsystem/template.html | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 tradingsystem/template.html diff --git a/tradingsystem/template.html b/tradingsystem/template.html new file mode 100644 index 0000000..41af057 --- /dev/null +++ b/tradingsystem/template.html @@ -0,0 +1,37 @@ + + + + + Order Execution Zerodha + + + + + + +
+
+
+
+
+ Click Submit to place orders + + + + + +
+
+
+
+
+ Last updated at {{date}} +
+
+ + + + + \ No newline at end of file From aa0ce135ec10eedc9ae51026240b5303c3eccc6a Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 5 Oct 2018 11:59:14 +0530 Subject: [PATCH 16/53] Notebook updated with zerodha order --- tradingsystem/SystemNew.ipynb | 102 +++++++++++++++++++++++++++++++ tradingsystem/zerodha_order.html | 37 +++++++++++ 2 files changed, 139 insertions(+) create mode 100644 tradingsystem/zerodha_order.html diff --git a/tradingsystem/SystemNew.ipynb b/tradingsystem/SystemNew.ipynb index dd2282d..e9c8154 100644 --- a/tradingsystem/SystemNew.ipynb +++ b/tradingsystem/SystemNew.ipynb @@ -285,6 +285,108 @@ "# If you want header change header to True\n", "# If you want to export as excel use the to_excel function" ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Order generation for Kite Zerodha\n", + "\n", + "1. Sign up for a zerodha publisher api key [here](https://kite.trade/)\n", + "2. Update the API key in the below cell\n", + "3. Run the below cells. It would create an html file **zerodha_order.html** in your present working directory.\n", + "4. Open the HTML file and click the submit button to log into zerodha and place your orders.\n", + "\n", + "See the updated at time to make sure that this is the latest generated order." + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [], + "source": [ + "APIKEY = 'xxxxxxxxxxxxxxxx'" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [], + "source": [ + "# List of columns to be included in the output\n", + "\n", + "cols = [\n", + " 'tradingsymbol', 'exchange', 'transaction_type', 'order_type',\n", + " 'quantity', 'product', 'validity', 'price', 'trigger_price'\n", + "]\n", + "\n", + "# These columns are common for all orders - columns with a single name\n", + "columns = {\n", + " 'exchange': 'NSE',\n", + " 'product': 'MIS',\n", + " 'validity': 'DAY',\n", + " 'order_type': 'SL'\n", + "}\n", + "\n", + "# These are columns to be renamed\n", + "rename = {\n", + " 'order': 'transaction_type',\n", + " 'price': 'Price',\n", + " 'qty': 'quantity',\n", + " 'trigger_price': 'trigger_price',\n", + " 'price': 'price' ,\n", + " 'SYMBOL': 'tradingsymbol'\n", + "}" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [], + "source": [ + "# Generating orders in the required format\n", + "entry_orders = orders.copy()\n", + "entry = create_orders(entry_orders, rename=rename, **columns)\n", + "\n", + "# Exit orders order type and price to be changed\n", + "exit_orders = orders.copy()\n", + "exit_orders['order'] = 'BUY'\n", + "exit_orders['price'] = 0\n", + "exit_orders['trigger_price'] = stop_loss(orders['price'], 3, order='S').round(2)\n", + "columns.update({'order_type': 'SL-M'})\n", + "exit = create_orders(exit_orders, rename=rename, **columns)\n", + "trades = entry.append(exit, sort=False)[cols].to_dict(orient='records')" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Zerodha order file generated\n" + ] + } + ], + "source": [ + "import json\n", + "from jinja2 import Environment, FileSystemLoader\n", + "env = Environment(loader=FileSystemLoader('.'))\n", + "template = env.get_template('template.html')\n", + "output_from_parsed_template = template.render(api_key = APIKEY,\n", + " orders=json.dumps(trades), \n", + " date=str(datetime.datetime.now()))\n", + "\n", + "with open('zerodha_order.html', 'w') as f:\n", + " f.write(output_from_parsed_template)\n", + " print('Zerodha order file generated')" + ] } ], "metadata": { diff --git a/tradingsystem/zerodha_order.html b/tradingsystem/zerodha_order.html new file mode 100644 index 0000000..be69027 --- /dev/null +++ b/tradingsystem/zerodha_order.html @@ -0,0 +1,37 @@ + + + + + Order Execution Zerodha + + + + + + +
+
+
+
+
+ Click Submit to place orders + + + + + +
+
+
+
+
+ Last updated at 2018-10-05 11:53:47.524766 +
+
+ + + + + \ No newline at end of file From a2a9f3eb3fdc4a8031838144efdf989d9a5cb0d8 Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 24 Oct 2018 20:38:11 +0530 Subject: [PATCH 17/53] Diversification among sectors added --- tradingsystem/SystemNew.ipynb | 77 ++++- tradingsystem/orders_to_place.csv | 20 +- tradingsystem/sectors.csv | 502 ++++++++++++++++++++++++++++++ tradingsystem/zerodha_order.html | 4 +- 4 files changed, 575 insertions(+), 28 deletions(-) create mode 100644 tradingsystem/sectors.csv diff --git a/tradingsystem/SystemNew.ipynb b/tradingsystem/SystemNew.ipynb index e9c8154..393d5c4 100644 --- a/tradingsystem/SystemNew.ipynb +++ b/tradingsystem/SystemNew.ipynb @@ -6,7 +6,8 @@ "source": [ "## This is the updated system\n", "1. Fetch data from NSE\n", - "2. Automatically generate prices and stop loss" + "2. Automatically generate prices and stop loss\n", + "3. Option to diversify stocks" ] }, { @@ -18,7 +19,8 @@ "2. You need to change only the PARAMETERS, nothing else\n", "3. Store all your data in data folder\n", "4. All the orders you generate go into the orders folder\n", - "5. Orders for the present day are created with the filename **orders_to_place.csv** and stored in the current directory" + "5. Orders for the present day are created with the filename **orders_to_place.csv** and stored in the current directory\n", + "6. If you need to diversify among sectors, set the **DIVERSIFY** parameter to **True**" ] }, { @@ -46,12 +48,13 @@ "outputs": [], "source": [ "UNIVERSE = 'NIFTY50' # Universe to be searched\n", - "ORDER_FILENAME = 'data/cm17SEP2018bhav.csv.zip'\n", + "ORDER_FILENAME = 'data/cm23OCT2018bhav.csv.zip'\n", "STOP_LOSS = 3 # Stop loss for the order\n", "NUM_STOCKS = 5 # Number of stocks to sell\n", "CAPITAL = 20000\n", "LEVERAGE = 1\n", - "ORDERFILE_PREFIX = 'orders_' # Prefix file name to store" + "ORDERFILE_PREFIX = 'orders_' # Prefix file name to store\n", + "DIVERSIFY = False # whether to diversify data among sectors" ] }, { @@ -73,6 +76,13 @@ "### Don't change the below cell" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Preparing the dataframe" + ] + }, { "cell_type": "code", "execution_count": 5, @@ -82,8 +92,10 @@ "eod = pd.read_csv(ORDER_FILENAME, parse_dates=['TIMESTAMP'],\n", " usecols=range(13))\n", "symbols = pd.read_excel('universe.xlsx', sheet_name=UNIVERSE, header=None).values.ravel()\n", + "sectors = pd.read_csv('sectors.csv')\n", "df = eod[eod['SYMBOL'].isin(symbols)]\n", - "df = df[df['SERIES'] == \"EQ\"].reset_index(drop=True)" + "df = df[df['SERIES'] == \"EQ\"].reset_index(drop=True)\n", + "df = df.merge(sectors)" ] }, { @@ -102,8 +114,28 @@ "metadata": {}, "outputs": [], "source": [ - "df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1\n", - "result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS]" + "# Don't change this function\n", + "def diversify(frame, n=5):\n", + " \"\"\"\n", + " Diversify stocks among sectors\n", + " frame\n", + " dataframe\n", + " n\n", + " number of stocks\n", + " \"\"\"\n", + " industry = set()\n", + " stocks = []\n", + " for k,v in frame.iterrows():\n", + " if v.at['Industry'] not in industry:\n", + " industry.add(v.at['Industry'])\n", + " stocks.append(v)\n", + " if len(stocks) == n:\n", + " break\n", + " f = pd.DataFrame(stocks)\n", + " if len(f) == 0:\n", + " return pd.DataFrame()\n", + " else:\n", + " return f " ] }, { @@ -111,6 +143,19 @@ "execution_count": 7, "metadata": {}, "outputs": [], + "source": [ + "df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1\n", + "if DIVERSIFY:\n", + " result = diversify(df.sort_values(by='RET', ascending=False), NUM_STOCKS)\n", + "else:\n", + " result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS]" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [], "source": [ "trading_capital = CAPITAL * LEVERAGE\n", "orders = result.merge(preopen, on='SYMBOL')\n", @@ -126,7 +171,7 @@ }, { "cell_type": "code", - "execution_count": 8, + "execution_count": 9, "metadata": {}, "outputs": [], "source": [ @@ -149,7 +194,7 @@ }, { "cell_type": "code", - "execution_count": 9, + "execution_count": 10, "metadata": {}, "outputs": [], "source": [ @@ -195,7 +240,7 @@ }, { "cell_type": "code", - "execution_count": 10, + "execution_count": 11, "metadata": {}, "outputs": [], "source": [ @@ -204,7 +249,7 @@ }, { "cell_type": "code", - "execution_count": 11, + "execution_count": 12, "metadata": {}, "outputs": [], "source": [ @@ -252,7 +297,7 @@ }, { "cell_type": "code", - "execution_count": 12, + "execution_count": 13, "metadata": {}, "outputs": [ { @@ -302,7 +347,7 @@ }, { "cell_type": "code", - "execution_count": 13, + "execution_count": 14, "metadata": {}, "outputs": [], "source": [ @@ -311,7 +356,7 @@ }, { "cell_type": "code", - "execution_count": 14, + "execution_count": 15, "metadata": {}, "outputs": [], "source": [ @@ -343,7 +388,7 @@ }, { "cell_type": "code", - "execution_count": 15, + "execution_count": 16, "metadata": {}, "outputs": [], "source": [ @@ -363,7 +408,7 @@ }, { "cell_type": "code", - "execution_count": 16, + "execution_count": 17, "metadata": {}, "outputs": [ { diff --git a/tradingsystem/orders_to_place.csv b/tradingsystem/orders_to_place.csv index dfca55c..4bd8f20 100644 --- a/tradingsystem/orders_to_place.csv +++ b/tradingsystem/orders_to_place.csv @@ -1,10 +1,10 @@ -NSE,EQ,BPCL,NA,NA,NA,364.9,10,0,SELL,SL,364.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,HINDPETRO,NA,NA,NA,258.4,15,0,SELL,SL,258.45,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,EICHERMOT,NA,NA,NA,29600.9,0,0,SELL,SL,29600.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,TECHM,NA,NA,NA,769.75,5,0,SELL,SL,769.8,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,POWERGRID,NA,NA,NA,201.4,19,0,SELL,SL,201.45,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,BPCL,NA,NA,NA,0.0,10,0,BUY,SL-M,375.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,HINDPETRO,NA,NA,NA,0.0,15,0,BUY,SL-M,266.15,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,EICHERMOT,NA,NA,NA,0.0,0,0,BUY,SL-M,30488.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,TECHM,NA,NA,NA,0.0,5,0,BUY,SL-M,792.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA -NSE,EQ,POWERGRID,NA,NA,NA,0.0,19,0,BUY,SL-M,207.45,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HINDPETRO,NA,NA,NA,226.8,17,0,SELL,SL,226.85,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,IBULHSGFIN,NA,NA,NA,752.6,5,0,SELL,SL,752.65,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HDFC,NA,NA,NA,1714.9,2,0,SELL,SL,1714.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,INDUSINDBK,NA,NA,NA,1489.9,2,0,SELL,SL,1489.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,BAJAJ-AUTO,NA,NA,NA,2614.9,1,0,SELL,SL,2614.95,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HINDPETRO,NA,NA,NA,0.0,17,0,BUY,SL-M,233.6,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,IBULHSGFIN,NA,NA,NA,0.0,5,0,BUY,SL-M,775.2,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,HDFC,NA,NA,NA,0.0,2,0,BUY,SL-M,1766.35,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,INDUSINDBK,NA,NA,NA,0.0,2,0,BUY,SL-M,1534.6,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA +NSE,EQ,BAJAJ-AUTO,NA,NA,NA,0.0,1,0,BUY,SL-M,2693.35,CLI,MIS,DAY,XXXXXX,NA,,,NA,NA diff --git a/tradingsystem/sectors.csv b/tradingsystem/sectors.csv new file mode 100644 index 0000000..9222d86 --- /dev/null +++ b/tradingsystem/sectors.csv @@ -0,0 +1,502 @@ +SYMBOL,Industry +3MINDIA,SERVICES +8KMILES,IT +ABB,INDUSTRIAL MANUFACTURING +ACC,CEMENT & CEMENT PRODUCTS +AIAENG,INDUSTRIAL MANUFACTURING +APLAPOLLO,METALS +AUBANK,FINANCIAL SERVICES +AARTIIND,CHEMICALS +ADANIPORTS,SERVICES +ADANIPOWER,ENERGY +ADANITRANS,ENERGY +ABCAPITAL,FINANCIAL SERVICES +ABFRL,CONSUMER GOODS +ADVENZYMES,CONSUMER GOODS +AEGISCHEM,ENERGY +AJANTPHARM,PHARMA +AKZOINDIA,CONSUMER GOODS +APLLTD,PHARMA +ALKEM,PHARMA +ALBK,FINANCIAL SERVICES +ALLCARGO,SERVICES +AMARAJABAT,AUTOMOBILE +AMBUJACEM,CEMENT & CEMENT PRODUCTS +ANDHRABANK,FINANCIAL SERVICES +APOLLOHOSP,HEALTHCARE SERVICES +APOLLOTYRE,AUTOMOBILE +ASHOKLEY,AUTOMOBILE +ASHOKA,CONSTRUCTION +ASIANPAINT,CONSUMER GOODS +ASTERDM,HEALTHCARE SERVICES +ASTRAL,INDUSTRIAL MANUFACTURING +ATUL,CHEMICALS +AUROPHARMA,PHARMA +AVANTIFEED,CONSUMER GOODS +DMART,CONSUMER GOODS +AXISBANK,FINANCIAL SERVICES +BASF,CHEMICALS +BEML,INDUSTRIAL MANUFACTURING +BSE,FINANCIAL SERVICES +BAJAJ-AUTO,AUTOMOBILE +BAJAJCORP,CONSUMER GOODS +BAJAJELEC,CONSUMER GOODS +BAJFINANCE,FINANCIAL SERVICES +BAJAJFINSV,FINANCIAL SERVICES +BAJAJHLDNG,FINANCIAL SERVICES +BALKRISIND,AUTOMOBILE +BALMLAWRIE,SERVICES +BALRAMCHIN,CONSUMER GOODS +BANDHANBNK,FINANCIAL SERVICES +BANKBARODA,FINANCIAL SERVICES +BANKINDIA,FINANCIAL SERVICES +BATAINDIA,CONSUMER GOODS +BERGEPAINT,CONSUMER GOODS +BDL,INDUSTRIAL MANUFACTURING +BEL,INDUSTRIAL MANUFACTURING +BHARATFIN,FINANCIAL SERVICES +BHARATFORG,INDUSTRIAL MANUFACTURING +BHEL,INDUSTRIAL MANUFACTURING +BPCL,ENERGY +BHARTIARTL,TELECOM +INFRATEL,TELECOM +BIOCON,PHARMA +BIRLACORPN,CEMENT & CEMENT PRODUCTS +BLISSGVS,PHARMA +BLUEDART,SERVICES +BLUESTARCO,CONSUMER GOODS +BBTC,CONSUMER GOODS +BOMDYEING,TEXTILES +BOSCHLTD,AUTOMOBILE +BRIGADE,CONSTRUCTION +BRITANNIA,CONSUMER GOODS +CARERATING,FINANCIAL SERVICES +CCL,CONSUMER GOODS +CGPOWER,INDUSTRIAL MANUFACTURING +CRISIL,FINANCIAL SERVICES +CADILAHC,PHARMA +CANFINHOME,FINANCIAL SERVICES +CANBK,FINANCIAL SERVICES +CAPF,FINANCIAL SERVICES +CAPLIPOINT,PHARMA +CARBORUNIV,INDUSTRIAL MANUFACTURING +CASTROLIND,ENERGY +CEATLTD,AUTOMOBILE +CENTRALBK,FINANCIAL SERVICES +CDSL,FINANCIAL SERVICES +CENTURYPLY,CONSUMER GOODS +CENTURYTEX,CEMENT & CEMENT PRODUCTS +CERA,CONSTRUCTION +CHAMBLFERT,FERTILISERS & PESTICIDES +CHENNPETRO,ENERGY +CHOLAFIN,FINANCIAL SERVICES +CIPLA,PHARMA +CUB,FINANCIAL SERVICES +COALINDIA,METALS +COCHINSHIP,INDUSTRIAL MANUFACTURING +COFFEEDAY,CONSUMER GOODS +COLPAL,CONSUMER GOODS +CONCOR,SERVICES +COROMANDEL,FERTILISERS & PESTICIDES +CROMPTON,CONSUMER GOODS +CUMMINSIND,INDUSTRIAL MANUFACTURING +CYIENT,IT +DBCORP,MEDIA & ENTERTAINMENT +DCBBANK,FINANCIAL SERVICES +DCMSHRIRAM,CONSUMER GOODS +DLF,CONSTRUCTION +DABUR,CONSUMER GOODS +DEEPAKFERT,CHEMICALS +DELTACORP,SERVICES +DEN,MEDIA & ENTERTAINMENT +DENABANK,FINANCIAL SERVICES +DHFL,FINANCIAL SERVICES +DBL,CONSTRUCTION +DISHTV,MEDIA & ENTERTAINMENT +DCAL,PHARMA +DIVISLAB,PHARMA +DIXON,CONSUMER GOODS +LALPATHLAB,HEALTHCARE SERVICES +DRREDDY,PHARMA +DREDGECORP,SERVICES +EIDPARRY,FERTILISERS & PESTICIDES +EIHOTEL,SERVICES +EDELWEISS,FINANCIAL SERVICES +EICHERMOT,AUTOMOBILE +ELGIEQUIP,INDUSTRIAL MANUFACTURING +EMAMILTD,CONSUMER GOODS +ENDURANCE,AUTOMOBILE +ENGINERSIN,CONSTRUCTION +EQUITAS,FINANCIAL SERVICES +ERIS,PHARMA +EROSMEDIA,MEDIA & ENTERTAINMENT +ESCORTS,AUTOMOBILE +EVEREADY,CONSUMER GOODS +EXCELCROP,FERTILISERS & PESTICIDES +EXIDEIND,AUTOMOBILE +FDC,PHARMA +FEDERALBNK,FINANCIAL SERVICES +FINCABLES,INDUSTRIAL MANUFACTURING +FINPIPE,INDUSTRIAL MANUFACTURING +FSL,IT +FCONSUMER,CONSUMER GOODS +FLFL,CONSUMER GOODS +FRETAIL,CONSUMER GOODS +GAIL,ENERGY +GEPIL,INDUSTRIAL MANUFACTURING +GET&D,INDUSTRIAL MANUFACTURING +GHCL,CHEMICALS +GMRINFRA,CONSTRUCTION +GVKPIL,CONSTRUCTION +GALAXYSURF,CHEMICALS +GDL,SERVICES +GAYAPROJ,CONSTRUCTION +GICRE,FINANCIAL SERVICES +GILLETTE,CONSUMER GOODS +GSKCONS,CONSUMER GOODS +GLAXO,PHARMA +GLENMARK,PHARMA +GODFRYPHLP,CONSUMER GOODS +GODREJAGRO,CONSUMER GOODS +GODREJCP,CONSUMER GOODS +GODREJIND,CONSUMER GOODS +GODREJPROP,CONSTRUCTION +GRANULES,PHARMA +GRAPHITE,INDUSTRIAL MANUFACTURING +GRASIM,CEMENT & CEMENT PRODUCTS +GESHIP,SERVICES +GREAVESCOT,INDUSTRIAL MANUFACTURING +GREENPLY,CONSUMER GOODS +GRINDWELL,INDUSTRIAL MANUFACTURING +GRUH,FINANCIAL SERVICES +GUJALKALI,CHEMICALS +GUJFLUORO,INDUSTRIAL MANUFACTURING +GUJGASLTD,ENERGY +GMDCLTD,METALS +GNFC,CHEMICALS +GPPL,SERVICES +GSFC,FERTILISERS & PESTICIDES +GSPL,ENERGY +GULFOILLUB,ENERGY +HEG,INDUSTRIAL MANUFACTURING +HCL-INSYS,IT +HCLTECH,IT +HDFCBANK,FINANCIAL SERVICES +HDFCLIFE,FINANCIAL SERVICES +HSIL,CONSUMER GOODS +HATHWAY,MEDIA & ENTERTAINMENT +HATSUN,CONSUMER GOODS +HAVELLS,CONSUMER GOODS +HEIDELBERG,CEMENT & CEMENT PRODUCTS +HERITGFOOD,CONSUMER GOODS +HEROMOTOCO,AUTOMOBILE +HEXAWARE,IT +HFCL,TELECOM +HSCL,CHEMICALS +HIMATSEIDE,TEXTILES +HINDALCO,METALS +HAL,INDUSTRIAL MANUFACTURING +HCC,CONSTRUCTION +HINDCOPPER,METALS +HINDPETRO,ENERGY +HINDUNILVR,CONSUMER GOODS +HINDZINC,METALS +HONAUT,INDUSTRIAL MANUFACTURING +HUDCO,FINANCIAL SERVICES +HDFC,FINANCIAL SERVICES +ITC,CONSUMER GOODS +ICICIBANK,FINANCIAL SERVICES +ICICIGI,FINANCIAL SERVICES +ICICIPRULI,FINANCIAL SERVICES +ISEC,FINANCIAL SERVICES +IDBI,FINANCIAL SERVICES +IDFCBANK,FINANCIAL SERVICES +IDFC,FINANCIAL SERVICES +IFBIND,CONSUMER GOODS +IFCI,FINANCIAL SERVICES +IIFL,FINANCIAL SERVICES +IL&FSTRANS,CONSTRUCTION +IRB,CONSTRUCTION +ITDCEM,CONSTRUCTION +ITI,TELECOM +INDIACEM,CEMENT & CEMENT PRODUCTS +ITDC,SERVICES +IBULHSGFIN,FINANCIAL SERVICES +IBREALEST,CONSTRUCTION +IBVENTURES,FINANCIAL SERVICES +INDIANB,FINANCIAL SERVICES +IEX,FINANCIAL SERVICES +INDHOTEL,SERVICES +IOC,ENERGY +IOB,FINANCIAL SERVICES +ICIL,TEXTILES +INDOCO,PHARMA +IGL,ENERGY +INDUSINDBK,FINANCIAL SERVICES +INFIBEAM,IT +NAUKRI,IT +INFY,IT +INOXLEISUR,MEDIA & ENTERTAINMENT +INOXWIND,INDUSTRIAL MANUFACTURING +INTELLECT,IT +INDIGO,SERVICES +IPCALAB,PHARMA +JBCHEPHARM,PHARMA +JKCEMENT,CEMENT & CEMENT PRODUCTS +JKIL,CONSTRUCTION +JKLAKSHMI,CEMENT & CEMENT PRODUCTS +JKTYRE,AUTOMOBILE +JMFINANCIL,FINANCIAL SERVICES +JSWENERGY,ENERGY +JSWSTEEL,METALS +JAGRAN,MEDIA & ENTERTAINMENT +JAICORPLTD,INDUSTRIAL MANUFACTURING +JISLJALEQS,INDUSTRIAL MANUFACTURING +JPASSOCIAT,CEMENT & CEMENT PRODUCTS +JPPOWER,ENERGY +J&KBANK,FINANCIAL SERVICES +JETAIRWAYS,SERVICES +JINDALSAW,METALS +JSLHISAR,METALS +JSL,METALS +JINDALSTEL,METALS +JCHAC,CONSUMER GOODS +JUBLFOOD,CONSUMER GOODS +JUBILANT,PHARMA +JUSTDIAL,IT +JYOTHYLAB,CONSUMER GOODS +KPRMILL,TEXTILES +KIOCL,METALS +KNRCON,CONSTRUCTION +KRBL,CONSUMER GOODS +KAJARIACER,CONSTRUCTION +KALPATPOWR,ENERGY +KANSAINER,CONSUMER GOODS +KTKBANK,FINANCIAL SERVICES +KARURVYSYA,FINANCIAL SERVICES +KSCL,CONSUMER GOODS +KEC,CONSTRUCTION +KOLTEPATIL,CONSTRUCTION +KOTAKBANK,FINANCIAL SERVICES +L&TFH,FINANCIAL SERVICES +LTTS,IT +LICHSGFIN,FINANCIAL SERVICES +LAXMIMACH,INDUSTRIAL MANUFACTURING +LAKSHVILAS,FINANCIAL SERVICES +LTI,IT +LT,CONSTRUCTION +LAURUSLABS,PHARMA +LEMONTREE,SERVICES +LINDEINDIA,CHEMICALS +LUPIN,PHARMA +LUXIND,TEXTILES +MASFIN,FINANCIAL SERVICES +MMTC,SERVICES +MOIL,METALS +MRF,AUTOMOBILE +MAGMA,FINANCIAL SERVICES +MGL,ENERGY +M&MFIN,FINANCIAL SERVICES +M&M,AUTOMOBILE +MAHINDCIE,INDUSTRIAL MANUFACTURING +MHRIL,SERVICES +MAHLOG,SERVICES +MANAPPURAM,FINANCIAL SERVICES +MRPL,ENERGY +MANPASAND,CONSUMER GOODS +MARICO,CONSUMER GOODS +MARUTI,AUTOMOBILE +MFSL,FINANCIAL SERVICES +MAXINDIA,HEALTHCARE SERVICES +MCLEODRUSS,CONSUMER GOODS +MERCK,PHARMA +MINDTREE,IT +MINDACORP,AUTOMOBILE +MINDAIND,AUTOMOBILE +MONSANTO,FERTILISERS & PESTICIDES +MOTHERSUMI,AUTOMOBILE +MOTILALOFS,FINANCIAL SERVICES +MPHASIS,IT +MUTHOOTFIN,FINANCIAL SERVICES +NATCOPHARM,PHARMA +NBCC,CONSTRUCTION +NCC,CONSTRUCTION +NESCO,SERVICES +NHPC,ENERGY +NIITTECH,IT +NLCINDIA,ENERGY +NMDC,METALS +NTPC,ENERGY +NH,HEALTHCARE SERVICES +NATIONALUM,METALS +NFL,FERTILISERS & PESTICIDES +NBVENTURES,ENERGY +NAVINFLUOR,CHEMICALS +NAVKARCORP,SERVICES +NETWORK18,MEDIA & ENTERTAINMENT +NILKAMAL,INDUSTRIAL MANUFACTURING +OBEROIRLTY,CONSTRUCTION +ONGC,ENERGY +OIL,ENERGY +OMAXE,CONSTRUCTION +OFSS,IT +ORIENTCEM,CEMENT & CEMENT PRODUCTS +ORIENTBANK,FINANCIAL SERVICES +PCJEWELLER,CONSUMER GOODS +PIIND,FERTILISERS & PESTICIDES +PNBHOUSING,FINANCIAL SERVICES +PNCINFRA,CONSTRUCTION +PFS,FINANCIAL SERVICES +PTC,ENERGY +PVR,MEDIA & ENTERTAINMENT +PAGEIND,TEXTILES +PARAGMILK,CONSUMER GOODS +PERSISTENT,IT +PETRONET,ENERGY +PFIZER,PHARMA +PHILIPCARB,CHEMICALS +PHOENIXLTD,CONSTRUCTION +PIDILITIND,CHEMICALS +PEL,PHARMA +PFC,FINANCIAL SERVICES +POWERGRID,ENERGY +PRAJIND,INDUSTRIAL MANUFACTURING +PRESTIGE,CONSTRUCTION +PRSMJOHNSN,CEMENT & CEMENT PRODUCTS +PGHH,CONSUMER GOODS +PNB,FINANCIAL SERVICES +QUESS,SERVICES +RBLBANK,FINANCIAL SERVICES +RADICO,CONSUMER GOODS +RAIN,CHEMICALS +RAJESHEXPO,CONSUMER GOODS +RALLIS,FERTILISERS & PESTICIDES +RKFORGE,INDUSTRIAL MANUFACTURING +RCF,FERTILISERS & PESTICIDES +RAYMOND,TEXTILES +REDINGTON,SERVICES +RELAXO,CONSUMER GOODS +RELCAPITAL,FINANCIAL SERVICES +RCOM,TELECOM +RHFL,FINANCIAL SERVICES +RELIANCE,ENERGY +RELINFRA,ENERGY +RNAVAL,INDUSTRIAL MANUFACTURING +RNAM,FINANCIAL SERVICES +RPOWER,ENERGY +REPCOHOME,FINANCIAL SERVICES +RUPA,TEXTILES +RECLTD,FINANCIAL SERVICES +SHK,CONSUMER GOODS +SBILIFE,FINANCIAL SERVICES +SJVN,ENERGY +SKFINDIA,INDUSTRIAL MANUFACTURING +SREINFRA,FINANCIAL SERVICES +SRF,TEXTILES +SADBHAV,CONSTRUCTION +SADBHIN,CONSTRUCTION +SANOFI,PHARMA +SCHAEFFLER,INDUSTRIAL MANUFACTURING +SIS,SERVICES +SHANKARA,METALS +SHILPAMED,PHARMA +SCI,SERVICES +SHOPERSTOP,CONSUMER GOODS +SHREECEM,CEMENT & CEMENT PRODUCTS +RENUKA,CONSUMER GOODS +SHRIRAMCIT,FINANCIAL SERVICES +SRTRANSFIN,FINANCIAL SERVICES +SIEMENS,INDUSTRIAL MANUFACTURING +SPTL,INDUSTRIAL MANUFACTURING +SOBHA,CONSTRUCTION +SOLARINDS,CHEMICALS +SONATSOFTW,IT +SOUTHBANK,FINANCIAL SERVICES +STARCEMENT,CEMENT & CEMENT PRODUCTS +SBIN,FINANCIAL SERVICES +SAIL,METALS +STRTECH,TELECOM +STAR,PHARMA +SUDARSCHEM,CHEMICALS +SPARC,PHARMA +SUNPHARMA,PHARMA +SUNTV,MEDIA & ENTERTAINMENT +SUNDARMFIN,FINANCIAL SERVICES +SUNDRMFAST,AUTOMOBILE +SUNTECK,CONSTRUCTION +SUPREMEIND,INDUSTRIAL MANUFACTURING +SUVEN,PHARMA +SUZLON,INDUSTRIAL MANUFACTURING +SWANENERGY,TEXTILES +SYMPHONY,CONSUMER GOODS +SYNDIBANK,FINANCIAL SERVICES +SYNGENE,PHARMA +TIFIN,FINANCIAL SERVICES +TTKPRESTIG,CONSUMER GOODS +TVTODAY,MEDIA & ENTERTAINMENT +TV18BRDCST,MEDIA & ENTERTAINMENT +TVSMOTOR,AUTOMOBILE +TVSSRICHAK,AUTOMOBILE +TAKE,IT +TNPL,PAPER +TATACHEM,CHEMICALS +TATACOFFEE,CONSUMER GOODS +TCS,IT +TATAELXSI,IT +TATAGLOBAL,CONSUMER GOODS +TATAINVEST,FINANCIAL SERVICES +TATAMTRDVR,AUTOMOBILE +TATAMOTORS,AUTOMOBILE +TATAPOWER,ENERGY +TATASPONGE,METALS +TATASTEEL,METALS +TEAMLEASE,SERVICES +TECHM,IT +TEXRAIL,INDUSTRIAL MANUFACTURING +NIACL,FINANCIAL SERVICES +RAMCOCEM,CEMENT & CEMENT PRODUCTS +THERMAX,INDUSTRIAL MANUFACTURING +THOMASCOOK,SERVICES +THYROCARE,HEALTHCARE SERVICES +TIMETECHNO,INDUSTRIAL MANUFACTURING +TIMKEN,INDUSTRIAL MANUFACTURING +TITAN,CONSUMER GOODS +TORNTPHARM,PHARMA +TORNTPOWER,ENERGY +TRENT,CONSUMER GOODS +TRIDENT,TEXTILES +TIINDIA,AUTOMOBILE +UCOBANK,FINANCIAL SERVICES +UFLEX,INDUSTRIAL MANUFACTURING +UPL,FERTILISERS & PESTICIDES +UJJIVAN,FINANCIAL SERVICES +ULTRACEMCO,CEMENT & CEMENT PRODUCTS +UNICHEMLAB,PHARMA +UNIONBANK,FINANCIAL SERVICES +UBL,CONSUMER GOODS +MCDOWELL-N,CONSUMER GOODS +VGUARD,INDUSTRIAL MANUFACTURING +VMART,CONSUMER GOODS +VIPIND,CONSUMER GOODS +VRLLOG,SERVICES +WABAG,SERVICES +VAKRANGEE,IT +VTL,TEXTILES +VBL,CONSUMER GOODS +VEDL,METALS +VENKEYS,CONSUMER GOODS +VIJAYABANK,FINANCIAL SERVICES +VINATIORGA,CHEMICALS +IDEA,TELECOM +VOLTAS,CONSTRUCTION +WABCOINDIA,AUTOMOBILE +WELCORP,METALS +WELSPUNIND,TEXTILES +WHIRLPOOL,CONSUMER GOODS +WIPRO,IT +WOCKPHARMA,PHARMA +YESBANK,FINANCIAL SERVICES +ZEEL,MEDIA & ENTERTAINMENT +ZENSARTECH,IT +ZYDUSWELL,CONSUMER GOODS +ECLERX,IT diff --git a/tradingsystem/zerodha_order.html b/tradingsystem/zerodha_order.html index be69027..3cde93f 100644 --- a/tradingsystem/zerodha_order.html +++ b/tradingsystem/zerodha_order.html @@ -19,7 +19,7 @@ @@ -27,7 +27,7 @@
- Last updated at 2018-10-05 11:53:47.524766 + Last updated at 2018-10-24 20:35:49.258456
From fad87ebc5575e3822c598f0727631a3952b743dd Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 24 Oct 2018 20:53:43 +0530 Subject: [PATCH 18/53] get_bhav_copy function added --- tradingsystem/utils.py | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/tradingsystem/utils.py b/tradingsystem/utils.py index b3354af..2e7cbe1 100644 --- a/tradingsystem/utils.py +++ b/tradingsystem/utils.py @@ -72,3 +72,29 @@ def fetch_preopen_data(url=None): df["iep"] = df.iep.astype("f8") df.columns = ['SYMBOL', 'PctChange', 'OpenPrice'] return df + +def get_bhav_copy(date): + """ + Get bhav copy for NSE for a given date and + convert it into a dataframe + TO DO: Add BadFile Exception + """ + from zipfile import ZipFile + from io import BytesIO + + d = pd.to_datetime(date) + print(d) + year = d.strftime('%Y') + month = d.strftime('%b').upper() + base_url = f'https://www.nseindia.com/content/historical/EQUITIES/{year}/{month}/cm' + headers = {'Referer': 'https://www.nseindia.com/products/content/all_daily_reports.htm'} + bhavfile = base_url + d.strftime('%d%b%Y').upper() + 'bhav.csv.zip' + print(bhavfile) + # Uncomment the below for custom date + # bhavfile = 'customURL' + req = requests.get(bhavfile, headers=headers) + z = ZipFile(BytesIO(req.content)) + fn = z.namelist()[0] + with z.open(fn) as f: + db = pd.read_csv(f, index_col=0, parse_dates=True, usecols=range(12)) + return db.query('SERIES == "EQ"').reset_index() From 671adbfec3cda71e9fb7de82107f46e32a66f9ed Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 24 Oct 2018 21:25:37 +0530 Subject: [PATCH 19/53] parse_dates argument changed --- tradingsystem/utils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tradingsystem/utils.py b/tradingsystem/utils.py index 2e7cbe1..78e7ce0 100644 --- a/tradingsystem/utils.py +++ b/tradingsystem/utils.py @@ -96,5 +96,5 @@ def get_bhav_copy(date): z = ZipFile(BytesIO(req.content)) fn = z.namelist()[0] with z.open(fn) as f: - db = pd.read_csv(f, index_col=0, parse_dates=True, usecols=range(12)) + db = pd.read_csv(f, index_col=0, parse_dates=['TIMESTAMP'], usecols=range(12)) return db.query('SERIES == "EQ"').reset_index() From c20bc3f774607eef997ad54802987bf465ce1789 Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 24 Oct 2018 21:25:58 +0530 Subject: [PATCH 20/53] trading system script provided --- tradingsystem/trading_system.py | 227 ++++++++++++++++++++++++++++++++ 1 file changed, 227 insertions(+) create mode 100644 tradingsystem/trading_system.py diff --git a/tradingsystem/trading_system.py b/tradingsystem/trading_system.py new file mode 100644 index 0000000..c47a092 --- /dev/null +++ b/tradingsystem/trading_system.py @@ -0,0 +1,227 @@ +""" +Trading system as a script. +See the instructions in the notebook on how this works. +The only change here is that the bhav file is +automatically picked up from the web. You need to +change this manually in the utils.py file if there is a holiday. +""" + +# Import libraries +import pandas as pd +import os +import datetime +import json +from jinja2 import Environment, FileSystemLoader +from utils import * + +# PARAMETERS +# Only change the parameters to + +UNIVERSE = 'NIFTY50' # Universe to be searched +STOP_LOSS = 3 # Stop loss for the order +NUM_STOCKS = 5 # Number of stocks to sell +CAPITAL = 20000 +LEVERAGE = 1 +ORDERFILE_PREFIX = 'orders_' # Prefix file name to store +DIVERSIFY = False # whether to diversify data among sectors +ACCOUNTID = 'XXXXXX' # For any user +APIKEY = 'xxxxxxxxxxxxxxxx' # For zerodha + +# Prepare the dataframe +yesterday, today = pd.bdate_range(end=datetime.datetime.now(), periods=2) +preopen = fetch_preopen_data() +eod = get_bhav_copy(yesterday) +symbols = pd.read_excel('universe.xlsx', sheet_name=UNIVERSE, header=None).values.ravel() +sectors = pd.read_csv('sectors.csv') +df = eod[eod['SYMBOL'].isin(symbols)] +df = df[df['SERIES'] == "EQ"].reset_index(drop=True) +df = df.merge(sectors) + + +# Diversify function for diversifying sectors +def diversify(frame, n=5): + """ + Diversify stocks among sectors + frame + dataframe + n + number of stocks + """ + industry = set() + stocks = [] + for k,v in frame.iterrows(): + if v.at['Industry'] not in industry: + industry.add(v.at['Industry']) + stocks.append(v) + if len(stocks) == n: + break + f = pd.DataFrame(stocks) + if len(f) == 0: + return pd.DataFrame() + else: + return f + +# Trading logic + +df['RET'] = (df['CLOSE']/df['PREVCLOSE']) - 1 +if DIVERSIFY: + result = diversify(df.sort_values(by='RET', ascending=False), NUM_STOCKS) +else: + result = df.sort_values(by='RET', ascending = False).iloc[:NUM_STOCKS] +trading_capital = CAPITAL * LEVERAGE +orders = result.merge(preopen, on='SYMBOL') +num_stock = len(orders) + +# Pricing logic goes here + +orders['trigger_price'] = (orders['OpenPrice'] - 0.05).round(2) +orders['price'] = (orders['trigger_price'] - 0.05).round(2) + +# I prefer a constant percentage change instead of value +# If you prefer it, uncomment the below two lines + +#orders['trigger_price'] = orders['OpenPrice'] * 0.9985 +#orders['price'] = orders['trigger_price'] - 0.05 + +orders['stop_loss'] = (orders['price'] * (1 + STOP_LOSS * 0.01)).apply(tick).round(2) +orders['qty'] = (trading_capital/num_stock/orders['price']).astype(int) +orders['order'] = 'SELL' +filename = ORDERFILE_PREFIX + datetime.datetime.today().strftime('%Y-%m-%d') + '.csv' +orders.to_csv('orders/' + filename, index=False) + +def generate_nest(): + """ + Most brokers and software provide an option to place basket orders. + So we are going to create a basket order from our orders. We would be using the ``create_order`` function from ``utils.py`` file. + To do this for your specific broker, do the following steps + 1. Know the format of your broker; you can do this by placing a basket order and exporting it + 2. The format would usually have a list of columns to be filled up. We need to fill all the columns to import our order. + 3. We separate the columns into columns that are already in our dataframe and columns to be included + 4. We prepare a list of matching columns and rename them + 5. For new columns, we create a python dictionary with keys as column names and values as the value for the column (we assume that these columns have a single value) + + Thanks @vjay for providing the necessary support + """ + # List of columns to be included in the output + + cols = [ + 'Segment', 'InstrumentName', 'Symbol', 'Option Type', 'Strike Price', + 'ExpiryDate', 'Price', 'Qty', 'LTP', 'Buy/Sell', 'Order Type', + 'TriggerPrice', 'Pro/Cli', 'P Type', 'Validity', 'AccountId', + 'Validity Date', 'Remarks', 'Participant code', 'Validity Time', + 'Market Proc' + ] + + # These columns are common for all orders - columns with a single name + columns = { + 'Segment': 'NSE', + 'InstrumentName': 'EQ', + 'Option Type': 'NA', + 'Strike Price': 'NA', + 'ExpiryDate': 'NA', + 'LTP': 0, + 'Disclosed Qty': 0, + 'AccountId': ACCOUNTID, + 'Pro/Cli': 'CLI', + 'Validity': 'DAY', + 'P Type': 'MIS', + 'Remarks': '', + 'Validity Date': 'NA', + 'Participant code': '', + 'Validity Time': 'NA', + 'Market Proc': 'NA', + 'Order Type': 'SL' + } + + # These are columns to be renamed + rename = { + 'order': 'Buy/Sell', + 'price': 'Price', + 'qty': 'Qty', + 'trigger_price': 'TriggerPrice', + 'price': 'Price' , + 'SYMBOL': 'Symbol' + } + + + # Generating orders in the required format + entry_orders = orders.copy() + entry = create_orders(entry_orders, rename=rename, **columns) + + # Exit orders order type and price to be changed + exit_orders = orders.copy() + exit_orders['order'] = 'BUY' + exit_orders['price'] = 0 + exit_orders['trigger_price'] = stop_loss(orders['price'], 3, order='S').round(2) + columns.update({'Order Type': 'SL-M'}) + exit = create_orders(exit_orders, rename=rename, **columns) + + # File generation + entry.append(exit, sort=False)[cols].to_csv('orders_to_place.csv', + index=False, header=False) + + print('File generated for NEST') + +def generate_zerodha(): + """ + Order generation for Kite Zerodha + 1. Sign up for a zerodha publisher api key at(https://kite.trade/) + 2. Update the API key in parameters + 3. This would create an html file **zerodha_order.html** in your present working directory. + 4. Open the HTML file and click the submit button to log into zerodha and place your orders. + 5. Check the updated at time to make sure that this is the latest generated order. + """ + + # List of columns to be included in the output + cols = [ + 'tradingsymbol', 'exchange', 'transaction_type', 'order_type', + 'quantity', 'product', 'validity', 'price', 'trigger_price' + ] + + # These columns are common for all orders - columns with a single name + columns = { + 'exchange': 'NSE', + 'product': 'MIS', + 'validity': 'DAY', + 'order_type': 'SL' + } + + # These are columns to be renamed + rename = { + 'order': 'transaction_type', + 'price': 'Price', + 'qty': 'quantity', + 'trigger_price': 'trigger_price', + 'price': 'price' , + 'SYMBOL': 'tradingsymbol' + } + + # Generating orders in the required format + entry_orders = orders.copy() + entry = create_orders(entry_orders, rename=rename, **columns) + + # Exit orders order type and price to be changed + exit_orders = orders.copy() + exit_orders['order'] = 'BUY' + exit_orders['price'] = 0 + exit_orders['trigger_price'] = stop_loss(orders['price'], 3, order='S').round(2) + columns.update({'order_type': 'SL-M'}) + exit = create_orders(exit_orders, rename=rename, **columns) + trades = entry.append(exit, sort=False)[cols].to_dict(orient='records') + + # Order HTML file generated + env = Environment(loader=FileSystemLoader('.')) + template = env.get_template('template.html') + output_from_parsed_template = template.render(api_key = APIKEY, + orders=json.dumps(trades), + date=str(datetime.datetime.now())) + + with open('zerodha_order.html', 'w') as f: + f.write(output_from_parsed_template) + print('Zerodha order file generated') + +if __name__ == "__main__": + generate_nest() + generate_zerodha() + + From 44d8accb6ddbbae6d6e4da104f76b32f88789d19 Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 24 Oct 2018 21:36:32 +0530 Subject: [PATCH 21/53] script added for automation linux --- tradingsystem/linux_runner.sh | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100755 tradingsystem/linux_runner.sh diff --git a/tradingsystem/linux_runner.sh b/tradingsystem/linux_runner.sh new file mode 100755 index 0000000..ddcc6a6 --- /dev/null +++ b/tradingsystem/linux_runner.sh @@ -0,0 +1,7 @@ +#!/bin/sh + +# Assuming anaconda is installed on PATH +# run this from your tradingsystem directory + +export PATH=$HOME/anaconda3/bin:$PATH +python trading_system.py From 4c071320631ee7b42d7498488b2e6210361fbeb2 Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 24 Oct 2018 21:38:44 +0530 Subject: [PATCH 22/53] automation script for windows added --- tradingsystem/windows_runner.bat | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 tradingsystem/windows_runner.bat diff --git a/tradingsystem/windows_runner.bat b/tradingsystem/windows_runner.bat new file mode 100644 index 0000000..8bd9842 --- /dev/null +++ b/tradingsystem/windows_runner.bat @@ -0,0 +1,5 @@ +:: Change path to your tradingsystem path + +cd tradingsystem +cd +python trading_system.py \ No newline at end of file From 8de7ad3f35822fdf798236d3620d41f7a8a501a8 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 7 Jun 2019 17:46:52 +0530 Subject: [PATCH 23/53] basic oi chart aded --- oi_graph/README.md | 4 ++++ oi_graph/oi.py | 48 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 oi_graph/README.md create mode 100644 oi_graph/oi.py diff --git a/oi_graph/README.md b/oi_graph/README.md new file mode 100644 index 0000000..aa2f52b --- /dev/null +++ b/oi_graph/README.md @@ -0,0 +1,4 @@ +Open Interest Plotting +----------------------- + +Open Interest Plotting with bokeh \ No newline at end of file diff --git a/oi_graph/oi.py b/oi_graph/oi.py new file mode 100644 index 0000000..ca98d69 --- /dev/null +++ b/oi_graph/oi.py @@ -0,0 +1,48 @@ +import numpy as np +import pandas as pd +import datetime + +from bokeh.io import curdoc +from bokeh.layouts import row, column +from bokeh.plotting import figure +from bokeh.models import ColumnDataSource +from bokeh.models.widgets import Select, TextInput, DatePicker, Button + +# Load data, probably from a database. I am loading it directly from a file +df = pd.read_hdf('derivatives_may_2019.h5') +symbols = sorted(list(df.symbol.unique())) +source = ColumnDataSource(df) + +def update_expiry_date(attrname, old, new): + """ + Update expiry date for this particular symbol + """ + print(attrname, old, new) + q = 'symbol == "{}"'.format(new) + dates = sorted(df.query(q).expiry_dt.unique()) + dates = [str(dt)[:10] for dt in dates] + expiry_select.options = dates + + +# Create widgets +select_symbols = Select(title='Pick a symbol', options=symbols) +expiry_select = Select(title='Select an expiry date', options=None) +date_picker = DatePicker(title='Select a date') +button = Button(label="Update", button_type="success") + +# Event handlers +select_symbols.on_change('value', update_expiry_date) +date_picker.on_change('value', lambda x,y,z: print(z)) + +layout = column( + row(select_symbols, expiry_select), + row(date_picker, button) + ) + +# add the layout to curdoc +curdoc().add_root(layout) + +if __name__ == "__main__": + print('Hello') + + From 69cd7b7611e72320fcb431b09051632ab5e2e1a2 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 18 Jun 2019 18:49:17 +0530 Subject: [PATCH 24/53] chart with factor axis added --- oi_graph/oi.py | 99 +++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 93 insertions(+), 6 deletions(-) diff --git a/oi_graph/oi.py b/oi_graph/oi.py index ca98d69..731cf00 100644 --- a/oi_graph/oi.py +++ b/oi_graph/oi.py @@ -2,11 +2,12 @@ import pandas as pd import datetime -from bokeh.io import curdoc +from bokeh.io import curdoc, show, output_file from bokeh.layouts import row, column from bokeh.plotting import figure -from bokeh.models import ColumnDataSource +from bokeh.models import ColumnDataSource, FactorRange from bokeh.models.widgets import Select, TextInput, DatePicker, Button +from bokeh.transform import factor_cmap # Load data, probably from a database. I am loading it directly from a file df = pd.read_hdf('derivatives_may_2019.h5') @@ -17,26 +18,112 @@ def update_expiry_date(attrname, old, new): """ Update expiry date for this particular symbol """ - print(attrname, old, new) q = 'symbol == "{}"'.format(new) dates = sorted(df.query(q).expiry_dt.unique()) dates = [str(dt)[:10] for dt in dates] expiry_select.options = dates + expiry_select.value = dates[0] + print(select_symbols, select_symbols.value, date_picker.value) + +def update_oi_chart(): + pass + +def query(dataframe, symbol='NIFTY', date='2019-05-02', expiry='2019-05-30'): + """ + Given a dataframe and query string, return the queried data + """ + cond = '(symbol=="{symbol}") & (timestamp == "{dt}") & (expiry_dt=="{exp}") & (option_typ != "XX")' + q = cond.format(symbol=symbol, dt=str(date)[:10], exp=str(expiry)[:10]) + print('QUERY IS', q) + df2 = dataframe.query(q)[['strike_pr', 'option_typ', 'open_int']] + df2.sort_values(by=['strike_pr'], inplace=True) + return df2 + +def get_data_as_source(data): + """ + Get data in source format + """ + x = [(str(int(a)), str(b)) for a,b in zip(q.strike_pr, q.option_typ)] + source = ColumnDataSource(data=dict(x=x, values=data.open_int.values)) + return source + +def fig1(): + """ + Generate the first figure + """ + q = query(df, symbol=select_symbols.value, date=date_picker.value, + expiry=expiry_select.value) + #q = query(df, symbol='ACC', date='2019-05-23', expiry='2019-05-30') + if (q is None) or (len(q) == 0): + return figure() + + x = [(str(int(a)), str(b)) for a,b in zip(q.strike_pr, q.option_typ)] + source = ColumnDataSource(data=dict(x=x, values=q.open_int.values)) + + TOOLTIPS = [ + ('index', '$index'), + ('open_interest', '@values'), + ('option', '@x') + ] + p = figure(x_range=FactorRange(*x), + title="Open Interest", tooltips=TOOLTIPS, + tools="pan,wheel_zoom,box_zoom,hover,reset") + p.vbar(x='x', top='values', width=0.9, source=source, + fill_color=factor_cmap('x', palette=['red', 'green'], + factors=['PE', 'CE'], start=1, end=2)) + + +def update(): + """ + Update chart data + """ + data = query(df, symbol=select_symbols.value, date=date_picker.value, + expiry=expiry_select.value) + x_range = [(str(int(a)), str(b)) for a,b in + zip(data.strike_pr, data.option_typ)] + src = ColumnDataSource({'x': x_range, 'values': data.open_int.values}) + source.data = src.data + #p1.x_range = FactorRange(*x) + # Create widgets select_symbols = Select(title='Pick a symbol', options=symbols) expiry_select = Select(title='Select an expiry date', options=None) -date_picker = DatePicker(title='Select a date') +date_picker = DatePicker(title='Select a date', + value=datetime.datetime.today().date()) button = Button(label="Update", button_type="success") +# Create charts +q = query(df, symbol=select_symbols.value, date=date_picker.value, + expiry=expiry_select.value) +q = query(df, symbol='BANKBARODA') +x = [(str(int(a)), str(b)) for a,b in zip(q.strike_pr, q.option_typ)] +source = ColumnDataSource({'x': x, 'values': q.open_int.values}) +TOOLTIPS = [ + ('index', '$index'), + ('open_interest', '@values'), + ('option', '@x') + ] +p1 = figure(x_range=FactorRange(), + title="Open Interest", tooltips=TOOLTIPS, + tools="pan,wheel_zoom,box_zoom,hover,reset") +p1.x_range = FactorRange(*x) + +bar = p1.vbar(x='x', top='values', width=0.9, source=source, + fill_color=factor_cmap('x', palette=['red', 'green'], + factors=['PE', 'CE'], start=1, end=2)) + + # Event handlers select_symbols.on_change('value', update_expiry_date) -date_picker.on_change('value', lambda x,y,z: print(z)) +#date_picker.on_change('value', lambda x,y,z: print(z)) +button.on_click(update) layout = column( row(select_symbols, expiry_select), - row(date_picker, button) + row(date_picker, button), + row(p1) ) # add the layout to curdoc From 410bc25c620e857e806e615e8510a20ea68a6e78 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 18 Jun 2019 19:34:28 +0530 Subject: [PATCH 25/53] Categorical data axis corrected --- oi_graph/oi.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/oi_graph/oi.py b/oi_graph/oi.py index 731cf00..aa6bd3d 100644 --- a/oi_graph/oi.py +++ b/oi_graph/oi.py @@ -81,9 +81,9 @@ def update(): expiry=expiry_select.value) x_range = [(str(int(a)), str(b)) for a,b in zip(data.strike_pr, data.option_typ)] + p1.x_range.factors = x_range src = ColumnDataSource({'x': x_range, 'values': data.open_int.values}) source.data = src.data - #p1.x_range = FactorRange(*x) @@ -99,7 +99,7 @@ def update(): expiry=expiry_select.value) q = query(df, symbol='BANKBARODA') x = [(str(int(a)), str(b)) for a,b in zip(q.strike_pr, q.option_typ)] -source = ColumnDataSource({'x': x, 'values': q.open_int.values}) +source = ColumnDataSource(data=dict(x=x, values=q.open_int.values)) TOOLTIPS = [ ('index', '$index'), ('open_interest', '@values'), @@ -109,8 +109,8 @@ def update(): title="Open Interest", tooltips=TOOLTIPS, tools="pan,wheel_zoom,box_zoom,hover,reset") p1.x_range = FactorRange(*x) - bar = p1.vbar(x='x', top='values', width=0.9, source=source, + alpha=0.7, fill_color=factor_cmap('x', palette=['red', 'green'], factors=['PE', 'CE'], start=1, end=2)) From a59abdc37cc143171477bfbe1ddf4eb7f69bae6e Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 13:44:28 +0530 Subject: [PATCH 26/53] futures_oi chart imports added --- oi_graph/futures_oi.py | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 oi_graph/futures_oi.py diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py new file mode 100644 index 0000000..d6851d8 --- /dev/null +++ b/oi_graph/futures_oi.py @@ -0,0 +1,15 @@ +from bokeh.io import curdoc +from bokeh.layouts import row, column, gridplot +from bokeh.models import ColumnDataSource +from bokeh.models.widgets import Select +from bokeh.plotting import figure, output_file, show + + +def main(): + output_file('futures_oi.html') + p = figure() + show(p) + + +if __name__ == "__main__": + main() \ No newline at end of file From 11c18640d883e0cb4b21b05dba5fb59e707a4178 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 14:14:20 +0530 Subject: [PATCH 27/53] data loader and select button added --- oi_graph/futures_oi.py | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index d6851d8..b7c9c6d 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -1,14 +1,37 @@ +import pandas as pd +import numpy as np + from bokeh.io import curdoc -from bokeh.layouts import row, column, gridplot +from bokeh.layouts import row, column, gridplot, layout from bokeh.models import ColumnDataSource -from bokeh.models.widgets import Select +from bokeh.models.widgets import Select, Button from bokeh.plotting import figure, output_file, show +def load_data(): + """ + Load all data into memory + return a dataframe with all the data. + This should be called only once with all data being fetched + """ + return pd.read_hdf('~/Desktop/todaydata.h5') + + + def main(): output_file('futures_oi.html') - p = figure() - show(p) + df = load_data() + symbols = list(df.symbol.unique()) + + # Create widgets + select_symbol = Select(options=symbols, title='Select a symbol') + + + # Display the dashboard + l = layout( + row(select_symbol) + ) + show(l) if __name__ == "__main__": From 396bdfbd52ea251e81189e2e84dc0db449fd3172 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 18:27:35 +0530 Subject: [PATCH 28/53] oi chart added --- oi_graph/futures_oi.py | 64 +++++++++++++++++++++++++++++------------- 1 file changed, 45 insertions(+), 19 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index b7c9c6d..80ac37f 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -3,36 +3,62 @@ from bokeh.io import curdoc from bokeh.layouts import row, column, gridplot, layout +from bokeh.palettes import Spectral6 from bokeh.models import ColumnDataSource from bokeh.models.widgets import Select, Button from bokeh.plotting import figure, output_file, show def load_data(): - """ - Load all data into memory - return a dataframe with all the data. - This should be called only once with all data being fetched - """ - return pd.read_hdf('~/Desktop/todaydata.h5') - + """ + Load all data into memory + return a dataframe with all the data. + This should be called only once with all data being fetched + """ + return pd.read_hdf('~/Desktop/todaydata.h5') +def get_open_interest(data, symbol): + """ + Given data and symbol, return the expiry dates and + open_interest for various expiry dates in columns + data + dataframe with all the data + symbol + symbol to extract + return a 2-tuple with list of column names and + a dataframe with open interest + """ + temp = data[data.symbol == symbol] + cols = ['timestamp', 'expiry_dt', 'open_int'] + pivot = temp.pivot(index='timestamp', columns='expiry_dt', values='open_int') + pivot.rename(lambda x: x.strftime('%Y-%m-%d'), + axis='columns', inplace=True) + return (list(pivot.columns), pivot.reset_index()) def main(): - output_file('futures_oi.html') - df = load_data() - symbols = list(df.symbol.unique()) - - # Create widgets - select_symbol = Select(options=symbols, title='Select a symbol') + output_file('futures_oi.html') + df = load_data() + symbols = list(df.symbol.unique()) + source = ColumnDataSource() + + # Create widgets + select_symbol = Select(options=symbols, title='Select a symbol') + + # Create plots + p = figure(title='Open interest chart for futures') + cols, data = get_open_interest(df, 'SBIN') + colors = Spectral6[:len(cols)] + source.data = source.from_df(data) + print(cols, colors) + p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) - # Display the dashboard - l = layout( - row(select_symbol) - ) - show(l) + # Display the dashboard + l = layout( + row([select_symbol, p]) + ) + show(l) if __name__ == "__main__": - main() \ No newline at end of file + main() \ No newline at end of file From f56cb398c123f976d5c668b860a1e0f67e750119 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 20:02:13 +0530 Subject: [PATCH 29/53] interactivity added --- oi_graph/futures_oi.py | 60 ++++++++++++++++++++++++++---------------- 1 file changed, 38 insertions(+), 22 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 80ac37f..b39ff8b 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -4,7 +4,7 @@ from bokeh.io import curdoc from bokeh.layouts import row, column, gridplot, layout from bokeh.palettes import Spectral6 -from bokeh.models import ColumnDataSource +from bokeh.models import ColumnDataSource, Range1d from bokeh.models.widgets import Select, Button from bokeh.plotting import figure, output_file, show @@ -33,32 +33,48 @@ def get_open_interest(data, symbol): pivot = temp.pivot(index='timestamp', columns='expiry_dt', values='open_int') pivot.rename(lambda x: x.strftime('%Y-%m-%d'), axis='columns', inplace=True) + pct_pivot = pivot.pct_change()*100 return (list(pivot.columns), pivot.reset_index()) -def main(): - output_file('futures_oi.html') - df = load_data() - symbols = list(df.symbol.unique()) - source = ColumnDataSource() - - # Create widgets - select_symbol = Select(options=symbols, title='Select a symbol') +output_file('futures_oi.html') +df = load_data() +symbols = list(df.symbol.unique()) +source = ColumnDataSource() +# Create widgets +select_symbol = Select(options=symbols, title='Select a symbol', + value='NIFTY') +button = Button(label='Refresh', button_type="success") - # Create plots - p = figure(title='Open interest chart for futures') - cols, data = get_open_interest(df, 'SBIN') - colors = Spectral6[:len(cols)] +# Create plots +p = figure(title='Open interest chart for NIFTY futures') +cols, data = get_open_interest(df, 'NIFTY') +colors = Spectral6[:len(cols)] +source.data = source.from_df(data) +print(cols, colors) +p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) + +# setup callbacks +def update(): + symbol = select_symbol.value + cols, data = get_open_interest(df, symbol) source.data = source.from_df(data) - print(cols, colors) - p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) + max_val = data.sum(axis=1).max() + print(cols, symbol, max_val) + p.y_range = Range1d(100, max_val) + p.title.text = 'Open interest chart for {} futures'.format(symbol) + + +# set up event triggers +button.on_click(update) - # Display the dashboard - l = layout( - row([select_symbol, p]) - ) - show(l) +# Display the dashboard +l = layout( + column( + row(select_symbol,button), + p) + ) -if __name__ == "__main__": - main() \ No newline at end of file +curdoc().add_root(l) +show(l) \ No newline at end of file From 397d18baf637d6c587439939b5b2b5b5f1c306f9 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 20:35:40 +0530 Subject: [PATCH 30/53] dates added on hover --- oi_graph/futures_oi.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index b39ff8b..9ad0f29 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -47,8 +47,13 @@ def get_open_interest(data, symbol): button = Button(label='Refresh', button_type="success") # Create plots -p = figure(title='Open interest chart for NIFTY futures') +p = figure(title='Open interest chart for NIFTY futures', + tooltips=[ + ('date', '@date'), + ('value', '$y{0 a}') + ]) cols, data = get_open_interest(df, 'NIFTY') +data['date'] = data.timestamp.dt.date.astype(str) colors = Spectral6[:len(cols)] source.data = source.from_df(data) print(cols, colors) @@ -58,6 +63,7 @@ def get_open_interest(data, symbol): def update(): symbol = select_symbol.value cols, data = get_open_interest(df, symbol) + data['date'] = data.timestamp.dt.date.astype(str) source.data = source.from_df(data) max_val = data.sum(axis=1).max() print(cols, symbol, max_val) From 2220b1bcf1d43a19f2d301efdf351421c529ff0a Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 21:14:48 +0530 Subject: [PATCH 31/53] get_price_oi function added --- oi_graph/futures_oi.py | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 9ad0f29..b4cf2a7 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -36,6 +36,22 @@ def get_open_interest(data, symbol): pct_pivot = pivot.pct_change()*100 return (list(pivot.columns), pivot.reset_index()) +def get_price_oi(data, symbol): + """ + Get the price and combined open_interest for the symbol + data + dataframe with all data + symbol + symbol to extract data + """ + temp = data[data.symbol == symbol] + grouped = temp.groupby('timestamp') + agg = grouped.agg({'open_int': sum, 'close': 'mean'}).reset_index() + agg['date'] = agg.timestamp.dt.date.astype(str) + agg['index'] = range(len(agg)) + return agg + + output_file('futures_oi.html') df = load_data() symbols = list(df.symbol.unique()) From 0210cf0675b09ab709b9d7a78b65b388ff54c4d4 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 9 Aug 2019 21:15:27 +0530 Subject: [PATCH 32/53] axes with twin plots added --- oi_graph/futures_oi.py | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index b4cf2a7..12adb36 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -51,6 +51,35 @@ def get_price_oi(data, symbol): agg['index'] = range(len(agg)) return agg +def twin_plot(data, y_axis, x_axis='timestamp'): + """ + Create a bokeh plot with twin axes + """ + from bokeh.plotting import figure + from bokeh.models import LinearAxis, Range1d + + TOOLTIPS = [ + ('datetime', '@x{%F %H:%M}'), + ('value', '$y{0.00}') + ] + + y1,y2 = y_axis[0], y_axis[1] + h0 = data[y1].max() + l0 = data[y1].min() + h1 = data[y2].max() + l1 = data[y2].min() + p = figure(x_axis_type='datetime', y_range=(l0, h0), + tooltips=TOOLTIPS, height=240, width=600) + p.line(data[x_axis].values, data[y1].values, + color="red", legend=y1) + p.extra_y_ranges = {"foo": Range1d(l1,h1)} + p.line(data[x_axis], data[y2].values, color="blue", + y_range_name="foo", legend=y2) + p.add_layout(LinearAxis(y_range_name="foo", axis_label=y2), 'left') + p.hover.formatters= {'x': 'datetime'} + p.legend.location = 'top_center' + p.legend.click_policy = 'hide' + return p output_file('futures_oi.html') df = load_data() From 0061d95b60dd0bd71714a7001a593e44d24571a1 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 21:15:20 +0530 Subject: [PATCH 33/53] Outline added for framework --- notebooks/OptionsBacktesting.ipynb | 123 +++++++++++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 notebooks/OptionsBacktesting.ipynb diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb new file mode 100644 index 0000000..00fa7e6 --- /dev/null +++ b/notebooks/OptionsBacktesting.ipynb @@ -0,0 +1,123 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Options Backtesting Framework\n", + "\n", + "This is a simple backtesting framework for options. Given end of day data for both the capital and derivatives markets, we would be backtesting for different strategies.\n", + "\n", + "> All options are opened at the start of the period and closed by the end of the period or by a stop loss if provided\n", + "\n", + "### Implementation\n", + "\n", + "1. Load and transform necessary data\n", + "2. Create a list of option contracts to be entered into each day\n", + "3. Create a list of signals on, whether to enter into the contract, for each day\n", + "4. Extract the necessary data for the options contracts that would be executed\n", + "5. Analyze Profit and loss and other metrices\n" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [], + "source": [ + "# Load necessary libraries\n", + "\n", + "import pandas as pd\n", + "import numpy as np\n", + "from fastbt.rapid import backtest" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Utility Functions" + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "10225" + ] + }, + "execution_count": 24, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "def itm(price, opt='C', step=100):\n", + " \"\"\"\n", + " Get the strike price of the in the money option\n", + " price\n", + " spot price\n", + " opt\n", + " option type - C for Call and P for Put\n", + " step\n", + " multiple of option strike price\n", + " \"\"\"\n", + " if opt == 'C':\n", + " return int(price/step)*step\n", + " elif opt == 'P':\n", + " return (int(price/step)+1)*step" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Data Preparation\n", + "-----------------\n", + "Load the raw data and do some transformations. All raw options data is loaded from the bhav copy of the NSE website. Index data is from [niftyindices.com](https://www.niftyindices.com/)." + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [], + "source": [ + "nifty = pd.read_csv('/home/machine/Downloads/NIFTY 50_Data.csv',\n", + " parse_dates=['Date'])" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.6.8" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} From 3ac3f2f7be931e0c92ccda312aafd56231e77e32 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 21:38:40 +0530 Subject: [PATCH 34/53] load necessary data --- notebooks/OptionsBacktesting.ipynb | 55 ++++++++++++++++++++---------- 1 file changed, 37 insertions(+), 18 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index 00fa7e6..3f96241 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -41,20 +41,9 @@ }, { "cell_type": "code", - "execution_count": 24, + "execution_count": 25, "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "10225" - ] - }, - "execution_count": 24, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ "def itm(price, opt='C', step=100):\n", " \"\"\"\n", @@ -83,20 +72,50 @@ }, { "cell_type": "code", - "execution_count": 10, + "execution_count": 75, "metadata": {}, "outputs": [], "source": [ "nifty = pd.read_csv('/home/machine/Downloads/NIFTY 50_Data.csv',\n", - " parse_dates=['Date'])" + " parse_dates=['Date'])\n", + "der = pd.read_hdf('/media/machine/4E1EA2D152455460/data/output/fno_2019.h5')\n", + "der['exp_day'] = der.expiry_dt.dt.day\n", + "\n", + "# Difference between expiry date and date\n", + "der['day_diff'] = (der['expiry_dt'] - der['timestamp']).dt.days\n" ] }, { "cell_type": "code", - "execution_count": null, + "execution_count": 89, "metadata": {}, - "outputs": [], - "source": [] + "outputs": [ + { + "data": { + "text/plain": [ + "2 2019-01-31\n", + "1 2019-02-28\n", + "3 2019-03-28\n", + "0 2019-04-25\n", + "4 2019-05-30\n", + "5 2019-06-27\n", + "dtype: datetime64[ns]" + ] + }, + "execution_count": 89, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Change your symbol here\n", + "symbol = 'NIFTY'\n", + "# Keep nifty data with monthly options only\n", + "# This hack is incomplete and should be correctly configured\n", + "q = '(symbol==\"{sym}\") & (instrument==\"OPTIDX\") & (exp_day > 24) & (day_diff<31)'\n", + "df = der.query(q.format(sym=symbol))\n", + "pd.Series(df.expiry_dt.unique()).sort_values()" + ] } ], "metadata": { From 9bb39b298c96d6b6dcba493ed516d94673e2455a Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 21:47:31 +0530 Subject: [PATCH 35/53] Option prices added --- notebooks/OptionsBacktesting.ipynb | 121 ++++++++++++++++++++++++++++- 1 file changed, 117 insertions(+), 4 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index 3f96241..4566d6a 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -72,22 +72,26 @@ }, { "cell_type": "code", - "execution_count": 75, + "execution_count": 94, "metadata": {}, "outputs": [], "source": [ "nifty = pd.read_csv('/home/machine/Downloads/NIFTY 50_Data.csv',\n", " parse_dates=['Date'])\n", + "nifty.rename(lambda x: x.lower(), axis='columns', inplace=True)\n", + "nifty = nifty[nifty.date.dt.year==2019].sort_values(by='date').reset_index(drop=True)\n", + "\n", "der = pd.read_hdf('/media/machine/4E1EA2D152455460/data/output/fno_2019.h5')\n", + "der.rename({'timestamp': 'date'}, axis='columns', inplace=True)\n", "der['exp_day'] = der.expiry_dt.dt.day\n", "\n", "# Difference between expiry date and date\n", - "der['day_diff'] = (der['expiry_dt'] - der['timestamp']).dt.days\n" + "der['day_diff'] = (der['expiry_dt'] - der['date']).dt.days\n" ] }, { "cell_type": "code", - "execution_count": 89, + "execution_count": 101, "metadata": {}, "outputs": [ { @@ -102,7 +106,7 @@ "dtype: datetime64[ns]" ] }, - "execution_count": 89, + "execution_count": 101, "metadata": {}, "output_type": "execute_result" } @@ -116,6 +120,115 @@ "df = der.query(q.format(sym=symbol))\n", "pd.Series(df.expiry_dt.unique()).sort_values()" ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Select list of options\n", + "-----------------------\n", + "\n", + "We must now select the list of options to be traded. To begin, with let's BUY in the money call option at the start of the day and hold it till the end of the day. We need the following columns for each day\n", + "\n", + " * date\n", + " * strike price\n", + " * option_type\n", + " * spot price" + ] + }, + { + "cell_type": "code", + "execution_count": 103, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
\n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
datestrikeoptspot
02019-01-0110800CE10881.70
12019-01-0210800CE10868.85
22019-01-0310700CE10796.80
32019-01-0410600CE10699.70
42019-01-0710800CE10804.85
\n", + "
" + ], + "text/plain": [ + " date strike opt spot\n", + "0 2019-01-01 10800 CE 10881.70\n", + "1 2019-01-02 10800 CE 10868.85\n", + "2 2019-01-03 10700 CE 10796.80\n", + "3 2019-01-04 10600 CE 10699.70\n", + "4 2019-01-07 10800 CE 10804.85" + ] + }, + "execution_count": 103, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "nifty['strike'] = [itm(x) for x in nifty.open]\n", + "nifty['spot'] = nifty.open.copy()\n", + "nifty['opt'] = 'CE'\n", + "cols = ['date', 'strike', 'opt', 'spot']\n", + "nifty[cols].head()" + ] } ], "metadata": { From 0858535b8ba7cd61f7b74c1206d03d79da96ad3d Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 21:53:01 +0530 Subject: [PATCH 36/53] Signals added --- notebooks/OptionsBacktesting.ipynb | 126 ++++++++++++++++++++++++++--- 1 file changed, 117 insertions(+), 9 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index 4566d6a..dcfbce1 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -14,14 +14,14 @@ "\n", "1. Load and transform necessary data\n", "2. Create a list of option contracts to be entered into each day\n", - "3. Create a list of signals on, whether to enter into the contract, for each day\n", + "3. Create a list of signals, on whether to enter into the contract, for each day\n", "4. Extract the necessary data for the options contracts that would be executed\n", "5. Analyze Profit and loss and other metrices\n" ] }, { "cell_type": "code", - "execution_count": 9, + "execution_count": 1, "metadata": {}, "outputs": [], "source": [ @@ -41,7 +41,7 @@ }, { "cell_type": "code", - "execution_count": 25, + "execution_count": 2, "metadata": {}, "outputs": [], "source": [ @@ -72,7 +72,7 @@ }, { "cell_type": "code", - "execution_count": 94, + "execution_count": 3, "metadata": {}, "outputs": [], "source": [ @@ -91,7 +91,7 @@ }, { "cell_type": "code", - "execution_count": 101, + "execution_count": 4, "metadata": {}, "outputs": [ { @@ -106,7 +106,7 @@ "dtype: datetime64[ns]" ] }, - "execution_count": 101, + "execution_count": 4, "metadata": {}, "output_type": "execute_result" } @@ -138,7 +138,7 @@ }, { "cell_type": "code", - "execution_count": 103, + "execution_count": 7, "metadata": {}, "outputs": [ { @@ -217,7 +217,7 @@ "4 2019-01-07 10800 CE 10804.85" ] }, - "execution_count": 103, + "execution_count": 7, "metadata": {}, "output_type": "execute_result" } @@ -227,7 +227,115 @@ "nifty['spot'] = nifty.open.copy()\n", "nifty['opt'] = 'CE'\n", "cols = ['date', 'strike', 'opt', 'spot']\n", - "nifty[cols].head()" + "options = nifty[cols]\n", + "options.head()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Select signals\n", + "--------------\n", + "\n", + "A signal is a indication whether to buy or sell the contract on a daily basis. It is a single column that outputs 1 if the contract is entered into or a 0 if the contract is not entered. Since we would be trading for all the days, we simply include a 1 for all dates" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
\n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
datestrikeoptspotsignal
02019-01-0110800CE10881.701
12019-01-0210800CE10868.851
22019-01-0310700CE10796.801
32019-01-0410600CE10699.701
42019-01-0710800CE10804.851
\n", + "
" + ], + "text/plain": [ + " date strike opt spot signal\n", + "0 2019-01-01 10800 CE 10881.70 1\n", + "1 2019-01-02 10800 CE 10868.85 1\n", + "2 2019-01-03 10700 CE 10796.80 1\n", + "3 2019-01-04 10600 CE 10699.70 1\n", + "4 2019-01-07 10800 CE 10804.85 1" + ] + }, + "execution_count": 14, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "options.loc[:, 'signal'] = 1\n", + "options.head()" ] } ], From cb33f7f4e5e1ed5bc788c868fecd6e9237c8bc48 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 22:08:55 +0530 Subject: [PATCH 37/53] Merging data added --- notebooks/OptionsBacktesting.ipynb | 108 ++++++++++++++++++++--------- 1 file changed, 77 insertions(+), 31 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index dcfbce1..ed3207f 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -91,22 +91,22 @@ }, { "cell_type": "code", - "execution_count": 4, + "execution_count": 46, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "2 2019-01-31\n", + "4 2019-01-31\n", "1 2019-02-28\n", - "3 2019-03-28\n", + "2 2019-03-28\n", "0 2019-04-25\n", - "4 2019-05-30\n", + "3 2019-05-30\n", "5 2019-06-27\n", "dtype: datetime64[ns]" ] }, - "execution_count": 4, + "execution_count": 46, "metadata": {}, "output_type": "execute_result" } @@ -116,7 +116,7 @@ "symbol = 'NIFTY'\n", "# Keep nifty data with monthly options only\n", "# This hack is incomplete and should be correctly configured\n", - "q = '(symbol==\"{sym}\") & (instrument==\"OPTIDX\") & (exp_day > 24) & (day_diff<31)'\n", + "q = '(symbol==\"{sym}\") & (instrument==\"OPTIDX\") & (exp_day > 24) & (day_diff<29)'\n", "df = der.query(q.format(sym=symbol))\n", "pd.Series(df.expiry_dt.unique()).sort_values()" ] @@ -138,7 +138,7 @@ }, { "cell_type": "code", - "execution_count": 7, + "execution_count": 47, "metadata": {}, "outputs": [ { @@ -163,8 +163,8 @@ " \n", " \n", " date\n", - " strike\n", - " opt\n", + " strike_pr\n", + " option_typ\n", " spot\n", " \n", " \n", @@ -209,25 +209,25 @@ "" ], "text/plain": [ - " date strike opt spot\n", - "0 2019-01-01 10800 CE 10881.70\n", - "1 2019-01-02 10800 CE 10868.85\n", - "2 2019-01-03 10700 CE 10796.80\n", - "3 2019-01-04 10600 CE 10699.70\n", - "4 2019-01-07 10800 CE 10804.85" + " date strike_pr option_typ spot\n", + "0 2019-01-01 10800 CE 10881.70\n", + "1 2019-01-02 10800 CE 10868.85\n", + "2 2019-01-03 10700 CE 10796.80\n", + "3 2019-01-04 10600 CE 10699.70\n", + "4 2019-01-07 10800 CE 10804.85" ] }, - "execution_count": 7, + "execution_count": 47, "metadata": {}, "output_type": "execute_result" } ], "source": [ - "nifty['strike'] = [itm(x) for x in nifty.open]\n", + "nifty['strike_pr'] = [itm(x) for x in nifty.open]\n", "nifty['spot'] = nifty.open.copy()\n", - "nifty['opt'] = 'CE'\n", - "cols = ['date', 'strike', 'opt', 'spot']\n", - "options = nifty[cols]\n", + "nifty['option_typ'] = 'CE'\n", + "cols = ['date', 'strike_pr', 'option_typ', 'spot']\n", + "options = nifty[cols].copy()\n", "options.head()" ] }, @@ -243,7 +243,7 @@ }, { "cell_type": "code", - "execution_count": 14, + "execution_count": 48, "metadata": {}, "outputs": [ { @@ -268,8 +268,8 @@ " \n", " \n", " date\n", - " strike\n", - " opt\n", + " strike_pr\n", + " option_typ\n", " spot\n", " signal\n", " \n", @@ -320,23 +320,69 @@ "" ], "text/plain": [ - " date strike opt spot signal\n", - "0 2019-01-01 10800 CE 10881.70 1\n", - "1 2019-01-02 10800 CE 10868.85 1\n", - "2 2019-01-03 10700 CE 10796.80 1\n", - "3 2019-01-04 10600 CE 10699.70 1\n", - "4 2019-01-07 10800 CE 10804.85 1" + " date strike_pr option_typ spot signal\n", + "0 2019-01-01 10800 CE 10881.70 1\n", + "1 2019-01-02 10800 CE 10868.85 1\n", + "2 2019-01-03 10700 CE 10796.80 1\n", + "3 2019-01-04 10600 CE 10699.70 1\n", + "4 2019-01-07 10800 CE 10804.85 1" ] }, - "execution_count": 14, + "execution_count": 48, "metadata": {}, "output_type": "execute_result" } ], "source": [ - "options.loc[:, 'signal'] = 1\n", + "options['signal'] = 1\n", "options.head()" ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Merging data and backtesting\n", + "-----------------------------\n", + "Since we have restricted the data at the time of query to only contracts with monthly expiry and to a particular symbol, there would be only one contract with the specific strike and option type on a particular date. So we could go ahead with a simple merge\n" + ] + }, + { + "cell_type": "code", + "execution_count": 57, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 57, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAX8AAAD4CAYAAAAEhuazAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjAsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+17YcXAAAgAElEQVR4nO3deXybV5no8d+RZMuLvMtLvCS2Y2df2zRL27SlCbRAF2AYBgZKgTK9M+yzXIa53LnMBsMMDNyBYZnSAi23UDqlhQ4tdN/SbE3bJM3uJXFiO97kfZMs6dw/3leKHMurFsvy8/18/In96rX0KkoeHT3nOc9RWmuEEEIsLpb5vgAhhBDxJ8FfCCEWIQn+QgixCEnwF0KIRUiCvxBCLEK2+b6AmXA6nbqysnK+L0MIIRaU119/vUtrXRjutgUR/CsrKzl06NB8X4YQQiwoSqmmyW6TtI8QQixCEvyFEGIRkuAvhBCLkAR/IYRYhCT4CyHEIiTBXwghFqGIg79SKk0pdVApdUQpdVwp9ffm8Sql1AGlVJ1S6pdKqVTzuN38ud68vTLSaxBCCDE70Rj5u4EbtdYbgU3AzUqp7cC/AN/WWtcCPcBd5vl3AT1a6xrg2+Z5QogF5MXTHTR0Ds73ZYgIRBz8tSHwryDF/NLAjcAj5vH7gfeY399u/ox5+y6llIr0OoQQ8eH2+vgfP3udf3+2br4vRUQgKjl/pZRVKXUY6ACeARqAXq211zylGSgzvy8DLgCYt/cBBWHu826l1CGl1KHOzs5oXKYQSaV/dAyfP/6bMb15vhe3109dh4z8F7KotHfQWvuATUqpXOAxYHW408w/w43yJ/wL1lrfA9wDsGXLFtluTAjglbpOfnesjYNnu6nvGOSua6v421vWxPUa9ja4AGjoHMTn11gt8sF9IYpqtY/Wuhd4EdgO5CqlAm8u5UCr+X0zUAFg3p4DdEfzOoRIRsdb+7jjvoP89+FWKvLSqSly8Pypjrhfx76GLgA8Xj8Xuofj/vgiOqJR7VNojvhRSqUDu4GTwAvA+83T7gR+Y37/uPkz5u3Pa9lIWIhpfeOp0+Skp7Dnr2/kJx/fygevquBs1xAX+0bidg3DHi9vnu9lR7WRqZXUz8IVjZH/EuAFpdRR4DXgGa31b4G/Bv5CKVWPkdO/zzz/PqDAPP4XwJeicA1CJLX9jS5ePN3Jn92wnJyMFAC2mwF4n5mGiYfXzvXg9Wvu2LEMgLqOgbg9toiuiHP+WuujwOYwxxuBrWGOjwJ/GOnjCrFYaK3519+fojjbzp07KoPH1yzJJic9hX0NLt53RXlcrmVvQxcpVsUNKwtZkpNGfXvyjfyH3F7e9s0X+df3b+CGlUXzfTkxIyt8hUhwz57s4I3zvXxh9wrSU63B4xaLYnt1fnACNh72NbjYXJFHRqqNmiJHUqZ9WntH6Bhwx/UT1XyQ4C9EAvP6/HzjqVNUOzP5wysnju6vXu6kpXckLhOvfSNjHGvpY8dyI91UW5RFfccg/nkoN42lnuExAM60J3dKS4K/EAns3j1nOdM+yP+8aSU268T/roFAHI9R6sGz3fg1XB0I/sUORsZ8tPTGb8I5HrqHPEDyT2ZL8BciQdV3DPKtZ87wjjXF3LyuJOw5tUUOnI5U9prll7G0t6ELu83CpqW5wccOXGcy6R02gn9zzwjDHu80Zy9cEvyFSEA+v+aLjxwhPcXKP713HZN1QFFKsb26gH2NLmJdMb2vwcVVlfnYbca8Q40Z/JOt4ieQ9gFo6BiaxyuJLQn+QiSgn7x6ljfO9/J3t62hKCttynOvXu6kvd/N2a7YBaoz7QOcahtgZ60zeCw3I5XCLDt1SVbxExj5w8S8/566LppcyfGGIMFfiATTMTDKN58+ze7VRbxnU9m05wfy/rGs+rn3lUbSUix8YEvFuOO1SVjx0z3kwemwk2JV456b2+vjkw+8xg9fapjHq4seCf5CJJgTrf2Mjvm5+7rlk6Z7QlUWZLAkJ419jbEJ/h0Do/z6zVbef2U5eZmp426rLXJQ3zEY85RTPPUMj+F0pFLtdFAfktI6fL6X0TE//SPJMQ8gwV+IBHOxbxSAsrz0GZ0fyPsfCJP3f+5ke8Stl//fvibG/H7uurZ6wm01xVkMur209Y9G9BiJpHfYQ15GKjXFDs6EpLQCb66Dbgn+QogYaO0dwaKgOMs+49/ZVpVP16CHhs7x+ejvv9jAf7xQh9fnn9O1jHh8/Gx/E7tXF1PlzJxwe6DiJ5ny/j3DHvIyU6gtcnChZ5gRjw+4VE4rwV8IEROtvaOUZKeFreufzDazz8+Bs5dSP30jYxy+0MuYT3N+jovAfvVGMz3DY3zy2qqwtweD/zR5/1fqOvnMz99YEAvCeobHyMtIZUVxFlobratHx3y8eb4XMNo/JAMJ/kIkmNbeEZbkzizlE1BZkEFxtp39jZe6o+9rcAU3e5lLLb7fr/nxnrNsKM9ha1V+2HMKHHbyM1PH5cbDee5kB789epEzCV4W6vfrYNondB3DG009eHx+8jNTZeQvhIiN1r4RSmcZ/JVSbKsan/d/ua6T9BSjJv/ydNBMHGrqobFriI9fUznlxHNN0fjceDiBttOJ3i9nYNSLX0NuRgrLCjKxWRRn2gfY3+jCouD6FYUS/IUQ0ef3ay72jVKaM3VtfzjbqvPpGDDq/bXWvHymk2trnRRl2SeM/PfWd7H7Wy/RPzo2yb3BE0dbSUux8I414VcXB9QWOahrH5iy4qet3w0kfvDvMWv88zJSSbVZqHRmUtcxyL5GF+vLcijJSYtr2mdfg2vcuoNokuAvRAJxDXnweP2zHvnDpf7+B8520+QaprlnhOtqndQUOajvHB/8nz7RTn3HIHvrwwdjn1/z5LE2blxVRKZ96s7vtUUO+ke9dA64Jz2nzRz5HzjbndB5/24z0OabJa0rih0ca+nj8IVeti8vwGG3MebTuL2+mF+Lx+vnjvsO8H8jrNaajAR/IRJIID2yZA4j/2pnJk6HnQONLl6u6wRgZ20hNUUOGi6rxT98wZi83FPfGfa+Dpx10Tng5t3rS6d93NriLGDySV+vz0/ngJuK/HT6RsY4cbF/Vs8rngKj7Fxzw5yaoiwu9o0y5tPsqDaCP8CQO/bBv2vQjdeveaUu/GsUKQn+QiSQVrND5lxG/koptlXns7+xm5fPdLI0P4NKZyY1RQ4G3V7azdSL2+vjRKsRgF+dZOT/xNGLpKdYuXHV9JuZ1BYbE6OTtUDuHHTj1/Bec7Xy/hgtRouGniEjDZaXYYz8A5O+Noviqsr84KegwdHYp34Cn6QaOmOzVacEfyESSGuvucBrDsEfYHtVPm39o7x0pjPYh6emcHz3zVMXB/D4/FxVmcfZriGae8aXgXp9fn5/rI1dq4vGbR4zmUKHnZz0lElH/m3morWNFblUOTMnzfufvNjPlx97a9rKoVgKzfkDrDA/1WwozyHTbsNhN/4+4jHp2zV4KY32Sl30u7ZK8BcigbT2jpCWYgmmHWYrkPcf82muW1EIwHJz9Npg5v2PNBspn0+/rQaAV+vHB5Z9jS5cQx5u2TB9ygeMTxy1RY5Jt3QMBP+SnDS2Vxdw8Gz3uEVnA6Nj/MN/n+CW7+7hwQPned/3987bp4Pe4TEsCrLSjBF+pTODLLstuJ2jw268LkNxaPUcGPmn2iwTXqNokOAvRAIJlHnOpKdPODVFDgoyU7FaVLDhW1GWnSy7LTjyP3yhl8IsO9evKKQoy86ey1I/Txy9SGaqlRtWFs74cWuLHZzpCF/xE2j9UJKdxo7lBQy4vRw3006HL/Sy699e4id7z/JHV1Xw289eS1F2Gnfcd4Bfv9kyp7+DSHSbNf4Wi/H3b7dZeeYvrudPr18OQGZg5B/HtM/u1UW8Wt8V9YlyCf5CJJDW3lFKc+aW8gFjFH7rxlJuWltMdlpK8NhyswEbGAF3Y3kuSimurXGOCyxjPj+/P97G29cUk5YyfconoLYoi97hMboGJ5YltvWNkmq1kJ+ZyvZqY7HYvkYXR5t7ueO+A6SlWHnsU9fwtfeuZ11ZDr/606u5clkeX/jl4ZhNdk6md9gz4VNXSU4aqTYjVAYmfOOV9slJT+FtK4voGvRwqi266TAJ/kIkkNbeEUpzZ1/pE+rvblvL9z985bhjgXLPvpExGjuH2FSRA8A1NU66hzycbDNG4j94sYHe4TFun0Er6VCBSd9wG7u09Y9SnGNHKUVRVho1RQ4ee6OFO+47SE56Cr+4ezubKnKD5+dkpPCTj21FKTh0rmdW1xGpnqGxYL4/HEdaoNonDiP/QTeFWXZ21hqfwCarzJorCf5CJAiP10/noJslEYz8J1NT5KBzwB3MHW80g+215qTwnrouXj7TybefPcN7N5fNKuUDxsgfwreRuNg3ypLsS89pR3UBp9sHcNht/OJPtoed3E5PtVKSnRaXjelD9Qx7yJ0i+GfGceTfOeDG6UilJMd4w7w8PRepiIO/UqpCKfWCUuqkUuq4Uurz5vF8pdQzSqk6888887hSSn1HKVWvlDqqlLoi0msQIhm094+i9dwrfaYSqPh59I1mADaUGcG/ODuN2iIHjx9p5fMPvcnK4iy+9t71s55zKM425hXCdfds7x+lOGTdwh9dVcHOWie/+JPtVORnTHqfFXkZXOiJf/DPz5x8sj0zNZ5pHw+F5i5u19Y4OXjWxehY9NYXRGPk7wX+Umu9GtgOfFoptQb4EvCc1roWeM78GeCdQK35dTfwgyhcgxALXksENf7TCey3+8LpTqqdmeSE5LWvrXVyvLUfr0/zg49cOaPyzssppYxJ38tq/bU22lWELlpbV5bDz+7axtKCyQM/QEV+Bhe6o1/fPhmtdbCj52SsFkVGqjU+aZ8BN4UOo633zlono2N+3miKXhos4uCvtb6otX7D/H4AOAmUAbcD95un3Q+8x/z+duABbdgP5CqllkR6HUIsdMHVvRHm/MMpz0sn1WrB59fBlE/A21cXY7UovvmBjWF79s9UbVHWhLRP7/AYHq+f4uzZP6eK/HTaB0ajOtqdysiYD4/XP2XaB4zUT6xH/sMeL4NuL84s41q2VRdgsyj2RLHkM6o5f6VUJbAZOAAUa60vgvEGAQSWCpYBF0J+rdk8dvl93a2UOqSUOtTZGd8ZfyHmQ2CBVyTVPpOxWS3BwL6xPGfcbVfXODnylXdw09qpG7hNp7bYgWvIgytkcVJgV7K5tKuoyMtA60ufiGKtZziwunfqNRYOu43BGLd36BowqqYCI3+H3UaVMzO4ViMaohb8lVIO4FfAF7TWUzXvCJdMnFDAqrW+R2u9RWu9pbBwdpNPQixErb0j5GWkzCntMhOB1M/lI3+4VMIYjfsPHf23mzX+cxn5B9JC8Zr07RkK9PWZeuTvsNtinvbpNN9AC0N2cyvLSw8OEKIhKsFfKZWCEfgf1Fo/ah5uD6RzzD87zOPNQEXIr5cDrdG4DiEWMqPMM/qj/oDNS3PJzUhhTWl2TO4/0ODtTEjwj3TkD3ChJ14j//EdPSeTabdGdZGX36/59ZsteLyXVj0HFng5HZeCf2luelQ/BUWj2kcB9wEntdbfCrnpceBO8/s7gd+EHP+oWfWzHegLpIeEWMxae0djUuYZ8LGrK3npr96G3RabTxalOWlkplqpD5n0besfRanxI9iZKsqyk2qz0Byvkf+s0j7RC/576rv4wi8P89TxtuCxwMi/KHTkn5tO95AnuKdwpKIx8r8GuAO4USl12Px6F/B14O1KqTrg7ebPAE8CjUA98CPgU1G4BiEWvNa+EcpiMNkbYLNaxlX5RJtSipriLE6HBv++EQoddlJmsR9xgMWiKM9Ln/P+w7N1qZ3zDNI+Ueztc/CssfVmaKVU14AbpcZ/CgmUAEdr9B9xok9rvYfweXyAXWHO18CnI31cIZLJwOgYA6PemKZ94mFrZR4/3XvObJOQSlu/m5I5pHwC4lnrH2jnPF1TvUy7Lappn3DBv3PQTX5GKraQN82yPOPfRmvvSHB+JRKywleIBBDMjS/w4H/bxjLGfJrfHTNSGG19I5TMYbI3oCI/PW61/j3DHrLSbNN+Solm2sft9XHY7LIaukCuc8A9IVVWGuWRvwR/IRJAcIFXBKPkRLCuLJtqZyaPHzZqONr6RiMa+S/Nz6BvZIy+kcn3Go6WHrOj53Qy7TbcXj9jIW2p5+pocx8er59VJVmccw0F1zR0DU4M/sVZdqwWFdzwJ1IS/IVIAB0RlEQmEqUUt20qZf9ZF2e7hugf9Uac9oH4lHsaq3unnxO5tJVj5KP/QMrnj7ctxa+hsXMICPT1GR/8bVYLJdlptESp+kmCvxAJoKN/Yl33QnXbxlK0hntfaQSIMO1jBP/LdxuLhd5pmroFRLOt88Gz3awodrC1ymh1XWfuiRAu7QNQmpsmaR8hkknHgJvcjJRZ9dBPVNWFDtaX5fDI60YTuYhG/vmBkX/s8/7dQ54Zjfwzo7SJu8+veb2ph6sq86lyZmK1KOraBxl0e3F7/cHVvaHKoljrL8FfiATQ3j86rqZ7obt9Uyluc9FSJCP/nPQUstNscan46R0eI2+aBV5wqaf/oDuyeYiTF/sZdHvZWpWP3WalsiCDM+0DlxZ4ZU28ltLcdNr6RvFFYVcvCf5CJICOATdFWQs73x/qlg2lBLpCRzLyB2P0H+taf4/Xz6DbO6MJ30ubuEc28g/k+wMpnxXFWdR1DAaDf6Fj4t9bWV46Xr+mYyDyNg8S/IVIAJ0D7qQa+ZfkpLGtKp+c9BQyUiNbTlSRlxHzCd/eEWOB1+zSPpHl/A+e7aY8Lz24qru2yEGTayiY1gmf879U6x+pyLs5CSEiorUxkita4JU+l/uH29dx3hV50F5akMELpzvQWs95Y/vpXFrgNYsJ3wgWemmtee1cN9eH7JhWW5yFX8P+RmPHLqdj4rWUm8G/uWeEK5fN+eEBCf5CzLue4THGfDqpRv5gpDFWmM3eIlGRl47b6zc+HcXoDdI1ZKRaCmaS849CtU9j1xCuIQ9bK/ODxwJ/V3sbXFgtKmwK6tLIX9I+Qix4gfxtUXZyBf9oKTcrfmKZ9w/k2WfyGkQj7XPkgrGq94plecFjgYqf5p4RnI5ULJaJn3Iy7TZyM1Jo6Y3870KCvxDzLFDjn0wTvtG0NFDuGcOKn+Ak6wxegxSrBbvNMunI/9E3mvnk/a/x1PE2vJOsAj7dPkBqyAY7AKk2C5XmHgaXL/AKVZoTnb7+kvYRYp51mIGnWEb+YZXlpqMUnOuKbfBPtVnITptZSJysv8+wx8s/PXGS3mEPz57soDQnjc/uquVDW5eOO+9M2wDVhZkT+gitKM6ioXNoysV+ZXnpUZlLkZG/EPMssNuVjPzDS0uxUlPo4FhLX8weo8PcLH2mE8qZk+zm9fMD5+ke8vDQ3Tv44UeupDDLzt88+lZwl7CAM+2DrCyZOB8S2BBnqpF/WW56VKp9JPgLMc86B9xk2W0x274xGWwoz+VIcx9GR/joMyaTZ/7JK9zIf3TMx3++3MjVywvYWpXPzetK+OLNqwA4GvLGNTA6RkvvSNjJ8BXFRqvmKUf+uekMuL30j0a2yEyCvxDzrGNglEJJ+UxpU0UOXYNuWvuit4dtqE5z5D9T4YL/w4cu0Dng5rM31gaPrSvLAeAts20zGKN+gJVhg79xbKprCbZ2jrDBmwR/IeZZR7+bYkn5TGlDubHp/NELvdOcOTedYVooTyXTbh3X28fj9fPDFxvYsiyP7dWXyjdz0lOodmZypPnSyD+waUvYtE+Rg6/cuobbNpVO+tihm7pEQoK/EPOsfWBUyjynsWpJFilWFdz4JJo8Xj/dQ55ZBX9HWsq4kf+jbzTT2jfKZ3fVTpg32FCew9GQ6z7dNkBGqjW4LWMopRQfv6Zq6mofc6vPSBu8SfAXIo4ee7OZ3d96KVgCqLWmoz+5WjvEgt1mZc2SbI5eiP6kb2CB12wm3B1267jg/9ibLawqyeK6WueEczeU59Le7w5O7J9pH6C2OCtsHf9MODONje0l+AuxgBy50Ed9x2Bwk/P+UaN9r1T6TG9DeS5vtfThj0JHy1CXavxnkfZJvVTt4/drjrX0sa0qP2y10MYKI+8fWNh1pn2AlcVz34PXYlGU5qTxxNGLfPuZM+yp6wruADar+5nzFQghZs1llvwdNgNBp6zunbGNFbkMur00dg1Of/IszCX4O9JsDHt8+Pyaxq4hhjy+4OTu5dYsycFqUbzV0kfXoJuuQU/EbS/+7Ibl5KSn8N3n6/jIfQd457+/EtwNLuCelxumvA8J/kLEUbeZYjh83gj+7bK6d8Y2lhvB9XCUUz+BRXazSb0Ft3L0eIPrD9aXhw/+6alWaoscHGnum3Kydzb+6KqlPPG5nRz+yjv4/oevoL1/lDvuOxhcT/C9F+r52pOnprwPCf5CxJFrcPzIX/r6zFx1oQOH3RZMn0RLYORfEKaL5mRC+/u81dJHWoqFmsLJUzkby3M52tzL6TYz+Eeh4R1AdloK71q/hHs/uoWzriHu/MlBvvnUab7x1Glun6JiCCT4CxFXgbRPfecgA6NjIX19JPhPx2pRrCvLHlc5Ew2d5haadtvMF9llhrR1fqu5jzVLsrFZJw+nGypy6B0e47mTHeRmpER9r+ara5x8/4+v4ERrP//xQj3vu6KMb31g05S/E5Xgr5T6sVKqQyl1LORYvlLqGaVUnflnnnlcKaW+o5SqV0odVUpdEY1rECLR+f2aniEP68ty0BqONvfRMeAmI9UaTCOIqW0sz+XExX7c3sh20QrVMTD7LTSzzNerf9TL8dY+1k+S7w/YaK5TeLWhixXFWTHZl2D3mmLu+eiV/NU7VvCN92/EOk01UbRG/j8Fbr7s2JeA57TWtcBz5s8A7wRqza+7gR9E6RqEiCutNT96uZF9Da4Znd8/OobXr3nbqiLASP0E9u6N1SYlyWZjRS5jPs2piwNRu8/Ogdkt8IJLI/9jLX1TTvYGrCzJItVmQetLLRxi4cZVxXzmxtppAz9EKfhrrV8Gui87fDtwv/n9/cB7Qo4/oA37gVyl1JJoXIcQ8fTzg+f56pMn+fTP36D7ssZd4QRSPtXOTKqdmbx5vjfp9u6NtQ3mpOqRKKZ+Ogdn19oBjBW+QPCNf7LJ3oAUq4U1S7KB6OX7IxXLnH+x1voigPlnkXm8DLgQcl6zeWwcpdTdSqlDSqlDnZ2dMbxMIWbvWEsff//4CTZV5NI/MsbXnjw57e8E3iAKHKlsqsjl8IVeY9Qpk70zVpabjtNh583z0Qn+Wus57RCWZTf2+j1w1jXtZG9AoFopGrubRcN8TPiG+zwyYdWG1voerfUWrfWWwsLCML8iRHwMjI5x7b88z10/fY3XznXTPzrGpx58g/zMVH78sav4k+uqeeT1ZvY2dE15P4FKn/zMVDYvzaVr0E2Ta0j6+syCUoptVfnsb3RFpcPngNvL6Jh/ziP/nuGxaSd7A3atLqY8L501pdlzutZoi2Xwbw+kc8w/O8zjzUBFyHnlQGsMr0OIiNR1DNLcM8IrdV384Q/38bZvvEhr7wjf+/Bm8jNT+fyuWpbmZ/Dlx45NudLy0j6xdjZVGNv3+bWUec7W9up8LvaNRmVbx7ks8IJLOX9g2snegOtWFLLnr28kKy1lVo8VK7EM/o8Dd5rf3wn8JuT4R82qn+1AXyA9JEQianINAfDIn+3g725dQ35mKl+5dQ1XLjO6N6alWPnqe9dxtmuIe15unPR+us2Rf15mCquWZGG3Gf/9pMxzdrZXFwCwv3FmE+1TmWvwt9sspFiNJMZ0k72JKlqlnr8A9gErlVLNSqm7gK8Db1dK1QFvN38GeBJoBOqBHwGfisY1CBErTa5hlDJytR+7popn/uJ67thROe6cnbWFbKvK59mT7ZPej2vIQ1aaDbvNSorVEgwaMuE7OzVFDpyOVPY3Xl5jMntzWd0LRvopMPoPtJteaKJSXKy1/tAkN+0Kc64GPh2NxxUiHppcw5TmpJOWMvUioHVlOTx4oAmfX4cttXMNeSjIvLSKdFNFLq839cjevbOklGJbdUEw7x9JmexcR/5gNHcbHfOxvDBz+pMTkKzwFWIa51xDLCvImPa8lSVZjI75g2miy3UPuckPCf63bSxlZ62Tivzp71uMt726gIt9ozRFuJF554CbVKuFnPTZ5+Gz0mwznuxNRLKsUIhpNLmGuWltybTnrTKbdZ1uG6A6TOmfa9AzLtBvrMjlZ3dti96FLiI7QvL+lc65j7wDC7zm8unhb29Zs6D3XV6Yb1lCxEnfyBjdQ54Zjfxri7KwKDjVFn716eVpHzF3ywszcTrsEU/6dgyM4pzjhPs1NU6uWJoX0ePPJwn+QkzhvJlWqJxB8E9PtVJZkBns3BhKa6OvT74E/6hQSrG9Op/9jd0R1fvPduP2ZCLBX4gpnDPz98sKZpZaWFmSFdylK1T/iBevX0vwj6Lt1QW09UeW9+8adC/adRYS/IUwuQbd/OvvT41bqBVYSDSTtA8Ywf+ca4gRz/jFXl3mAq+pNuYWs7NjeWT1/l6fH9eQR0b+Qix233rmDN9/sYEXTnUEj53rGqIoy05G6sxqI1aVZKE11HWMH/0H+vrIyD96qp2ZFGbZ+effneIDP9zHX/zyMM+cmHydxeVcQx60nluZZzKQ4C8ERm7/l68Z/Qb31F/q0dPkGqZyhikfgJUlRt+Wy1sOh/b1EdGhlOKr71nHrtVGz8hnTrTz1SdOzPj3O+e4wCtZSKmnEMC/P1eH1aJYW5bD3pD+/OdcQ1y/YuaNBZfmZ5CWYplQ8RMY+UvaJ7resbaEd5hluP/29Gm+/2IDbq9vRrtytfUZW2jKyF+IRaq+Y4DH3mzmozuWcdvGUs52DdHcM8ywx0vHgHtWdeRWi2JlcRan2/vHHXcNGqPMvMzEaOqVjKoLM/H5dbBCazqn2ozXaHlR7DZXSWQS/MWi9+1n60hPsfKn1y/n2honAHvrXcEqkplO9gasLMmaUO7pGvKQZbfNap9YMTvVTiOIN3SGX2F9uWMt/VQ5M8lOkC6b8SbBXyxqJy/288TRi0pRPyoAACAASURBVHzi2ioKHHZWFDtwOuy82tAVbNOwLH92K0hXlmTTNeihyxztg5H2yXdIvj+Wqs0eO41dg+OOj/n8wfx+qLda+libIL3154MEf7GoPW9W9nzimirAmES8pqaAV+tdnDNH/ktnOfIPbfMQ4Bpyy+reGMtKS6Eoy07jZSP/e15u5MZvvsiwxxs81jPkoaV3ZMG2Y44GCf5iUatrH6AsN528kMB8TY2TrkE3z5xoJz8zddZNv1aawf/kxUt5f9egh/zMxTmxGE/VhZk0dI4f+R84282A28uhcz3BY8dbjddmXeniDf5S7ZOkfvfWRV4714MzKxWnw87WyvyIGmAlq7qOQWoum/C7xsz7v97Uw+als+/V7nTYcTpSx438u4c8bFygfd8XkupCB08cvRhs9ay15qi52furDV1cZ1ZuHWvtA1jUaR8J/knqX35/iqbuYQJtT9aWZvPE53bO70UlGJ9fU98xGOwQGVCWm06VM5OzXUOzqvEPtXpJNm+c7wn2nZGcf3wsL3QEm/EVOOyc7x6md3gMgH0hJbzHWvomfOJbbCTtk4S8Pj/NPSP82fXLOfEPN/GR7Uup6xjE5498w+tk0tIzgtvrp7Z4Yqnf1WbrgNlW+gS8e/0SGjqHeO1cT7Cvj+T8Y+/SpK+R9z/SbIzw376mmGMtffSZbwTHWvpmvPduspLgn4Qu9o3i9WuW5meQkWpjbWkOHq+f1t6R+b60hBJowVBTlDXhtkDJ51yD/+2byshOs/HAvnOXNm6XkX/MLTfLPRvNvP+RC73YbRY+fnUlfg37z7roHx3jnGuYdWWLN+UDEvyTUqAZWaBKZXlhoP55cNLfWYzqOoy/j8tz/gA3ri7iz3evYPfq4jndd3qqlQ9sqeD3x9o4abZ6kAnf2CvLSyfVZgnW+h9t7mVtaTZbKvNJS7Gwr8HFCXOyd62M/EWyCQZ/c9eowEfhmS5+WSzq2gcpzraHreax26x8fnctWREsAPrI9mV4/ZrvvVAPIGmfOLBaFFUFmTR2DuL1+TnW0s/GilxSbRauqsxnb0MXx1qMVNBirvQBCf5J6Xz3MClWxZKcdMAIOjnpKcGPwsJQ3zFAbZiUT7RUOjO5YWUhJ8yST0n7xEd1YSaNnUPUdQwyMuYLVlldU+PkTPsgL57upDjbvmh7+gRI8E9C513DlOdlYLUY+5IqpYL/IYRBax22zDPaPrpjWfB76egZH9WFmZzvHub1JqOuf0O5McIPTOLvqe9a9KN+kOCflM53DwdTPgHVTofk/EO09o0y7PGFrfSJputXFFGRn45D+vrETbXTgdev+e3RVrLTbMFy3bWlOWSnGdXti3llb8C8BX+l1M1KqdNKqXql1Jfm6zqSUZNraELwX16USceAm4HRsXm6qsRyxtxqMZZpHzBy0F+5ZS3/47rqmD6OuCTQpXN/YzcbynOxmJ+ArRbFdnNNhwT/eQr+Sikr8D3gncAa4ENKqTXzcS3Jpm94jP5Rb9iRP8DZLkn9ANS3G5+CauPQznf3mmI+u6s25o8jDIECB7iU8gm4cVURKVbFxnIJ/vM18t8K1GutG7XWHuAh4PZ5upak0tRtBPfLm5HVFAUqfiT1A0aNv9NhX9QrPJNVdlpKcNOcjRXjW2p8YEsFL/zVDRRlp83HpSWU+Qr+ZcCFkJ+bzWNBSqm7lVKHlFKHOjs743pxC9nlZZ4BS/MzsVqUTPqa6joG4zLqF/MjMPq/vJ+SxaIoz5vbwr1kM1/BX4U5Nq73gNb6Hq31Fq31lsLCmW+jt9gFNiC5PPin2ixU5KVL8Meo9KlvH4z5ZK+YP5srcql2ZlKSIyP8ycxXY7dmoCLk53KgdZ6uJalc6B7G6Ugl0z7xpV1eKBU/AO39bgbcXhn5J7G/ummlzLNMY75G/q8BtUqpKqVUKvBB4PF5upakEq7MM6C60OhUudgbvE3V00ckhxSrBUeYAZC4ZF6Cv9baC3wGeAo4CTystT4+H9eSbJpcUwV/B25p8EZdoNJH0j5iEZu3t0at9ZPAk/P1+MnI4/VzsW+EpQXlYW8PbfBWMckbxGJwvnuYLLtNeu2IRU1W+CaRlt4R/HriZG9AsNf5Ip/0be4ZoSwvHaXC1R0IsThI8E8igTLPyXrQBxq8LfZJ35beEcpy0+f7MoSYVxL8k8h5l7nAa5KRvzR4M7T0DFMqwV8schL8k8j57mHsNguFjslb1dYWOTje2rdoe/wMjBrtL8ryJPiLxU2CfxIJlHkGGlmF8+Fty+gf9fKDFxvieGWJo7V3FEDSPmLRk+CfJLqHPJxuG5g05ROwsSKX92wq5d49Z2nuGY7T1SWOll7jOcvIXyx2EvwXuCbXEP/7129x9def45xrmF0z2HP2f968CgV846nTsb/ABNPSY6xxKJeRv1jkFtwSOLfXJ5timIbcXm797h5Gx/y8Z3Mpn9xZzYri6VetluWm88mdVXzvhQY+fk0Vmy7rfJjMmntHSLVagl0fhVisFtTI/1hLH+u/8jSv1ndF/b4XYsuDF0930j/q5acfv4p/ff/GGQX+gD+7oQanI5WvPXEyhleYeFp6RliSmzblvIgQi8GCCv4/fKkBj8/Pz/Y1TbhN67kH74cOnmf7Pz/HuQW20cnvj7dRkJnKNnN3otlw2G18cmc1B891L6p2D61S4y8EsICCf3PPML871kaW3cZzp9rpHvIEb+sfHWPXv73Ej15unNN9H23po3PAzV33v0bfyMIogXR7fbxwqoPdq4uDG7XP1rU1TgBeO9cdzUtLaLLASwjDggn+9+89B8B3PrSZMZ/m12+2BG/7yZ5zNHYN8Y2nTs9p9Wp73yi5GSk0uYb57C/exOvzT3m+1poHDzTx30daudg3P6PmvQ0uBt1ebl5XMuf7WL0kG4fdxsGziyP4e7x+OgbcUukjBAsk+Pu15qGDF3j3+iW8bVUR68ty+K/XmwFjz9p79zSyo7oAe4qFv/31sVmngNoHRtlckcs/vmcdL5/p5GtPnpry/INnu/nyY8f47C/eZMc/P881X3+eV+riu9vYU8facNhtXF0z+5RPgNWiuGJZ3qIZ+V/sG0FrZHWvECyQ4N895GHA7eWTO6sA+MCWck5e7OdYSx/37WlkYNTL/7l1DX998yr2Nrj49eGWae5xvLY+NyU5aXxo61I+fk0lP371LP99ZPK9ZR4/0kp6ipVH/nQH/+eWNQy6vTz6xuweMxI+v+aZE+28bVVRxJVPWyvzONM+SE9IGi1ZSZmnEJcsiODfNehha2U+G8z9OG/bWEaqzcKPXmnkx6+e493rl7B6STZ/vHUpm5fm8k+/PUnv8MyC2ZjPj2vITVGWsd3b/3rXajYvzeV/PfoW510TF0GN+fw8+dZFdq8pZktlPp+4toptVfm8eb4nek94GofOdeMa8nDT2ulr+qdzVWW+cZ9N8bv++dJiTmxL2keIBRL8x3x+7jJH/QA5GSm8Y00xvzncypDHy+d3G9u1WSyKr713Pb0jY3z9d1OnbgI6BtxoTXCvzxSrhe98cDMo+OxDb+Lxjs//76nromd4jNs3lgaPbV6axznXcNxGz08dbyfVZuGGlUUR39fGilxSrZZFkfpp6R1BKViSI8FfiAUR/Mty09l92crVD2wxtgC+dUPpuPr21UuyuevaKh567cKMAlpbn9HrpST70kbPFfkZ/MsfbODIhV7+7enxq2B/c7iFnPQUrltxaVP5wCKpwxd6Z/nMZk9rzVPH29hZ44zKNnVpKVY2lOcsiknflp4RirLspNoWxD97IWJqQfwvyM9MnVDOeG2Nk//97tV8+d2rJ5z/hd21lOWm8+XH3powcr9cR78R/ItDgj/Au9Yv4cPblvKfLzcG8/8jHh9Pn2jnXetLxgWQDeU5WBRxSf28dKaTlt4R3rl+SdTu86qqfI619DHs8UbtPhNRS++ITPYKYVoQwT8ci0XxyZ3VE4I2QEaqjX+4fS1n2gf50StT1/63mcE/kPYJ9be3rOGqyjz+8uEj7K3v4tmT7Qx7fNwakvIByLTbWFmSzZsxHvlrrfm3p89QnpfObZddQyS2Vubj9WsOn4/9J5f5JDX+QlyyYIP/dHatLuad60r4znN1NLkmX7nb1j9KqtVCXkbKhNvSUqzc+9GrqHRmcPfPXueelxspzrazrWpieeWmilwOX+jFH8M2EU+faOetlj4+t6s2qqmLK5bloRQcTOK8v9+vudg7KpO9QpiSNvgDfOXWtaRYLfzzFHX77X2jFGXbJ93PNScjhZ9+fCsOu423Wvq4ZUNp2BW1m5fmMjDqpbErNlsk+v2abz19hipnJu/bXBbV+85JT2F1SXZST/p2Dbrx+PxS5imEKamDf0lOGh/evpRnTrYHc/uXa+sfHTfZG05pbjr3f2Ir168o5I7ty8Kec8VSY9L3zRilTp546yKn2wf4wu5abNbov2xbq/J5o6mXsWlWNy9UzVLmKcQ4SR38AT541VJ8fh1cEXy59n43xWHy/ZdbWZLF/Z/YSqUzM+zt1U4HWWm2mOT9vT4/3372DCuKHdy6IXq5/lDbqvIZGfNxJA4VS7H0xUeO8NEfH5zwPAILvGTCVwhD0gf/Kmcm26vzeei18xPy8Vpr2mcw8p8Ji0WxqSI3JiP/I819NHYO8akbamLWivjq5U4sCl4+E982FdFU3zHAw4ea2Vvfxe3fe5VPPfg6e+u7qO8YpK7DSMfJhK8QhoiCv1LqD5VSx5VSfqXUlstu+xulVL1S6rRS6qaQ4zebx+qVUl+K5PFn6kNbl3Khe4S9Da5xxwfcXoY9vqgEf4DNFbmcbuuPeslkYMJ6fXlOVO83VE5GCpsqcnm5Lvp7JcTLA/uaSLVaeP4vb+Dzu2p56XQnf3zvAXZ/6yW+81wdOekpZKVNnNgXYjGKdJXQMeB9wH+GHlRKrQE+CKwFSoFnlVIrzJu/B7wdaAZeU0o9rrU+EeF1TOmmtSXkZqTwi9fOc22tM3i83VzgVZQdnV2dNi/Nw6/haHMf2+fQY38yTa5hlILyGOerd9YW8t3n6+gd9pCbkRrTx4q2gdExfvV6M7dsXMLSggz+/O0r+NjVlRxv7cc15MY16KGqMHzKTojFKKLgr7U+CYSrlLkdeEhr7QbOKqXqga3mbfVa60bz9x4yz41p8E9LsfLezWX8v/1NuAbdFJhb+AVr/KM08t9orvR99I1mqpyZYdcgzMWF7mGWZKfFfPvK61Y4+ffn6ni13sW7N0RvEVk8/Or1ZoY8Pj52dWXwWF5m6rg3eyHEJbHK+ZcBF0J+bjaPTXZ8AqXU3UqpQ0qpQ52dkeehP7R1KWM+zWMh+wAEWzvMYMJ3JvIzU7lxVREPH2pm29ee493feYWnjrdFfL9N3cMsLciIwhVObWN5Lllptri3p46U3695YF8Tmypyg83/hBBTmzb4K6WeVUodC/N1+1S/FuaYnuL4xINa36O13qK13lJYWBjulFlZUZzFFUtzeSSk6qdjwA1MbO0Qifvu3MLvv7CTL968kvZ+N/e9cjbi+2xyDbMsP/YpC5vVwjXLnbx8pjOibTHjbU99F41dQ+NG/UKIqU2b9tFa757D/TYDFSE/lwOBBvmTHY+5m9eV8LUnT3Gxb4QlOem0mTt4paVEL52ilGJVSTarSrKpax+MuGHasMdL16A7LiN/gOtWFPL74200dA5RU+SIy2NG6oF953A6Unnn+rnvaibEYhOrtM/jwAeVUnalVBVQCxwEXgNqlVJVSqlUjEnhx2N0DRO8zWyB/OJpI60xkwVekajIS+di30hEC6fOdxt7CizNj0/w32nmyBdSyeeBs93ctLYk5nMiQiSTSEs936uUagZ2AE8opZ4C0FofBx7GmMj9PfBprbVPa+0FPgM8BZwEHjbPjYuaIgdluem8cKoDgPb+UYpiGPzL8zLwa7jYG3518Uw0mRvKLIvTyL8iP4MqZ+aCyfu7vT4GRr0xfRMXIhlFFPy11o9prcu11natdbHW+qaQ276qtV6utV6ptf5dyPEntdYrzNu+Gsnjz5ZSihtWFvJqfRdur4+2vlFKolTmGU6gNLO5Z+KOYDN1Ic4jf4Drap3sb+zG7fXF5fH8fs25rsmb702l29xAJ1DBJYSYmaRf4Xu5t60sYsjjY39jN12D7piOGMvzjIDdbLYWmIsm1zDZaba41t3fsLKIkTEfL52Oz+j/O8/XsetbLwXf6GbDNRgI/gtrXYIQ823RBf+rawpItVr4r0MX8Gtm1Ndnrkpy0rCoyEb+Td3DLCuI7+KknbVOSrLT+Nn+ppg/Vtegm3tebgxuSj+X3wdwyshfiFlZdME/I9XGtup8nj5uBJpYjvxTbRZKstMiGvlf6B6Oa8oHjJLPP962lFfqujg7x3TMTP3H8/W4vX6Ks+08e3L2wT8w8nfKyF+IWVl0wR+M1I/HrMCJZo1/OOX5GXMO/j6/prknPgu8LvfBrRXYLIoHYzj6v9A9zIMHmvjAlnL+4IpyDpztpm94bFb34RoyRv6S8xdidhZn8F9VFPw+5sE/L33OaZ/W3hHGfJplcR75AxRlpXHzuhIePnSBEU9sJn6//cwZLErx+V0r2L2mGJ9f8+KZjlndh2vQg91mITNVyjyFmI1FGfyrnJksK8ggxaooyIxtuqA8L4OL/aPTbiQfznxU+oS6Y/sy+ke9wQ3so+lUWz+PHW7hY9dUUpKTxqbyXJyOVJ49Obvg3zXowemYfCc2IUR4izL4A7z/inKuXJYXs/74AeV56WgNF/tmn/ppCgT/eUj7gLG718riLB7Yfy7q7R5+fuA8aTYrn7q+BjD2Q7hxVREvnu6Y1Rula8gtlT5CzMGiDf6f3VXLQ3fviPnjXKr1n0Pwdw2TYlUsyZmfDUiUUnxkxzKOtfRHfYeyPXVdbK/OJyfjUn/93auLGRj1zmovYdegJ+af3oRIRos2+MdLRbDWf/Z5/wvdw5TnZYTdMD5e3re5jOw0W1Qa1AW09I7Q2DXEtbXjG/ZdW+vEbrPMquQztEW3EGLmJPjH2JKcNKwWNbeRf/fQvOX7AzLtNj68fRm/O3aR8665r1cItcdsHbHzsl77Gak2rq1x8uzJ9hmlmbTWdA15JO0jxBxI8I8xm3Vutf5aa6OV8zzl+0N97OpKrBbFj1+Nzuj/lbouirPt1IbpGrprdTHNPSM0dE6/vmDQ7cXj9ePMlJG/ELMlwT8OyvPSZ926oG9kjIFR77yP/MEoh71tYxkPH7pA77Anovvy+zV7G1xcU+MMW6GzriwbgHpzw/WpSGsHIeZOgn8clOfNfqFXoJtnIgR/gD+5rophj48HD5yP6H5OXOyne8gzIeUTENi0ZiZvlrLAS4i5k+AfBxX56bQPjM6qS2agNLQsxpu2z9SqkmyuW1HIT/eei6jb5yt1XQBcUxM++OdkpJCdZgvuYzCVrsDIX6p9hJg1Cf5xUJ6XYdT6z6Kvf9+I0eYgnt08p3P3zmo6B9w8dXz2PXgC9tR3sqoki6KsyVdWLy3ImFHwv9TXR0b+QsyWBP84mEutf/+IF4DstGl32oybq5cX4LDbODSLOvxX6jr56atnGR3zMTrm47VzPVw7yag/YGn+TIO/kfbJl5G/ELOWOJElic1lU5e+kTGsFoXDnjgvkcWiWFeWzZHmvhmdP+bz81f/dYT2fjc/fKmRd6wtxuP1c80k+f6ApfmZPHOiHZ9fT7nGwTXkITvNRqpNxjBCzJb8r4mDkmyj1v/CLIN/dpot4XrWbCzP5WRr/4xaMDxzop32fjef31VLSU4aD+xrItVqYVtV/pS/tzQ/gzGfpq1/6jRZ16BbUj5CzFHiDCuTmM1qoTR3drX+/aNjZKenTH9inG0oz8Xj83O6bYD15TlTnvvAvnOU5abzuV21fGF3LU+faGfM5ycjdep/doEKp/OuYcpyJ5/wdg3KAi8h5kpG/nFSnpsxq1r/vpExchIy+BsB/0jz1L1+zrQPsL+xm49sX4bVolBKcdPaEm7ZUDrtYwSDf/fUC71cQ24KZIGXEHMiwT9OyvLSaZ1ltU92WuIF//K8dPIzUzk6TfD/2b4mUm0W/uiqilk/RmmukSabbtJXRv5CzJ0E/zgpzTVq/cd8M2tX3J+gI3+lFOvLcjg6xaTvoNvLo280c8v6JXOqxLFZLZTlpnO+e/I0mc+v6R72yAIvIeZIgn+clOcaff3b+mY2+u8b8SZkzh9gY3kOZ9oHGPZ4w97+2BvNDHl83LFj2ZwfY7pyz55hD1rL3r1CzFVEwV8p9Q2l1Cml1FGl1GNKqdyQ2/5GKVWvlDqtlLop5PjN5rF6pdSXInn8haTUnLhs6Z1+0ldrTf/IGNnpiTkfv6E8F7+G4639YW//1RstrC3NZlNFbtjbZ6Iif+o5kmBfH8n5CzEnkY78nwHWaa03AGeAvwFQSq0BPgisBW4Gvq+UsiqlrMD3gHcCa4APmecmvUCbhpYZVPy4vX48Pn9Cpn0ANlSYk75hNnjx+vycvNjPjuqCiMpUlxVk0D3kYWA0/IbugQVeMvIXYm4iCv5a66e11oHP/vuBcvP724GHtNZurfVZoB7Yan7Va60btdYe4CHz3KS3JMdoZ9A6g5F/oLVDogb/oqw0luSkhc37n3MN4/b6WbUkO6LHuFTxE3703zUU6OgpI38h5iKaOf9PAL8zvy8DLoTc1mwem+z4BEqpu5VSh5RShzo7O6N4mfMjLcWK02GfUdonEPwTsdonYEN5TtiKn9NtAwCsKsmK6P4DwX+y1I+M/IWIzLTBXyn1rFLqWJiv20PO+TLgBR4MHApzV3qK4xMPan2P1nqL1npLYWFhuFMWnLLctBkF//4EH/mDkfc/5xqmb3h8WuZUWz8WBTVhNmqZjYppRv6uQQ82i0roN0ghEtm0M4pa691T3a6UuhO4BdilL+291wyEFniXA63m95MdT3pleemcMkfGU0n0tA8YbR4Ajrb0sjNkL95TbQNUOTNJS7FGdP856SnkZqQE9zW4nGvITX5mKpZ53N9YiIUs0mqfm4G/Bm7TWof+L30c+KBSyq6UqgJqgYPAa0CtUqpKKZWKMSn8eCTXsJCU5qTT2jsy7f60wbRPAgf/QGuHN8+PT/2cbhtgVUlk+f6Aqco9Owekxl+ISESa8/8PIAt4Ril1WCn1QwCt9XHgYeAE8Hvg01prnzk5/BngKeAk8LB57qJQlpfO6Jif7qGpt0JcCGmfnPQU1izJ5tX6ruCxQbeX893DEef7A6Yq93QNuSXfL0QEIiok11rXTHHbV4Gvhjn+JPBkJI+7UAVq/Vt7R6cctfYlYC//cHaucPLjPWcZcnvJtNs4026ktFZGKfgvzc/gqWNtYVs7uwY9LEuQLS6FWIhkhW8clQUXek3ds6ZvZIzMVCs2a2K/PNfVFjLm0xw46wLg1EUj+K+OsMwzYGl+Bl6/nlAe6/b66Bp0S9pHiAgkdnRJMpeC/9QtHvpHE7Ovz+WuXJZHWoqFl88YqZ/Tbf1kplqnbMM8G4GR/cOHLuA1eyJ1D3n4yL0HGPb4uKpy6n0BhBCTS+y8QpLJzUghI9U67SrfvpHE7OV/ubQUK1urCnilzliHcbJtgJUlWVGrwNlSmc/u1UV89/l6njnRzqfeVsM3nzpNe/8o3/3QZm5eVxKVxxFiMZKRfxwppSjNTZ92le9CCf4A19U6aegcoqV3hNNtA6yMUqUPQKrNwo8+uoUffuRK+kbG+Nwv3mTY4+Ohu7dz68bp9wUQQkxORv5xVpabPu1Cr/6RseAip0Rn1Pif5JFDzfSNjLF6SXQmewOUUty8roSdtU4efaOZXauLgxPnQoi5k+AfZ6W56RxrmXoD9P4E3cglnBXFDoqy7Dyw7xwAK4ujG/wDMu027thRGZP7FmIxkrRPnJXnpeMa8jDi8U16TqJu4RiOUoqdtYW4zLUL0VrgJYSILQn+cVaaa3b37Auf+vH6/Ax5fAsm+ANct8IJGJ1LczIWznULsZhJ8I+zslwjlz9ZxU//qLnAK0E3cgnnmhoj+EdrcZcQIvYWToRJEsGR/ySTvguhqdvlnA47f7KziiuX5c33pQghZkiCf5yVZKdhUZNv57gQ+vqE8+V3L4oN2YRIGpL2iTOb1UJJ9uR9/RdCR08hxMInwX8elOWlT5rzX4hpHyHEwiPBfx6U5aZT1zFI54B7wm39oxL8hRCxJ8F/HtyxYxkjHh9/dM8+2vrGN3lbCPv3CiEWPgn+8+DKZfk8cNdWOvrdfOA/99Hcc6nFc/+Il1SrhbQUeWmEELEjEWaeXFWZz8/u2krPsIcP33sAn9/Y2jHQ1E0p2ZtWCBE7Evzn0ealefzdrWtpcg1zorUfMPv6LKAFXkKIhUmC/zzbWWusjt3bYGyIslA2chFCLGwS/OdZUXYaywsz2ddobIW4kJq6CSEWLgn+CeDq5U4Onu1mzOc3cv5S6SOEiDEJ/gng6uUFDHt8HG3uo19G/kKIOJDgnwC2VRcAsLe+i/5RrwR/IUTMSfBPAPmZqaxeks2zJ9vx+bVU+wghYi6i4K+U+kel1FGl1GGl1NNKqVLzuFJKfUcpVW/efkXI79yplKozv+6M9Akkix3VBRxpNrZ3lJG/ECLWIh35f0NrvUFrvQn4LfB/zOPvBGrNr7uBHwAopfKBrwDbgK3AV5RS0gQeI+8fIBO+QohYiyj4a637Q37MBLT5/e3AA9qwH8hVSi0BbgKe0Vp3a617gGeAmyO5hmSxtTofi7moV0b+QohYizjnr5T6qlLqAvBhLo38y4ALIac1m8cmOx7ufu9WSh1SSh3q7OyM9DITXnZaCuvLcozvJfgLIWJs2uCvlHpWKXUszNftAFrrL2utK4AHgc8Efi3MXekpjk88qPU9WustWusthYWFM3s2C9yO5cZqXxn5CyFibdqyEq317hne18+BJzBy+s1ARcht5UCrO6JnTAAABNJJREFUefyGy46/OMP7T3of2b4UizL6/QshRCxFWu1TG/LjbcAp8/vHgY+aVT/bgT6t9UXgKeAdSqk8c6L3HeYxAZTnZfDFm1dhsUhHTyFEbEVaUP51pdRKwA80AX9qHn8SeBdQDwwDHwfQWncrpf4ReM087x+01t0RXoMQQohZiij4a63/YJLjGvj0JLf9GPhxJI8rhBAiMrLCVwghFiEJ/kIIsQhJ8BdCiEVIgr8QQixCEvyFEGIRkuAvhBCLkDKqMhObUmoAOD3f1zEPnEDXfF/EPJDnvbjI846dZVrrsP1xFsquIae11lvm+yLiTSl1SJ734iHPe3GZ7+ctaR8hhFiEJPgLIcQitFCC/z3zfQHzRJ734iLPe3GZ1+e9ICZ8hRBCRNdCGfkLIYSIIgn+QgixCCV88FdK3ayUOq2UqldKfWm+rydWlFIVSqkXlFInlVLHlVKfN4/nK6WeUUrVmX/mzfe1xoJSyqqUelMp9Vvz5yql1AHzef9SKZU639cYbUqpXKXUI0qpU+brvmMxvN5KqT83/40fU0r9QimVloyvt1Lqx0qpDqXUsZBjYV9fc+Or75hx7qhS6opYX19CB3+llBX4HvBOYA3wIaXUmvm9qpjxAn+ptV4NbAc+bT7XLwHPaa1rgefMn5PR54GTIT//C/Bt83n3AHfNy1XF1r8Dv9darwI2Yjz/pH69lVJlwOeALVrrdYAV+CDJ+Xr/FLj5smOTvb7vBGrNr7uBH8T64hI6+ANbgXqtdaPW2gM8BNw+z9cUE1rri1rrN8zvBzACQRnG873fPO1+4D3zc4Wxo5QqB94N3Gv+rIAbgUfMU5LueSulsoHrgPsAtNYerXUvi+D1xlhcmq6UsgEZwEWS8PXWWr8MXL5T4WSv7+3AA9qwH8hVSi2J5fUlevAvAy6E/NxsHktqSqlKYDNwACg29z/G/LNo/q4sZv4v8EWM7UABCoBerbXX/DkZX/dqoBP4iZnuulcplUmSv95a6xbgm8B5jKDfB7xO8r/eAZO9vnGPdYke/MPtZJ7UtalKKQfwK+ALWuv++b6eWFNK3QJ0aK1fDz0c5tRke91twBXAD7TWm4EhkizFE46Z474dqAJKgUyMlMflku31nk7c/80nevBvBipCfi4HWufpWmJOKZWCEfgf1Fo/ah5uD3z8M//smK/ri5FrgNuUUucw0no3YnwSyDXTApCcr3sz0Ky1PmD+/AjGm0Gyv967gbNa606t9RjwKHA1yf96B0z2+sY91iV68H8NqDUrAVIxJoYen+drigkzz30fcFJr/a2Qmx4H7jS/vxP4TbyvLZa01n+jtS7XWldivL7Pa60/DLwAvN88LRmfdxtwQSm10jy0CzhBkr/eGOme7UqpDPPffOB5J/XrHWKy1/dx4KNm1c92oC+QHooZrXVCfwHvAs4ADcCX5/t6Yvg8r8X4mHcUOGx+vQsj//0cUGf+mT/f1xrDv4MbgN+a31cDB4F64L8A+3xfXwye7ybgkPma/xrIWwyvN/D3wCngGPAzwJ6MrzfwC4x5jTGMkf1dk72+GGmf75lx7i2MaqiYXp+0dxBCiEUo0dM+QgghYkCCvxBCLEIS/IUQYhGS4C+EEIuQBH8hhFiEJPgLIcQiJMFfCCEWof8P3Hemzz4xMKIAAAAASUVORK5CYII=\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "cols = ['symbol', 'date', 'expiry_dt', 'strike_pr', 'option_typ',\n", + " 'open', 'high', 'low', 'close']\n", + "res = options.merge(df[cols], on=['date', 'strike_pr', 'option_typ'])\n", + "res['profit'] = res.eval('close-open') # to change in case of selling options\n", + "res['cum_profit'] = res.profit.cumsum()\n", + "res.cum_profit.plot()" + ] } ], "metadata": { From 335278739c3aa6fc2cb689c281f7a866c4a301c2 Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 22:47:32 +0530 Subject: [PATCH 38/53] option prices turned into a function --- notebooks/OptionsBacktesting.ipynb | 171 ++++++++++++++++++++++++++--- 1 file changed, 153 insertions(+), 18 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index ed3207f..75debcf 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -16,12 +16,12 @@ "2. Create a list of option contracts to be entered into each day\n", "3. Create a list of signals, on whether to enter into the contract, for each day\n", "4. Extract the necessary data for the options contracts that would be executed\n", - "5. Analyze Profit and loss and other metrices\n" + "5. Analyze Profit and loss and other metrics\n" ] }, { "cell_type": "code", - "execution_count": 1, + "execution_count": 107, "metadata": {}, "outputs": [], "source": [ @@ -29,7 +29,9 @@ "\n", "import pandas as pd\n", "import numpy as np\n", - "from fastbt.rapid import backtest" + "\n", + "import seaborn as sns\n", + "sns.set()" ] }, { @@ -41,7 +43,7 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": 101, "metadata": {}, "outputs": [], "source": [ @@ -72,7 +74,7 @@ }, { "cell_type": "code", - "execution_count": 3, + "execution_count": 102, "metadata": {}, "outputs": [], "source": [ @@ -91,7 +93,7 @@ }, { "cell_type": "code", - "execution_count": 46, + "execution_count": 103, "metadata": {}, "outputs": [ { @@ -106,7 +108,7 @@ "dtype: datetime64[ns]" ] }, - "execution_count": 46, + "execution_count": 103, "metadata": {}, "output_type": "execute_result" } @@ -138,7 +140,51 @@ }, { "cell_type": "code", - "execution_count": 47, + "execution_count": 116, + "metadata": {}, + "outputs": [], + "source": [ + "def option_prices(prices, opt=[('C',0)], step=100):\n", + " \"\"\"\n", + " Get the list of options for each period\n", + " prices\n", + " prices on which the option prices are to be generated\n", + " series with date as index and price as values\n", + " opt\n", + " list of option type and step as 2-tuples\n", + " * (C,0) mean in-the-money call option\n", + " * (C,1) mean call option next to in-the-money\n", + " * (P,0) mean in-the-money put option\n", + " step\n", + " optional step size for the option\n", + " Note\n", + " -----\n", + " All calculations are done with in-the-money option\n", + " as the reference point. To illustrate, assume a spot price of 10285\n", + " (C,0) -> 10200\n", + " (C,1) -> 10300\n", + " (P,0) -> 10300\n", + " (P,1) -> 10200\n", + " (C,0) with step=50 -> 10250\n", + " (C,1) with step=50 -> 10300\n", + " \"\"\"\n", + " collect = []\n", + " s = prices.reset_index()\n", + " s.columns = ['date', 'spot']\n", + " for opt, strk in opt:\n", + " o = s.copy()\n", + " o['strike_pr'] = [itm(x)+(strk*step) for x in nifty.open]\n", + " if opt == 'C':\n", + " o['option_typ'] = 'CE'\n", + " elif opt == 'P':\n", + " o['option_typ'] = 'PE'\n", + " collect.append(o)\n", + " return pd.concat(collect)" + ] + }, + { + "cell_type": "code", + "execution_count": 104, "metadata": {}, "outputs": [ { @@ -217,7 +263,7 @@ "4 2019-01-07 10800 CE 10804.85" ] }, - "execution_count": 47, + "execution_count": 104, "metadata": {}, "output_type": "execute_result" } @@ -231,6 +277,97 @@ "options.head()" ] }, + { + "cell_type": "code", + "execution_count": 117, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
\n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
datespotstrike_proption_typ
02019-01-0110881.7010800CE
12019-01-0210868.8510800CE
22019-01-0310796.8010700CE
32019-01-0410699.7010600CE
42019-01-0710804.8510800CE
\n", + "
" + ], + "text/plain": [ + " date spot strike_pr option_typ\n", + "0 2019-01-01 10881.70 10800 CE\n", + "1 2019-01-02 10868.85 10800 CE\n", + "2 2019-01-03 10796.80 10700 CE\n", + "3 2019-01-04 10699.70 10600 CE\n", + "4 2019-01-07 10804.85 10800 CE" + ] + }, + "execution_count": 117, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "options = option_prices(nifty.set_index('date').open)\n", + "options.head()" + ] + }, { "cell_type": "markdown", "metadata": {}, @@ -243,7 +380,7 @@ }, { "cell_type": "code", - "execution_count": 48, + "execution_count": 105, "metadata": {}, "outputs": [ { @@ -328,7 +465,7 @@ "4 2019-01-07 10800 CE 10804.85 1" ] }, - "execution_count": 48, + "execution_count": 105, "metadata": {}, "output_type": "execute_result" } @@ -349,29 +486,27 @@ }, { "cell_type": "code", - "execution_count": 57, + "execution_count": 106, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "" + "" ] }, - "execution_count": 57, + "execution_count": 106, "metadata": {}, "output_type": "execute_result" }, { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] }, - "metadata": { - "needs_background": "light" - }, + "metadata": {}, "output_type": "display_data" } ], From cd637425d56a476f368ed6b1c107eff3a2f8b2ef Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 22:56:41 +0530 Subject: [PATCH 39/53] backtest function added --- notebooks/OptionsBacktesting.ipynb | 87 ++++++++++++++++++++++++++++-- 1 file changed, 82 insertions(+), 5 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index 75debcf..0e912c0 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -486,22 +486,22 @@ }, { "cell_type": "code", - "execution_count": 106, + "execution_count": 120, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "" + "" ] }, - "execution_count": 106, + "execution_count": 120, "metadata": {}, "output_type": "execute_result" }, { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -516,7 +516,84 @@ "res = options.merge(df[cols], on=['date', 'strike_pr', 'option_typ'])\n", "res['profit'] = res.eval('close-open') # to change in case of selling options\n", "res['cum_profit'] = res.profit.cumsum()\n", - "res.cum_profit.plot()" + "res.set_index('date').cum_profit.plot()" + ] + }, + { + "cell_type": "code", + "execution_count": 124, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 124, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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ly9XDzzwgMrNzVVKKVVfX6927dp1zle84cid6todd24Hd657O3dpA5kn/z1Wq5Uf//jHZGRksGLFCry9vfnpT3+K3W5n9erVbN26lWnTpvHEE0+wadMmPDw8iIqKAtq+5o2UXju4V127487t4M51b+cObSBj8t+za9cu/v73v6PX64mIiCAqKor58+dTXV3N7t27GTNmDLfccgv5+fk0NTVx2WWXASPnh/197lTX7rhzO7hz3du5Qxu49Zj8nj17iIuL6/hkLikp4f7776ewsJBDhw4RHx9PaGgod955J8XFxcTExABQW1vL9OnTO44zEn7Y7lTX7rhzO7hz3du5Yxu4Zcjn5uZy7733EhERgVarZdmyZVxzzTXExcUxa9YsvvzyS7Zu3crYsWOZPXs2AE888QShoaFkZWUxevRoIiMjh98Flk64U127487t4M51b+fObeBWY/Ktra14eXnx9ttvYzKZuO222/j888/Zvn07MTEx3HXXXR3b/uEPf0Cv17NixQpiY2MpKSmhvLycuro6Fi5c6MRa9Iw71bU77twO7lz3dtIGbjImb7PZeOaZZ3j//ffx8vJi69atKKWYN28e0dHR+Pn5sXnzZlJTUwkLCwMgODiYHTt24OnpySWXXEJgYCBRUVEkJCQ4uTbdc6e6dsed28Gd695O2uA7I2dgqY9qamr4+c9/TlNTEwsWLGDz5s2kpKRQWlpKUVER3t7epKSkMHXqVLZs2dKx38SJE4mPj0en042YxcTcqa7dced2cOe6t5M2OJfLj8nX1NRQU1PDCy+8AEBeXh6HDx8mJSWFd999l//4j/8gODiYyMhI8vLysFgseHh4oNPpuOeee/D09HRyDXrOneraHXduB3eueztpg3O5fE8+ICCApUuXUlFRAUBMTAwGg4FJkyZx8uRJduzYgU6nw8vLi9bWVry9vTtuSR9pP2x3qmt33Lkd3Lnu7aQNzuXyY/L+/v6MGTOmY9ztj3/8I3PnzmXZsmXYbDb++7//m6KiIt566y2uv/56kpOTR+QVdHCvunbHndvBneveTtrgXG41u6awsJBbbrmFLVu2oNfryc/PJz8/H5PJxKRJkzoeY+cK3Kmu3XHndnDnureTNnCDMfnvKyws5IorrqCyspJf/OIXBAUF8fDDDw+b1eIGkjvVtTvu3A7uXPd20gZuFvLHjx/n9ddf71hZbtWqVc4u0qBxp7p2x53bwZ3r3k7awM2Ga9555x3Kysq44447OtaFdlXuVNfuuHM7uHPd20kbuFnIu/LFlfO5U127487t4M51bydt4GYhL4QQ7sbl58kLIYQ7k5AXQggXJiEvhBAuTEJeCCFcmIS8GNF+8pOfUFNTwx133MHp06cH9VyFhYXce++9g3oOIQaaW90MJVzPzp07AfjrX/866OcqKSkhLy9v0M8jxECSKZRixHr44YfZuHEjY8eO5fTp06xfv56mpib+9Kc/ERUVRV5eHr6+vtx5553885//JC8vj8WLF/PII48A8Pnnn/Piiy9itVrx8fFhzZo1TJ06lZycHNatW0draytKKVauXMmNN97I0qVLKS8vJy0tjVdeeYWXXnqJzz77jJaWFpqbm1mzZg2LFi3iueeeo6CggPLyciorK0lNTWXWrFm8++67FBUV8dBDD7F8+XKee+458vPzKSsro7KykpSUFH7/+9+j1+ud3LLCpSghRrCxY8eq6upqtXDhQpWZmam++eYbNW7cOHX06FGllFL//u//rm644QZlsVhUdXW1Sk1NVWVlZSovL08tX75c1dTUKKWUOnnypJo9e7Yym83q4YcfVn/5y1+UUkpVVFSo++67T9ntdvXNN9+oq6++WimlVFFRkbrllltUc3OzUkqpLVu2qOXLlyullHr22WfVwoULVUNDg2publZpaWnqiSeeUEop9cknn6jFixd3bDdv3jxVWVmp7Ha7euCBB9STTz45dI0n3IIM1wiXExsby/jx4wEYNWoUAQEBeHl5ERoair+/P/X19ezdu5eKigpuvfXWjv00Gg0FBQUsWrSINWvWkJmZSXp6Oo8++iha7bmXr2JiYvjjH//I+++/T35+PocPH8ZsNne8f9lllxEQEACA0Whk7ty5HeWpq6vr2G7p0qWEh4cDsHLlSv7whz+wZs2aQWkX4Z7kwqtwOeevUeLhcWFfxuFwkJ6eznvvvdfxZ/369SQnJ7Nw4UI++ugjli1bRnZ2NhkZGZSVlZ2z/9GjR7nhhhswmUzMnj2b22+/vddlADoeVtFepvM/TIToL/mNEiOaTqfDZrP1er/09HR27txJTk4OADt27OCaa66hpaWFBx98kK1bt3L11Vfz61//Gr1eT0FBATqdDqvVCsDevXuZMGECt912GzNnzuSzzz7Dbrf3uhyfffYZjY2NOBwO1q9fz8KFC3t9DCG6I8M1YkRbunQpt9xyyzlDJT2RlJTE7373Ox544AGUUnh4ePDiiy/i7+/PT3/6U9atW8dbb72FTqfjyiuvJC0tjfr6ery9vVm5ciUvvfQSH3/8McuWLcPhcLBw4ULq6+sxmUy9Kkd4eDh33HEHtbW1pKWlcffdd/dqfyEuRmbXCOEkzz33HLW1tTz22GPOLopwYTJcI4QQLkx68kII4cKkJy+EEC5MQl4IIVyYhLwQQrgwCXkhhHBhEvJCCOHC/j9QwbVfMzrbUQAAAABJRU5ErkJggg==\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "# Run a backtest with stop loss and price set\n", + "# pip install fastbt for this to work\n", + "\n", + "from fastbt.rapid import backtest\n", + "df101 = options.merge(df[cols], on=['date', 'strike_pr', 'option_typ'])\n", + "df101['timestamp'] = df101['date']\n", + "results = backtest(data=df101, stop_loss=25, order='B', price='open*1.1')\n", + "results['profit'] = results.eval('sell-buy')\n", + "results.set_index('timestamp').profit.cumsum().plot()" + ] + }, + { + "cell_type": "code", + "execution_count": 126, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 126, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "results = backtest(data=df101, stop_loss=25, order='S', price='open*0.9')\n", + "results['profit'] = results.eval('sell-buy')\n", + "results.set_index('timestamp').profit.cumsum().plot()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's work out a slightly complex option\n" ] } ], From 9e8f63eeb70c800c16b92529d333b46ad1e26efd Mon Sep 17 00:00:00 2001 From: machine Date: Sat, 10 Aug 2019 23:18:44 +0530 Subject: [PATCH 40/53] multi options example added --- notebooks/OptionsBacktesting.ipynb | 145 +++++++++++++++++++++-------- 1 file changed, 104 insertions(+), 41 deletions(-) diff --git a/notebooks/OptionsBacktesting.ipynb b/notebooks/OptionsBacktesting.ipynb index 0e912c0..7deb0a5 100644 --- a/notebooks/OptionsBacktesting.ipynb +++ b/notebooks/OptionsBacktesting.ipynb @@ -21,7 +21,7 @@ }, { "cell_type": "code", - "execution_count": 107, + "execution_count": 1, "metadata": {}, "outputs": [], "source": [ @@ -43,7 +43,7 @@ }, { "cell_type": "code", - "execution_count": 101, + "execution_count": 2, "metadata": {}, "outputs": [], "source": [ @@ -74,7 +74,7 @@ }, { "cell_type": "code", - "execution_count": 102, + "execution_count": 3, "metadata": {}, "outputs": [], "source": [ @@ -93,7 +93,7 @@ }, { "cell_type": "code", - "execution_count": 103, + "execution_count": 4, "metadata": {}, "outputs": [ { @@ -108,7 +108,7 @@ "dtype: datetime64[ns]" ] }, - "execution_count": 103, + "execution_count": 4, "metadata": {}, "output_type": "execute_result" } @@ -140,7 +140,7 @@ }, { "cell_type": "code", - "execution_count": 116, + "execution_count": 5, "metadata": {}, "outputs": [], "source": [ @@ -173,10 +173,11 @@ " s.columns = ['date', 'spot']\n", " for opt, strk in opt:\n", " o = s.copy()\n", - " o['strike_pr'] = [itm(x)+(strk*step) for x in nifty.open]\n", " if opt == 'C':\n", + " o['strike_pr'] = [itm(x, 'C', step)+(strk*step) for x in nifty.open]\n", " o['option_typ'] = 'CE'\n", " elif opt == 'P':\n", + " o['strike_pr'] = [itm(x, 'P', step)-(strk*step) for x in nifty.open]\n", " o['option_typ'] = 'PE'\n", " collect.append(o)\n", " return pd.concat(collect)" @@ -184,7 +185,7 @@ }, { "cell_type": "code", - "execution_count": 104, + "execution_count": 6, "metadata": {}, "outputs": [ { @@ -263,7 +264,7 @@ "4 2019-01-07 10800 CE 10804.85" ] }, - "execution_count": 104, + "execution_count": 6, "metadata": {}, "output_type": "execute_result" } @@ -279,7 +280,7 @@ }, { "cell_type": "code", - "execution_count": 117, + "execution_count": 7, "metadata": {}, "outputs": [ { @@ -358,7 +359,7 @@ "4 2019-01-07 10804.85 10800 CE" ] }, - "execution_count": 117, + "execution_count": 7, "metadata": {}, "output_type": "execute_result" } @@ -380,7 +381,7 @@ }, { "cell_type": "code", - "execution_count": 105, + "execution_count": 8, "metadata": {}, "outputs": [ { @@ -405,9 +406,9 @@ " \n", " \n", " date\n", + " spot\n", " strike_pr\n", " option_typ\n", - " spot\n", " signal\n", " \n", " \n", @@ -415,41 +416,41 @@ " \n", " 0\n", " 2019-01-01\n", + " 10881.70\n", " 10800\n", " CE\n", - " 10881.70\n", " 1\n", " \n", " \n", " 1\n", " 2019-01-02\n", + " 10868.85\n", " 10800\n", " CE\n", - " 10868.85\n", " 1\n", " \n", " \n", " 2\n", " 2019-01-03\n", + " 10796.80\n", " 10700\n", " CE\n", - " 10796.80\n", " 1\n", " \n", " \n", " 3\n", " 2019-01-04\n", + " 10699.70\n", " 10600\n", " CE\n", - " 10699.70\n", " 1\n", " \n", " \n", " 4\n", " 2019-01-07\n", + " 10804.85\n", " 10800\n", " CE\n", - " 10804.85\n", " 1\n", " \n", " \n", @@ -457,15 +458,15 @@ "" ], "text/plain": [ - " date strike_pr option_typ spot signal\n", - "0 2019-01-01 10800 CE 10881.70 1\n", - "1 2019-01-02 10800 CE 10868.85 1\n", - "2 2019-01-03 10700 CE 10796.80 1\n", - "3 2019-01-04 10600 CE 10699.70 1\n", - "4 2019-01-07 10800 CE 10804.85 1" + " date spot strike_pr option_typ signal\n", + "0 2019-01-01 10881.70 10800 CE 1\n", + "1 2019-01-02 10868.85 10800 CE 1\n", + "2 2019-01-03 10796.80 10700 CE 1\n", + "3 2019-01-04 10699.70 10600 CE 1\n", + "4 2019-01-07 10804.85 10800 CE 1" ] }, - "execution_count": 105, + "execution_count": 8, "metadata": {}, "output_type": "execute_result" } @@ -486,27 +487,29 @@ }, { "cell_type": "code", - "execution_count": 120, + "execution_count": 9, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "" + "" ] }, - "execution_count": 120, + "execution_count": 9, "metadata": {}, "output_type": "execute_result" }, { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] }, - "metadata": {}, + "metadata": { + "needs_background": "light" + }, "output_type": "display_data" } ], @@ -521,27 +524,29 @@ }, { "cell_type": "code", - "execution_count": 124, + "execution_count": 10, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "" + "" ] }, - "execution_count": 124, + "execution_count": 10, "metadata": {}, "output_type": "execute_result" }, { "data": { - "image/png": "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ly9XDzzwgMrNzVVKKVVfX6927dp1zle84cid6todd24Hd657O3dpA5kn/z1Wq5Uf//jHZGRksGLFCry9vfnpT3+K3W5n9erVbN26lWnTpvHEE0+wadMmPDw8iIqKAtq+5o2UXju4V127487t4M51b+cObSBj8t+za9cu/v73v6PX64mIiCAqKor58+dTXV3N7t27GTNmDLfccgv5+fk0NTVx2WWXASPnh/197lTX7rhzO7hz3du5Qxu49Zj8nj17iIuL6/hkLikp4f7776ewsJBDhw4RHx9PaGgod955J8XFxcTExABQW1vL9OnTO44zEn7Y7lTX7rhzO7hz3du5Yxu4Zcjn5uZy7733EhERgVarZdmyZVxzzTXExcUxa9YsvvzyS7Zu3crYsWOZPXs2AE888QShoaFkZWUxevRoIiMjh98Flk64U127487t4M51b+fObeBWY/Ktra14eXnx9ttvYzKZuO222/j888/Zvn07MTEx3HXXXR3b/uEPf0Cv17NixQpiY2MpKSmhvLycuro6Fi5c6MRa9Iw71bU77twO7lz3dtIGbjImb7PZeOaZZ3j//ffx8vJi69atKKWYN28e0dHR+Pn5sXnzZlJTUwkLCwMgODiYHTt24OnpySWXXEJgYCBRUVEkJCQ4uTbdc6e6dsed28Gd695O2uA7I2dgqY9qamr4+c9/TlNTEwsWLGDz5s2kpKRQWlpKUVER3t7epKSkMHXqVLZs2dKx38SJE4mPj0en042YxcTcqa7dced2cOe6t5M2OJfLj8nX1NRQU1PDCy+8AEBeXh6HDx8mJSWFd999l//4j/8gODiYyMhI8vLysFgseHh4oNPpuOeee/D09HRyDXrOneraHXduB3eueztpg3O5fE8+ICCApUuXUlFRAUBMTAwGg4FJkyZx8uRJduzYgU6nw8vLi9bWVry9vTtuSR9pP2x3qmt33Lkd3Lnu7aQNzuXyY/L+/v6MGTOmY9ztj3/8I3PnzmXZsmXYbDb++7//m6KiIt566y2uv/56kpOTR+QVdHCvunbHndvBneveTtrgXG41u6awsJBbbrmFLVu2oNfryc/PJz8/H5PJxKRJkzoeY+cK3Kmu3XHndnDnureTNnCDMfnvKyws5IorrqCyspJf/OIXBAUF8fDDDw+b1eIGkjvVtTvu3A7uXPd20gZuFvLHjx/n9ddf71hZbtWqVc4u0qBxp7p2x53bwZ3r3k7awM2Ga9555x3Kysq44447OtaFdlXuVNfuuHM7uHPd20kbuFnIu/LFlfO5U127487t4M51bydt4GYhL4QQ7sbl58kLIYQ7k5AXQggXJiEvhBAuTEJeCCFcmIS8GNF+8pOfUFNTwx133MHp06cH9VyFhYXce++9g3oOIQaaW90MJVzPzp07AfjrX/866OcqKSkhLy9v0M8jxECSKZRixHr44YfZuHEjY8eO5fTp06xfv56mpib+9Kc/ERUVRV5eHr6+vtx5553885//JC8vj8WLF/PII48A8Pnnn/Piiy9itVrx8fFhzZo1TJ06lZycHNatW0draytKKVauXMmNN97I0qVLKS8vJy0tjVdeeYWXXnqJzz77jJaWFpqbm1mzZg2LFi3iueeeo6CggPLyciorK0lNTWXWrFm8++67FBUV8dBDD7F8+XKee+458vPzKSsro7KykpSUFH7/+9+j1+ud3LLCpSghRrCxY8eq6upqtXDhQpWZmam++eYbNW7cOHX06FGllFL//u//rm644QZlsVhUdXW1Sk1NVWVlZSovL08tX75c1dTUKKWUOnnypJo9e7Yym83q4YcfVn/5y1+UUkpVVFSo++67T9ntdvXNN9+oq6++WimlVFFRkbrllltUc3OzUkqpLVu2qOXLlyullHr22WfVwoULVUNDg2publZpaWnqiSeeUEop9cknn6jFixd3bDdv3jxVWVmp7Ha7euCBB9STTz45dI0n3IIM1wiXExsby/jx4wEYNWoUAQEBeHl5ERoair+/P/X19ezdu5eKigpuvfXWjv00Gg0FBQUsWrSINWvWkJmZSXp6Oo8++iha7bmXr2JiYvjjH//I+++/T35+PocPH8ZsNne8f9lllxEQEACA0Whk7ty5HeWpq6vr2G7p0qWEh4cDsHLlSv7whz+wZs2aQWkX4Z7kwqtwOeevUeLhcWFfxuFwkJ6eznvvvdfxZ/369SQnJ7Nw4UI++ugjli1bRnZ2NhkZGZSVlZ2z/9GjR7nhhhswmUzMnj2b22+/vddlADoeVtFepvM/TIToL/mNEiOaTqfDZrP1er/09HR27txJTk4OADt27OCaa66hpaWFBx98kK1bt3L11Vfz61//Gr1eT0FBATqdDqvVCsDevXuZMGECt912GzNnzuSzzz7Dbrf3uhyfffYZjY2NOBwO1q9fz8KFC3t9DCG6I8M1YkRbunQpt9xyyzlDJT2RlJTE7373Ox544AGUUnh4ePDiiy/i7+/PT3/6U9atW8dbb72FTqfjyiuvJC0tjfr6ery9vVm5ciUvvfQSH3/8McuWLcPhcLBw4ULq6+sxmUy9Kkd4eDh33HEHtbW1pKWlcffdd/dqfyEuRmbXCOEkzz33HLW1tTz22GPOLopwYTJcI4QQLkx68kII4cKkJy+EEC5MQl4IIVyYhLwQQrgwCXkhhHBhEvJCCOHC/j9QwbVfMzrbUQAAAABJRU5ErkJggg==\n", + "image/png": "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\n", "text/plain": [ "
" ] }, - "metadata": {}, + "metadata": { + "needs_background": "light" + }, "output_type": "display_data" } ], @@ -559,27 +564,29 @@ }, { "cell_type": "code", - "execution_count": 126, + "execution_count": 11, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "" + "" ] }, - "execution_count": 126, + "execution_count": 11, "metadata": {}, "output_type": "execute_result" }, { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] }, - "metadata": {}, + "metadata": { + "needs_background": "light" + }, "output_type": "display_data" } ], @@ -593,7 +600,63 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "Let's work out a slightly complex option\n" + "Let's work out a slightly complex option\n", + "\n", + "1. SELL in the money CALL option\n", + "2. BUY in-the-money + 200 CALL option\n", + "3. BUY in the money PUT option\n", + "4. SELL in-the-money - 100 PUT option\n" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 12, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "opts = [\n", + " ('C', 0),\n", + " ('C', 2),\n", + " ('P', 0),\n", + " ('P', 1)\n", + "]\n", + "mode = ['S', 'B', 'B', 'S']\n", + "collect = []\n", + "for opt, order in zip(opts, mode):\n", + " options = option_prices(nifty.set_index('date').open, [opt])\n", + " cols = ['symbol', 'date', 'expiry_dt', 'strike_pr', 'option_typ',\n", + " 'open', 'high', 'low', 'close']\n", + " res = options.merge(df[cols], on=['date', 'strike_pr', 'option_typ'])\n", + " if order == 'B':\n", + " res['profit'] = res.eval('close-open')\n", + " elif order == 'S':\n", + " res['profit'] = res.eval('open-close')\n", + " collect.append(res)\n", + "all_options = pd.concat(collect).sort_values(by='date')\n", + "all_options.groupby('date').profit.sum().cumsum().plot()" ] } ], From 12702e48d747ff79e0851f9470941aff51612a2f Mon Sep 17 00:00:00 2001 From: machine Date: Mon, 12 Aug 2019 09:22:33 +0530 Subject: [PATCH 41/53] twin_plot added to grid --- oi_graph/futures_oi.py | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 12adb36..10b76c6 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -4,7 +4,7 @@ from bokeh.io import curdoc from bokeh.layouts import row, column, gridplot, layout from bokeh.palettes import Spectral6 -from bokeh.models import ColumnDataSource, Range1d +from bokeh.models import ColumnDataSource, Range1d, LinearAxis from bokeh.models.widgets import Select, Button from bokeh.plotting import figure, output_file, show @@ -55,8 +55,6 @@ def twin_plot(data, y_axis, x_axis='timestamp'): """ Create a bokeh plot with twin axes """ - from bokeh.plotting import figure - from bokeh.models import LinearAxis, Range1d TOOLTIPS = [ ('datetime', '@x{%F %H:%M}'), @@ -96,13 +94,16 @@ def twin_plot(data, y_axis, x_axis='timestamp'): tooltips=[ ('date', '@date'), ('value', '$y{0 a}') - ]) + ], + height=250) cols, data = get_open_interest(df, 'NIFTY') data['date'] = data.timestamp.dt.date.astype(str) colors = Spectral6[:len(cols)] source.data = source.from_df(data) print(cols, colors) p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) +price_data = get_price_oi(df, 'NIFTY') +price_chart = twin_plot(price_data, y_axis=['close', 'open_int']) # setup callbacks def update(): @@ -114,6 +115,8 @@ def update(): print(cols, symbol, max_val) p.y_range = Range1d(100, max_val) p.title.text = 'Open interest chart for {} futures'.format(symbol) + pdata = get_price_data(df, symbol) + price_chart = twin_plot(pdata, y_axis=['close', 'open_int']) # set up event triggers @@ -124,6 +127,7 @@ def update(): l = layout( column( row(select_symbol,button), + price_chart, p) ) From e117dbd22bc675232afb0c50d6ad5717abcd6802 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 13 Aug 2019 09:59:53 +0530 Subject: [PATCH 42/53] combined open interest tool tip added --- oi_graph/futures_oi.py | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 10b76c6..664ebff 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -33,8 +33,9 @@ def get_open_interest(data, symbol): pivot = temp.pivot(index='timestamp', columns='expiry_dt', values='open_int') pivot.rename(lambda x: x.strftime('%Y-%m-%d'), axis='columns', inplace=True) - pct_pivot = pivot.pct_change()*100 - return (list(pivot.columns), pivot.reset_index()) + columns = pivot.columns + pivot['combined_oi'] = pivot.sum(axis=1) + return (columns, pivot.reset_index()) def get_price_oi(data, symbol): """ @@ -93,7 +94,8 @@ def twin_plot(data, y_axis, x_axis='timestamp'): p = figure(title='Open interest chart for NIFTY futures', tooltips=[ ('date', '@date'), - ('value', '$y{0 a}') + ('combined OI', '@combined_oi{0 a}'), + ('expiry_at', '$name q:@$name{0.0 a}') ], height=250) cols, data = get_open_interest(df, 'NIFTY') From f8647765a86e9051f7e08872c18f1d9f09efba7a Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 13 Aug 2019 18:32:05 +0530 Subject: [PATCH 43/53] Market Timing notebook added --- notebooks/MarketTiming.ipynb | 137 +++++++++++++++++++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 notebooks/MarketTiming.ipynb diff --git a/notebooks/MarketTiming.ipynb b/notebooks/MarketTiming.ipynb new file mode 100644 index 0000000..2ebadb5 --- /dev/null +++ b/notebooks/MarketTiming.ipynb @@ -0,0 +1,137 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Market Timing\n", + "\n", + "Market Timing is often considered a strategy for beating the markets and making profits. We would try to explore whether market timing actually works. We would work with the NIFTY index." + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [], + "source": [ + "import pandas as pd\n", + "import numpy as np\n", + "import seaborn as sns\n", + "sns.set()" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [], + "source": [ + "# Load your data here\n", + "filename = '/home/machine/Downloads/NIFTY 50_Data.csv'\n", + "df = pd.read_csv(filename, parse_dates=['Date'])\n", + "df.rename(lambda x: x.lower(), axis='columns', inplace=True)\n", + "df = df.set_index('date').sort_index()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Dollar averaging method\n", + "\n", + "Dollar averaging is one of the most popular methods used in investment. Under this method, we would buying a stock or an index fund at periodic intervals irrespective of trend. The underlying assumption is equity markets are profitable in the long run and investing them over periodic intervals for a long period of time would lead to the benefits of compounding.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 47, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "# Buy index at the close price of each month; assume integer quantities\n", + "freq = 'M' # buy every month - W for week; 2W for every 2 weeks\n", + "capital = 40000 # investment every period\n", + "df2 = df.resample(freq).close.last().reset_index()\n", + "df2.columns = ['date', 'price']\n", + "df2['avg_price'] = df2.price.expanding().mean()\n", + "df2['capital'] = capital * (df2.index+1)\n", + "df2['qty'] = (capital/df2['price']).astype(int)\n", + "df2['value'] = df2.qty.cumsum() * df2.price\n", + "df2.set_index('date').price.plot(title='Raw price plot of the index')\n", + "df2.set_index('date')[['price', 'avg_price']].plot(title='Average Buy Price')\n", + "df2.set_index('date')[['capital', 'value']].plot(\n", + " title='Invested Capital vs Value of Investment')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "So ,it took 4 years before your investment start getting returns on your capital.\n", + "\n", + "You would be in for a surprise if you change the frequency to weekly **W**.\n", + "\n", + "Hint `(capital/df2['price']).astype(int)`\n", + "\n", + "And the below figure explains " + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.6.8" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} From 44ac9da3eacd7f045b4a6031f4b4944fa496ae04 Mon Sep 17 00:00:00 2001 From: machine Date: Tue, 13 Aug 2019 20:00:09 +0530 Subject: [PATCH 44/53] Moving average crossover added to market timing --- notebooks/MarketTiming.ipynb | 96 +++++++++++++++++++++++++++++++++--- 1 file changed, 90 insertions(+), 6 deletions(-) diff --git a/notebooks/MarketTiming.ipynb b/notebooks/MarketTiming.ipynb index 2ebadb5..954f708 100644 --- a/notebooks/MarketTiming.ipynb +++ b/notebooks/MarketTiming.ipynb @@ -45,22 +45,22 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 48, "metadata": {}, "outputs": [ { "data": { "text/plain": [ - "" + "" ] }, - "execution_count": 47, + "execution_count": 48, "metadata": {}, "output_type": "execute_result" }, { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -81,6 +81,18 @@ "needs_background": "light" }, "output_type": "display_data" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" } ], "source": [ @@ -107,9 +119,81 @@ "\n", "You would be in for a surprise if you change the frequency to weekly **W**.\n", "\n", - "Hint `(capital/df2['price']).astype(int)`\n", + "Hint `(capital/df2['price']).astype(int)`" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Moving average crossover\n", + "\n", + "One of the most suggested strategies is the moving average crossover where you buy when one moving average crosses another. Let's implement a long only strategy implementing MA crossover.\n", + "\n", + "1. Select two periods ma1, ma2 so that ma1 > ma2\n", + "2. Calculate the simple moving average for the 2 periods\n", + "3. BUY when ma1 > ma2\n", + "4. SELL when ma1 < ma2; hold as long as ma1 > ma2\n", + "5. Enter into a new position only when there are no open positions" + ] + }, + { + "cell_type": "code", + "execution_count": 114, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Returns when invested and left alone\n", + "Amount=127935; Returns=127.93%\n", + "Returns from the strategy\n", + "Amount=26554;Returns=26.55%\n" + ] + } + ], + "source": [ + "from fastbt.tradebook import TradeBook\n", + "\n", + "capital = 100000\n", + "ma1 = 15\n", + "ma2 = 30\n", + "df2 = df.copy()\n", + "df2['ma1'] = df2.rolling(ma1).close.mean()\n", + "df2['ma2'] = df2.rolling(ma2).close.mean()\n", + "\n", + "tb = TradeBook()\n", + "for date,row in df2.dropna().iterrows():\n", + " # Enter into a position only when there are no open positions\n", + " if tb.o == 0:\n", + " if row['ma1'] > row['ma2']:\n", + " qty = int(capital/row['close'])\n", + " tb.add_trade(date, 'NIFTY', row['close'], qty, order='B',\n", + " ma1=row['ma1'], ma2=row['ma2'])\n", + " # Exit in case of an open order\n", + " if tb.o > 0:\n", + " last_qty = abs(tb.trades['NIFTY'][-1]['qty'])\n", + " if row['ma1'] < row ['ma2']:\n", + " tb.add_trade(date, 'NIFTY', row['close'], last_qty, order='S',\n", + " ma1=row['ma1'], ma2=row['ma2'])\n", + " \n", + "# Close any existing position at the end of the period\n", + "if tb.o > 0:\n", + " last_qty = abs(tb.trades['NIFTY'][-1]['qty'])\n", + " tb.add_trade(date, 'NIFTY', row['close'], last_qty, order='S',\n", + " ma1=row['ma1'], ma2=row['ma2'])\n", + "\n", + "# In case of investment left untouched\n", + "return_per_qty = df2.close.iloc[-1] - df2.close.iloc[0] \n", + "start_qty = int(capital/df2.close.iloc[0])\n", + "total_return = return_per_qty * start_qty\n", + "returns_calc = lambda x,y : (x/y)*100\n", "\n", - "And the below figure explains " + "print('Returns when invested and left alone\\nAmount={:.0f}; \\\n", + "Returns={:.2f}%'.format(total_return, returns_calc(total_return, capital)))\n", + "print('Returns from the strategy\\nAmount={:.0f};Returns={:.2f}%'.format(\n", + " tb.values['NIFTY'], returns_calc(tb.values['NIFTY'], capital)))" ] } ], From b04874a596765696c2708e0f33eda301b1edbf4a Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 14 Aug 2019 08:03:34 +0530 Subject: [PATCH 45/53] price chart with twin axes added --- notebooks/MarketTiming.ipynb | 77 ++++++------------------------------ 1 file changed, 13 insertions(+), 64 deletions(-) diff --git a/notebooks/MarketTiming.ipynb b/notebooks/MarketTiming.ipynb index 954f708..c098bc4 100644 --- a/notebooks/MarketTiming.ipynb +++ b/notebooks/MarketTiming.ipynb @@ -11,7 +11,7 @@ }, { "cell_type": "code", - "execution_count": 14, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -23,7 +23,7 @@ }, { "cell_type": "code", - "execution_count": 15, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -45,56 +45,9 @@ }, { "cell_type": "code", - "execution_count": 48, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "" - ] - }, - "execution_count": 48, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], + "outputs": [], "source": [ "# Buy index at the close price of each month; assume integer quantities\n", "freq = 'M' # buy every month - W for week; 2W for every 2 weeks\n", @@ -139,20 +92,9 @@ }, { "cell_type": "code", - "execution_count": 114, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Returns when invested and left alone\n", - "Amount=127935; Returns=127.93%\n", - "Returns from the strategy\n", - "Amount=26554;Returns=26.55%\n" - ] - } - ], + "outputs": [], "source": [ "from fastbt.tradebook import TradeBook\n", "\n", @@ -195,6 +137,13 @@ "print('Returns from the strategy\\nAmount={:.0f};Returns={:.2f}%'.format(\n", " tb.values['NIFTY'], returns_calc(tb.values['NIFTY'], capital)))" ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Change the ma1 and ma2 parameters to see how the returns vary" + ] } ], "metadata": { From baec6e88753ae779e7ea5eb1ed31ab7f9f4fa27d Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 14 Aug 2019 11:59:24 +0530 Subject: [PATCH 46/53] twin chart added --- oi_graph/futures_oi.py | 71 ++++++++++++++++++++---------------------- 1 file changed, 33 insertions(+), 38 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 664ebff..fcc276e 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -52,38 +52,11 @@ def get_price_oi(data, symbol): agg['index'] = range(len(agg)) return agg -def twin_plot(data, y_axis, x_axis='timestamp'): - """ - Create a bokeh plot with twin axes - """ - - TOOLTIPS = [ - ('datetime', '@x{%F %H:%M}'), - ('value', '$y{0.00}') - ] - - y1,y2 = y_axis[0], y_axis[1] - h0 = data[y1].max() - l0 = data[y1].min() - h1 = data[y2].max() - l1 = data[y2].min() - p = figure(x_axis_type='datetime', y_range=(l0, h0), - tooltips=TOOLTIPS, height=240, width=600) - p.line(data[x_axis].values, data[y1].values, - color="red", legend=y1) - p.extra_y_ranges = {"foo": Range1d(l1,h1)} - p.line(data[x_axis], data[y2].values, color="blue", - y_range_name="foo", legend=y2) - p.add_layout(LinearAxis(y_range_name="foo", axis_label=y2), 'left') - p.hover.formatters= {'x': 'datetime'} - p.legend.location = 'top_center' - p.legend.click_policy = 'hide' - return p - output_file('futures_oi.html') df = load_data() symbols = list(df.symbol.unique()) source = ColumnDataSource() +prices = ColumnDataSource() # Create widgets select_symbol = Select(options=symbols, title='Select a symbol', @@ -102,23 +75,44 @@ def twin_plot(data, y_axis, x_axis='timestamp'): data['date'] = data.timestamp.dt.date.astype(str) colors = Spectral6[:len(cols)] source.data = source.from_df(data) -print(cols, colors) p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) + price_data = get_price_oi(df, 'NIFTY') -price_chart = twin_plot(price_data, y_axis=['close', 'open_int']) +prices.data = prices.from_df(price_data) +h0 = price_data['close'].max() +l0 = price_data['close'].min() +h1 = price_data['open_int'].max() +l1 = price_data['open_int'].min() +p2 = figure(title='Price vs Open Interest', + x_axis_type='datetime', y_range=(l0,h0), + height=250) +p2.line('timestamp', 'close', source=prices) +p2.extra_y_ranges = {'foo': Range1d(l1,h1)} +p2.line('timestamp', 'open_int', source=prices, y_range_name='foo') +p2.add_layout(LinearAxis(y_range_name='foo'), 'right') # setup callbacks def update(): symbol = select_symbol.value cols, data = get_open_interest(df, symbol) data['date'] = data.timestamp.dt.date.astype(str) - source.data = source.from_df(data) - max_val = data.sum(axis=1).max() - print(cols, symbol, max_val) - p.y_range = Range1d(100, max_val) + max_val = data[cols].sum().max() + p.y_range.start = 0 + p.y_range.end = max_val p.title.text = 'Open interest chart for {} futures'.format(symbol) - pdata = get_price_data(df, symbol) - price_chart = twin_plot(pdata, y_axis=['close', 'open_int']) + source.data = source.from_df(data) + pdata = get_price_oi(df, symbol) + h0 = pdata['close'].max() + l0 = pdata['close'].min() + h1 = pdata['open_int'].max() + l1 = pdata['open_int'].min() + print(symbol, l0, h0, l1, h1) + prices.data = prices.from_df(pdata) + p2.y_range.start = l0 + p2.y_range.end = h0 + p2.extra_y_ranges['foo'].start = l1 + p2.extra_y_ranges['foo'].end = h1 + # set up event triggers @@ -129,8 +123,9 @@ def update(): l = layout( column( row(select_symbol,button), - price_chart, - p) + p2, + p + ) ) curdoc().add_root(l) From 91fb051b64181a70d765b07eb44a5b0a6bd9f743 Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 14 Aug 2019 13:08:14 +0530 Subject: [PATCH 47/53] percent change plot added --- oi_graph/futures_oi.py | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index fcc276e..f21af61 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -57,6 +57,8 @@ def get_price_oi(data, symbol): symbols = list(df.symbol.unique()) source = ColumnDataSource() prices = ColumnDataSource() +pct_chg = ColumnDataSource() + # Create widgets select_symbol = Select(options=symbols, title='Select a symbol', @@ -91,6 +93,17 @@ def get_price_oi(data, symbol): p2.line('timestamp', 'open_int', source=prices, y_range_name='foo') p2.add_layout(LinearAxis(y_range_name='foo'), 'right') +pct_change = data[['date', 'combined_oi']] +pct_change['date'] = pd.to_datetime(pct_change['date']) +pct_change['chg'] = pct_change.combined_oi.pct_change() +print(pct_change.reset_index().info()) +pct_chg.data = pct_chg.from_df(pct_change) +p3 = figure(title='Change in open_interest', + height=250, x_axis_type='datetime') +p3.vbar(x='index', top='chg', width=0.6, source=pct_chg) + + + # setup callbacks def update(): symbol = select_symbol.value @@ -124,7 +137,8 @@ def update(): column( row(select_symbol,button), p2, - p + p, + p3 ) ) From 2f19d1c0cc7204ae381c4f132cf52b147bb3389a Mon Sep 17 00:00:00 2001 From: machine Date: Wed, 14 Aug 2019 13:28:09 +0530 Subject: [PATCH 48/53] grid layout added and percent change chart updated --- oi_graph/futures_oi.py | 26 ++++++++++---------------- 1 file changed, 10 insertions(+), 16 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index f21af61..b637a5e 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -71,8 +71,7 @@ def get_price_oi(data, symbol): ('date', '@date'), ('combined OI', '@combined_oi{0 a}'), ('expiry_at', '$name q:@$name{0.0 a}') - ], - height=250) + ]) cols, data = get_open_interest(df, 'NIFTY') data['date'] = data.timestamp.dt.date.astype(str) colors = Spectral6[:len(cols)] @@ -86,29 +85,26 @@ def get_price_oi(data, symbol): h1 = price_data['open_int'].max() l1 = price_data['open_int'].min() p2 = figure(title='Price vs Open Interest', - x_axis_type='datetime', y_range=(l0,h0), - height=250) + x_axis_type='datetime', y_range=(l0,h0)) p2.line('timestamp', 'close', source=prices) p2.extra_y_ranges = {'foo': Range1d(l1,h1)} p2.line('timestamp', 'open_int', source=prices, y_range_name='foo') p2.add_layout(LinearAxis(y_range_name='foo'), 'right') -pct_change = data[['date', 'combined_oi']] +pct_change = data[['date', 'combined_oi']].copy() pct_change['date'] = pd.to_datetime(pct_change['date']) pct_change['chg'] = pct_change.combined_oi.pct_change() -print(pct_change.reset_index().info()) pct_chg.data = pct_chg.from_df(pct_change) -p3 = figure(title='Change in open_interest', - height=250, x_axis_type='datetime') +p3 = figure(title='Change in open_interest') p3.vbar(x='index', top='chg', width=0.6, source=pct_chg) - # setup callbacks def update(): symbol = select_symbol.value cols, data = get_open_interest(df, symbol) data['date'] = data.timestamp.dt.date.astype(str) + print(data[cols].sum()) max_val = data[cols].sum().max() p.y_range.start = 0 p.y_range.end = max_val @@ -125,21 +121,19 @@ def update(): p2.y_range.end = h0 p2.extra_y_ranges['foo'].start = l1 p2.extra_y_ranges['foo'].end = h1 - + pct_change = data[['date', 'combined_oi']].copy() + pct_change['chg'] = pct_change.combined_oi.pct_change() + pct_chg.data = pct_chg.from_df(pct_change) # set up event triggers button.on_click(update) - +grid = gridplot([p2,p,p3], ncols=1, plot_width=640, plot_height=180) # Display the dashboard l = layout( - column( row(select_symbol,button), - p2, - p, - p3 - ) + grid ) curdoc().add_root(l) From 4c475a2cc7b1f55bc4a9c607191ec00e977c907c Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 16 Aug 2019 22:14:57 +0530 Subject: [PATCH 49/53] ticks changed to millions --- oi_graph/futures_oi.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index b637a5e..21a890e 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -4,7 +4,7 @@ from bokeh.io import curdoc from bokeh.layouts import row, column, gridplot, layout from bokeh.palettes import Spectral6 -from bokeh.models import ColumnDataSource, Range1d, LinearAxis +from bokeh.models import ColumnDataSource, Range1d, LinearAxis, NumeralTickFormatter from bokeh.models.widgets import Select, Button from bokeh.plotting import figure, output_file, show @@ -76,6 +76,7 @@ def get_price_oi(data, symbol): data['date'] = data.timestamp.dt.date.astype(str) colors = Spectral6[:len(cols)] source.data = source.from_df(data) +p.yaxis[0].formatter = NumeralTickFormatter(format='0.00 a') p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) price_data = get_price_oi(df, 'NIFTY') @@ -90,6 +91,7 @@ def get_price_oi(data, symbol): p2.extra_y_ranges = {'foo': Range1d(l1,h1)} p2.line('timestamp', 'open_int', source=prices, y_range_name='foo') p2.add_layout(LinearAxis(y_range_name='foo'), 'right') +p2.yaxis[1].formatter = NumeralTickFormatter(format='0.0 a') pct_change = data[['date', 'combined_oi']].copy() pct_change['date'] = pd.to_datetime(pct_change['date']) From 88d01e1593cbdca4653ecef90026dd0da081feeb Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 16 Aug 2019 22:27:55 +0530 Subject: [PATCH 50/53] visual appearance improved --- oi_graph/futures_oi.py | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 21a890e..ea5880c 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -3,7 +3,7 @@ from bokeh.io import curdoc from bokeh.layouts import row, column, gridplot, layout -from bokeh.palettes import Spectral6 +from bokeh.palettes import Spectral6, Dark2 from bokeh.models import ColumnDataSource, Range1d, LinearAxis, NumeralTickFormatter from bokeh.models.widgets import Select, Button from bokeh.plotting import figure, output_file, show @@ -71,13 +71,13 @@ def get_price_oi(data, symbol): ('date', '@date'), ('combined OI', '@combined_oi{0 a}'), ('expiry_at', '$name q:@$name{0.0 a}') - ]) + ],background_fill_color='beige', background_fill_alpha=0.4) cols, data = get_open_interest(df, 'NIFTY') data['date'] = data.timestamp.dt.date.astype(str) -colors = Spectral6[:len(cols)] +colors = Dark2[6][:len(cols)] source.data = source.from_df(data) p.yaxis[0].formatter = NumeralTickFormatter(format='0.00 a') -p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source) +p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source, fill_alpha=0.7) price_data = get_price_oi(df, 'NIFTY') prices.data = prices.from_df(price_data) @@ -86,10 +86,12 @@ def get_price_oi(data, symbol): h1 = price_data['open_int'].max() l1 = price_data['open_int'].min() p2 = figure(title='Price vs Open Interest', - x_axis_type='datetime', y_range=(l0,h0)) -p2.line('timestamp', 'close', source=prices) + x_axis_type='datetime', y_range=(l0,h0), + background_fill_color='beige', background_fill_alpha=0.4) +p2.line('timestamp', 'close', line_width=2, source=prices) p2.extra_y_ranges = {'foo': Range1d(l1,h1)} -p2.line('timestamp', 'open_int', source=prices, y_range_name='foo') +p2.line('timestamp', 'open_int', source=prices, y_range_name='foo', + line_color='firebrick', line_width=2) p2.add_layout(LinearAxis(y_range_name='foo'), 'right') p2.yaxis[1].formatter = NumeralTickFormatter(format='0.0 a') @@ -97,8 +99,10 @@ def get_price_oi(data, symbol): pct_change['date'] = pd.to_datetime(pct_change['date']) pct_change['chg'] = pct_change.combined_oi.pct_change() pct_chg.data = pct_chg.from_df(pct_change) -p3 = figure(title='Change in open_interest') -p3.vbar(x='index', top='chg', width=0.6, source=pct_chg) +p3 = figure(title='Change in open_interest', + background_fill_color='beige', background_fill_alpha=0.4) +p3.vbar(x='index', top='chg', width=0.6, + fill_alpha=0.7, color='gold', source=pct_chg) # setup callbacks From 190e4d6c6ae3bc4d200c5b622ffa4ae8e661d1d7 Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 16 Aug 2019 22:36:22 +0530 Subject: [PATCH 51/53] tooltips added for all charts --- oi_graph/futures_oi.py | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index ea5880c..48e40f8 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -85,8 +85,13 @@ def get_price_oi(data, symbol): l0 = price_data['close'].min() h1 = price_data['open_int'].max() l1 = price_data['open_int'].min() + p2 = figure(title='Price vs Open Interest', x_axis_type='datetime', y_range=(l0,h0), + tooltips = [ + ('date', '@timestamp{%F}'), + ('value', '$y{0.00 a}') + ], background_fill_color='beige', background_fill_alpha=0.4) p2.line('timestamp', 'close', line_width=2, source=prices) p2.extra_y_ranges = {'foo': Range1d(l1,h1)} @@ -94,12 +99,16 @@ def get_price_oi(data, symbol): line_color='firebrick', line_width=2) p2.add_layout(LinearAxis(y_range_name='foo'), 'right') p2.yaxis[1].formatter = NumeralTickFormatter(format='0.0 a') +p2.hover.formatters = {'timestamp': 'datetime'} pct_change = data[['date', 'combined_oi']].copy() pct_change['date'] = pd.to_datetime(pct_change['date']) pct_change['chg'] = pct_change.combined_oi.pct_change() pct_chg.data = pct_chg.from_df(pct_change) p3 = figure(title='Change in open_interest', + tooltips=[ + ('change', '$y{0.00%}') + ], background_fill_color='beige', background_fill_alpha=0.4) p3.vbar(x='index', top='chg', width=0.6, fill_alpha=0.7, color='gold', source=pct_chg) From ba5cf3ad19d1b0142909aaa9044fd8599a70d44f Mon Sep 17 00:00:00 2001 From: machine Date: Fri, 16 Aug 2019 22:46:05 +0530 Subject: [PATCH 52/53] linked panning added --- oi_graph/futures_oi.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index 48e40f8..ce9609e 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -108,7 +108,7 @@ def get_price_oi(data, symbol): p3 = figure(title='Change in open_interest', tooltips=[ ('change', '$y{0.00%}') - ], + ], x_range = p.x_range, background_fill_color='beige', background_fill_alpha=0.4) p3.vbar(x='index', top='chg', width=0.6, fill_alpha=0.7, color='gold', source=pct_chg) @@ -119,7 +119,6 @@ def update(): symbol = select_symbol.value cols, data = get_open_interest(df, symbol) data['date'] = data.timestamp.dt.date.astype(str) - print(data[cols].sum()) max_val = data[cols].sum().max() p.y_range.start = 0 p.y_range.end = max_val From c5d1f962c2875392e5a6c8c744b899c6e4b099cf Mon Sep 17 00:00:00 2001 From: machine Date: Mon, 19 Aug 2019 12:55:35 +0530 Subject: [PATCH 53/53] axis changed to datetime for all charts --- oi_graph/futures_oi.py | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/oi_graph/futures_oi.py b/oi_graph/futures_oi.py index ce9609e..51ccc2e 100644 --- a/oi_graph/futures_oi.py +++ b/oi_graph/futures_oi.py @@ -67,17 +67,18 @@ def get_price_oi(data, symbol): # Create plots p = figure(title='Open interest chart for NIFTY futures', + x_axis_type='datetime', tooltips=[ ('date', '@date'), ('combined OI', '@combined_oi{0 a}'), ('expiry_at', '$name q:@$name{0.0 a}') ],background_fill_color='beige', background_fill_alpha=0.4) cols, data = get_open_interest(df, 'NIFTY') -data['date'] = data.timestamp.dt.date.astype(str) +data['date'] = data.timestamp.dt.date colors = Dark2[6][:len(cols)] source.data = source.from_df(data) p.yaxis[0].formatter = NumeralTickFormatter(format='0.00 a') -p.vbar_stack(cols, width=0.6, x='index', color=colors, source=source, fill_alpha=0.7) +p.vbar_stack(cols, width=3.6e7, x='date', color=colors, source=source, fill_alpha=0.7) price_data = get_price_oi(df, 'NIFTY') prices.data = prices.from_df(price_data) @@ -106,11 +107,12 @@ def get_price_oi(data, symbol): pct_change['chg'] = pct_change.combined_oi.pct_change() pct_chg.data = pct_chg.from_df(pct_change) p3 = figure(title='Change in open_interest', + x_axis_type='datetime', tooltips=[ ('change', '$y{0.00%}') - ], x_range = p.x_range, + ], background_fill_color='beige', background_fill_alpha=0.4) -p3.vbar(x='index', top='chg', width=0.6, +p3.vbar(x='date', top='chg', width=3.6e7, fill_alpha=0.7, color='gold', source=pct_chg)