From a3f7acff5da9e0dbd570eb1ca7a50cf43b032245 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 15:02:09 +0200 Subject: [PATCH 01/13] Update README.md --- README.md | 62 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 42 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 62edff63b..e9f048671 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ Please refer to the [Superalgos Desktop App](https://superalgos.org/tools-supera * [Getting Started](#getting-started) * [Before You Begin](#before-you-begin) * [The Quick Version for Experienced PC Operators](#the-quick-version-for-experienced-pc-operators) - * [The Long Version for Regular Folks on Windows and Mac](#the-long-version-for-regular-folks-on-windows-and-mac) + * [The Extended Version for Regular Folks on Windows and Mac](#the-extended-version-for-regular-folks-on-windows-and-mac) * [Downloads](#downloads/) * [Running the App](#running-the-app) * [Upgrading Your Existing Installation](#upgrading-your-existing-installation) @@ -107,7 +107,7 @@ The following recommendations may make your life easier using this pre-release i * We highly recommend you use Chrome to run the app, so that you have a similar environment as developers in case you need help. -* You may need a decent Console / Command Line application for similar reasons: we hope you won't need it, but in case you do, it may save you lots of hassle and make a difference troubleshooting and getting help from the community. We recommend [Console Emulator Cmder](https://cmder.net/). +* You will benefit from having a decent Console / Command Line application for similar reasons: we hope you won't need it, but in case you do, it may save you lots of hassle and make a difference troubleshooting and getting help from the community. We recommend [Console Emulator Cmder](https://cmder.net/). > Bear in mind that the app evolves fast. We do our best to keep this README up to date, however, some of the images illustrating these explanations may defer from what you will find in the app. @@ -117,71 +117,93 @@ The following recommendations may make your life easier using this pre-release i **1. Downloads**: -Download the software package from the [latest software release](https://github.com/Superalgos/DesktopApp/releases/tag/v.0.0.1-alpha) (```Superalgos-Desktop-App.zip```) and extract the file in an accessible route (you will launch the app from these folders). +Download the software package from the [latest software release](https://github.com/Superalgos/DesktopApp/releases/tag/v.0.0.2-alpha) (```Superalgos-Desktop-App.zip```) and extract the file in an accessible route (you will launch the app from these folders). -Download historic market data from the [latest data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.08.27) (```Poloniex.BTC.USDT.Historic.Data.zip```) and extract the file inside the ```Superalgos Desktop App``` folder generated by the software package ZIP. +Download historic market data from the [latest data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.09.24) (```Poloniex.BTC.USDT.Historic.Data.zip```) and extract the file inside the ```Superalgos Desktop App``` folder generated by the software package ZIP. You should end up with the following folder structure: -![image](https://user-images.githubusercontent.com/13994516/63965100-be6a7b80-ca98-11e9-9398-40b46be9ecf5.png) +![image](https://user-images.githubusercontent.com/13994516/65512836-56158b00-deda-11e9-8d81-0dcd79efb480.png) -> Make sure the data ended up as the ```Data-Storage``` folder, right inside ```Superalgos Desktop App``` +> Make sure the data ended up as the ```Data-Storage``` folder, right inside the ```Superalgos Desktop App``` root folder. **2. Continue with [Running the App](#running-the-app)** -> NOTE FOR DEVELOPERS: Instead of using the EXE file to run the app, you may want to use ```node server.js``` from within the ```WebServer``` folder to run on your full Node Js installation. +> NOTE FOR DEVELOPERS: Instead of using the EXE file to run the app, you may want to use ```node run``` from within the root ```Superalgos Desktop App``` folder, to run on your full Node Js installation. -## The Long Version for Regular Folks on Windows and Mac +## The Extended Version for Regular Folks on Windows and Mac ### Downloads **1. Download the Software Package**: -Go to the [latest Superalgos Desktop App release](https://github.com/Superalgos/DesktopApp/releases/tag/v.0.0.1-alpha) and download ```Superalgos-Desktop-App.zip```. +Go to the [latest Superalgos Desktop App release](https://github.com/Superalgos/DesktopApp/releases/tag/v.0.0.2-alpha) and download ```Superalgos-Desktop-App.zip```. **2. Extract the ZIP file**: -How you extract/unpack the files depends on the software you use to handle ZIP files. Double clicking the ZIP file should work in most scenarios, however, some systems may "open" the file instead of "extracting" it. Make sure you are "extracting" and not just "opening" the file. You may also right-click the file and check the options available on the menu. +How you extract/unpack the files depends on the software you use to handle ZIP files. Double clicking the ZIP file should work in most scenarios, however, some systems may "open" the file instead of "extracting" it. Make sure you are "extracting" and not just "opening" the file. You may also right-click the file and check the options available on the pop-up menu. When you extract the ZIP file, a folder structure will be created with the root folder being ```Superalgos Desktop App```. -You may extract/unpack the files in any location of your drive, however, we recommend unpacking in an accesible route *(i.e.: ```C:\```)*, as you will later need to fit an additional folder in the ```Superalgos Desktop App``` folder, and you will also need to access these folders every time you launch the app. +You may extract/unpack the files in any location of your drive, however, we recommend unpacking in an accesible route *(i.e.: ```C:\```)*, as you will later need to fit an additional folder inside the ```Superalgos Desktop App``` folder, and you will also need to access these folders every time you launch the app. **3. Download the Data Package**: -For your convenience and [for the reasons explained](https://superalgos.org/tools-superalgos-desktop-app.shtml#expectations) in the Superalgos Desktop App page on the website, we maintain a downloadable market data file that you can download, so that you may be up and running as quickly as possible. +For your convenience and [for the reasons explained](https://superalgos.org/tools-superalgos-desktop-app.shtml#expectations) in the Superalgos Desktop App page on the website, we maintain a downloadable market-data file that you can download, so that you may be up and running as quickly as possible. -Go to the [latest Data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.08.27) and download ```Poloniex.BTC.USDT.Historic.Data.zip```. +Go to the [latest Data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.09.24) and download ```Poloniex.BTC.USDT.Historic.Data.zip```. The ZIP file includes highly-compressed complete historic BTC/USDT market data at Poloniex. Expect decompression to take from 30 to 60 minutes, depending on your system. Once you have the historic data, the app will make sure the data stays up to date. **4. Extract the ZIP file**: -You need to extract the file inside the ```Superalgos Desktop App``` folder generated by the first ZIP file. You can do this either moving ```Poloniex.BTC.USDT.Historic.Data.zip``` inside the ```Superalgos Desktop App``` folder and selecting ```Extract here``` from the menu poping up upon right-clicking the file, or by extracting anywhere else and the moving the resulting ```Data-Storage``` folder inside the ```Superalgos Desktop App``` folder. +You need to extract the file inside the ```Superalgos Desktop App``` folder generated by the first ZIP file. You can achieve this in two ways: + +A. Move ```Poloniex.BTC.USDT.Historic.Data.zip``` inside the ```Superalgos Desktop App``` folder, right-click the ZIP file and select ```Extract here``` in the pop-up menu. This is the quickest method. + +B. Extract the ZIP file anywhere else and then move the resulting ```Data-Storage``` folder inside the ```Superalgos Desktop App``` folder. This will take almost double the time. You should end up with the following folder structure: -![image](https://user-images.githubusercontent.com/13994516/63965100-be6a7b80-ca98-11e9-9398-40b46be9ecf5.png) +![image](https://user-images.githubusercontent.com/13994516/65512836-56158b00-deda-11e9-8d81-0dcd79efb480.png) -> Make sure the data ended up as the ```Data-Storage``` folder, right inside ```Superalgos Desktop App``` +> Make sure the data ended up as the ```Data-Storage``` folder, right inside the ```Superalgos Desktop App``` root folder. ### Running the App -**1. Use the executable to Run the App** +**1. Use the executable file to run the app** -Go to ```Superalgos Desktop App\WebServer```, that is, the ```WebServer``` folder inside the ```Superalgos Desktop App``` folder and double click on ```Windows-Superalgos-Desktop.exe``` (for Windows systems) or ```MacOs-Superalgos-Desktop.app``` (for Mac systems). +Go to the ```Superalgos Desktop App``` folder and double click on ```Superalgos.exe``` (for Windows systems) or ```Superalgos.app``` (for Mac systems). -The app will load on your default browser. You should either [set Chrome as your default browser](https://support.google.com/chrome/answer/95417?co=GENIE.Platform%3DDesktop&hl=en) before executing the EXE file, or simply close the non-Chrome browser, open Chrome and go to http://localhost:1337/. +The app will load on your default browser. You should either [set Chrome as your default browser](https://support.google.com/chrome/answer/95417?co=GENIE.Platform%3DDesktop&hl=en) before executing the file, or simply close the non-Chrome browser, open Chrome and go to http://localhost:1337/. Also, a Console/Command Line window will open. The Console must be open for as long as the app is running. Do not close the window or stop the processes running on it. You may minimize the Console if your Operating System allows you to do so. +> Closing the Console/Command Line may cause your market data to become corrupt. The proper way of closing the application is closing your browser first, and allow a minute for processes to stop before closing the Console. + **2. Drag and drop an example workspace**: Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag the file ```Share - Workspace - A Minimum Strategy Template.json``` and drop it on the _Designer_ (in the bottom half of the screen, the area with a black background) to start with a working template. ![Installation-Drag-Workspace](https://user-images.githubusercontent.com/13994516/64358772-5ae7cd00-d007-11e9-9250-77540cc351c8.gif) -**3. Start indicators**: +That's it! You are up and running! + +Now you are ready to learn the basic operation of the app so that you may run your first backtests or trade live with existing strategies. + +**3. Start processes**: + +| Task Manager | Definition | +| :---: | :---: | +| ![parameters](https://user-images.githubusercontent.com/13994516/63508921-3f46d780-c4db-11e9-970d-8d5e2ca5ebe3.png) | ![definition](https://user-images.githubusercontent.com/13994516/63503991-deb29d00-c4d0-11e9-8c03-bf2e618f9ef6.png) | + +Open up the Designer section of the app by dragging the horizontal bar upwards and locate the Task Manager element connected to the Definition element. Then, hover your mouse pointer over the Task Manager element and click ```Run All Tasks``` in the menu. + +> To move around the Designer, click on the black background and drag to pan in any direction. + +You will find the Task Manager element in the following position: + +[PNG ILLUSTRATION PLACEHOLDER] Click the RESTART SIMULATION button on the right-hand side of the horizontal turquoise bar. This puts all indicator bots to run. The data files you downloaded contain data files up to a certain point in time. You will need to allow some time for bots to catch up with building candles and the rest of indicators up to the present time. After a few minutes, refresh the candles layers as explained in the [Layers Panel](#layers-panel) section. From a538178c8e2658a8de80d837a630b0a32048988b Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 16:07:06 +0200 Subject: [PATCH 02/13] Update README.md --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index e9f048671..38dc9ae29 100644 --- a/README.md +++ b/README.md @@ -119,7 +119,7 @@ The following recommendations may make your life easier using this pre-release i Download the software package from the [latest software release](https://github.com/Superalgos/DesktopApp/releases/tag/v.0.0.2-alpha) (```Superalgos-Desktop-App.zip```) and extract the file in an accessible route (you will launch the app from these folders). -Download historic market data from the [latest data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.09.24) (```Poloniex.BTC.USDT.Historic.Data.zip```) and extract the file inside the ```Superalgos Desktop App``` folder generated by the software package ZIP. +Download historic market data from the [latest data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.09.24) (```Poloniex.BTC.USDT.Historic.Data.zip```) and extract the file inside the ```Superalgos Desktop App``` folder generated by the software ZIP package. You should end up with the following folder structure: @@ -129,7 +129,7 @@ You should end up with the following folder structure: **2. Continue with [Running the App](#running-the-app)** -> NOTE FOR DEVELOPERS: Instead of using the EXE file to run the app, you may want to use ```node run``` from within the root ```Superalgos Desktop App``` folder, to run on your full Node Js installation. +> NOTE FOR DEVELOPERS: Instead of using the executable file to run the app, you may want to use ```node run``` from within the root ```Superalgos Desktop App``` folder, to run on your full Node Js installation. ## The Extended Version for Regular Folks on Windows and Mac @@ -153,7 +153,7 @@ For your convenience and [for the reasons explained](https://superalgos.org/tool Go to the [latest Data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.09.24) and download ```Poloniex.BTC.USDT.Historic.Data.zip```. -The ZIP file includes highly-compressed complete historic BTC/USDT market data at Poloniex. Expect decompression to take from 30 to 60 minutes, depending on your system. Once you have the historic data, the app will make sure the data stays up to date. +The ZIP file includes highly-compressed complete historic BTC/USDT Ploniex market data. Expect decompression to take from 30 to 60 minutes, depending on your system. Once you have the historic data, the app will make sure the data stays up to date. **4. Extract the ZIP file**: @@ -183,7 +183,7 @@ Also, a Console/Command Line window will open. The Console must be open for as l **2. Drag and drop an example workspace**: -Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag the file ```Share - Workspace - A Minimum Strategy Template.json``` and drop it on the _Designer_ (in the bottom half of the screen, the area with a black background) to start with a working template. +Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag your preferred example file and drop it on the _Designer_ (the area with a black background in the bottom half of the screen) to start with a working template. ![Installation-Drag-Workspace](https://user-images.githubusercontent.com/13994516/64358772-5ae7cd00-d007-11e9-9250-77540cc351c8.gif) From 77b51aa7aa00b711d636dde9369a90f3b58ba3e0 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 16:25:21 +0200 Subject: [PATCH 03/13] Update README.md --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 38dc9ae29..60e196a18 100644 --- a/README.md +++ b/README.md @@ -187,10 +187,20 @@ Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag your pr ![Installation-Drag-Workspace](https://user-images.githubusercontent.com/13994516/64358772-5ae7cd00-d007-11e9-9250-77540cc351c8.gif) +Available Quick Start Examples: + +```Share - Workspace - Empty Strategy Structure Template.json```: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. You will not be able to run backtest or trade live with this template, until you set up your strategy. + +```Share - Workspace - Bull run rider - USDT- 1hr.json```: A functional USDT-based strategy designed for bull markets. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-USDT-BullRunRider](https://github.com/Superalgos/Strategy-USDT-BullRunRider) repository. + +```Share - Workspace - Weak-hands buster - BTC - 1hr.json```: A functional BTC-based strategy designed for accumulating bitcoin during bear markets or market consolidation situations. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-BTC-WeakHandsBuster](https://github.com/Superalgos/Strategy-BTC-WeakHandsBuster) repository. + That's it! You are up and running! Now you are ready to learn the basic operation of the app so that you may run your first backtests or trade live with existing strategies. + + **3. Start processes**: | Task Manager | Definition | From b6eb3837c116f1eb4a2b5e2b76ce756c6a309ccd Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 16:47:52 +0200 Subject: [PATCH 04/13] Update README.md --- README.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 60e196a18..df46b39e7 100644 --- a/README.md +++ b/README.md @@ -189,19 +189,25 @@ Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag your pr Available Quick Start Examples: -```Share - Workspace - Empty Strategy Structure Template.json```: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. You will not be able to run backtest or trade live with this template, until you set up your strategy. +**```Share - Workspace - Bull run rider - USDT- 1hr.json```**: A functional USDT-based strategy designed for bull markets. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-USDT-BullRunRider](https://github.com/Superalgos/Strategy-USDT-BullRunRider) repository. -```Share - Workspace - Bull run rider - USDT- 1hr.json```: A functional USDT-based strategy designed for bull markets. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-USDT-BullRunRider](https://github.com/Superalgos/Strategy-USDT-BullRunRider) repository. +**```Share - Workspace - Weak-hands buster - BTC - 1hr.json```**: A functional BTC-based strategy designed for accumulating bitcoin during bear markets or market consolidation situations. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-BTC-WeakHandsBuster](https://github.com/Superalgos/Strategy-BTC-WeakHandsBuster) repository. -```Share - Workspace - Weak-hands buster - BTC - 1hr.json```: A functional BTC-based strategy designed for accumulating bitcoin during bear markets or market consolidation situations. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-BTC-WeakHandsBuster](https://github.com/Superalgos/Strategy-BTC-WeakHandsBuster) repository. +**```Share - Workspace - Empty Strategy Structure Template.json```**: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. **You will not be able to run backtest or trade live with this template, until you set up your strategy.** That's it! You are up and running! Now you are ready to learn the basic operation of the app so that you may run your first backtests or trade live with existing strategies. +## Running Your First Backtest +To run your first backtest you will need a functional strategy. -**3. Start processes**: +**1. Import the right template** + +If you haven't yet, start by importing either ```Share - Workspace - Bull run rider - USDT- 1hr.json``` or ```Share - Workspace - Weak-hands buster - BTC - 1hr.json```. To do that, follow the instructions above to drag one of the files from the ```Superalgos Desktop App/Quick-Start-Examples``` folder and drop it in the *Designer* section of the app. + +**2. Start processes**: | Task Manager | Definition | | :---: | :---: | From 72d1ff9d063cf50e7c1002d2b1493e3ada4dc224 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 18:01:02 +0200 Subject: [PATCH 05/13] Update README.md --- README.md | 42 +++++++++++++++++++++++++++++++----------- 1 file changed, 31 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index df46b39e7..53d5b4bd6 100644 --- a/README.md +++ b/README.md @@ -171,7 +171,7 @@ You should end up with the following folder structure: ### Running the App -**1. Use the executable file to run the app** +**1. Use the executable file to run the app**: Go to the ```Superalgos Desktop App``` folder and double click on ```Superalgos.exe``` (for Windows systems) or ```Superalgos.app``` (for Mac systems). @@ -193,7 +193,7 @@ Available Quick Start Examples: **```Share - Workspace - Weak-hands buster - BTC - 1hr.json```**: A functional BTC-based strategy designed for accumulating bitcoin during bear markets or market consolidation situations. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-BTC-WeakHandsBuster](https://github.com/Superalgos/Strategy-BTC-WeakHandsBuster) repository. -**```Share - Workspace - Empty Strategy Structure Template.json```**: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. **You will not be able to run backtest or trade live with this template, until you set up your strategy.** +**```Share - Workspace - Empty Strategy Structure Template.json```**: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. **You will not be able to run a backtest or trade live with this template, until you set up your strategy.** That's it! You are up and running! @@ -207,30 +207,50 @@ To run your first backtest you will need a functional strategy. If you haven't yet, start by importing either ```Share - Workspace - Bull run rider - USDT- 1hr.json``` or ```Share - Workspace - Weak-hands buster - BTC - 1hr.json```. To do that, follow the instructions above to drag one of the files from the ```Superalgos Desktop App/Quick-Start-Examples``` folder and drop it in the *Designer* section of the app. -**2. Start processes**: +**2. Start processes**: | Task Manager | Definition | | :---: | :---: | | ![parameters](https://user-images.githubusercontent.com/13994516/63508921-3f46d780-c4db-11e9-970d-8d5e2ca5ebe3.png) | ![definition](https://user-images.githubusercontent.com/13994516/63503991-deb29d00-c4d0-11e9-8c03-bf2e618f9ef6.png) | -Open up the Designer section of the app by dragging the horizontal bar upwards and locate the Task Manager element connected to the Definition element. Then, hover your mouse pointer over the Task Manager element and click ```Run All Tasks``` in the menu. +Open up the Designer section of the app by dragging the horizontal bar upwards and locate the two Task Manager elements connected to the Definition element on the left hand side of the screen. -> To move around the Designer, click on the black background and drag to pan in any direction. +> To move around the Designer, click on the black background and drag to pan in the desired direction. -You will find the Task Manager element in the following position: +Then, hover your mouse pointer over either of the Task Manager elements and click ```Run All Tasks``` in the menu. You will not see any immediate effect in your broswer, but if you take a look at the Console, you will notice activity indicating that several processes are running. -[PNG ILLUSTRATION PLACEHOLDER] +Do the same with the second Task Manager element. -Click the RESTART SIMULATION button on the right-hand side of the horizontal turquoise bar. This puts all indicator bots to run. The data files you downloaded contain data files up to a certain point in time. You will need to allow some time for bots to catch up with building candles and the rest of indicators up to the present time. After a few minutes, refresh the candles layers as explained in the [Layers Panel](#layers-panel) section. +[ILLUSTRATION PLACEHOLDER] -That's it! You are up and running! - -> **NOTES ON MARKET DATA AND WAITING-TIME FOR THE FIRST RUN**: The first simulation will not show on screen until the bots processing exchange data and building indicators datasets are up to date. In our experience, it may take between 10 to 20 minutes per day worth of Poloniex data to be processed. The time it will take for these processes to complete the job depends on several things: +> **NOTES ON MARKET DATA**: You just started the *Trading Engine* along with the *sensors* that extract live data from the exchange and the *inidicators* that process raw trades data. These processes will remain running for as long as you keep the browser open running the app. The bots processing exchange data and building indicators datasets will work to bring your data up to date. In our experience, it may take between 10 to 20 minutes per day worth of Poloniex data to be processed. The time it will take for these processes to complete the job depends on several things: > * The date of the release tells you how many days you are behind with the data set you just downloaded. > * The speed and processing power of your machine will make a difference too. > * The average number of trades per day at the exchange determines the volume of data the app needs to retrieve and process. > * The number of trades the exchange returns per each request determines the size of the pipeline the exchanges allow API users to use. +**3. Run your first backtest**: + +Pull down the horizontal bar to go to the charts and make sure you are standing in the 1 hr (one hour) time period. Notice the time period banner in the bottom of the charts: + +[ILLUSTRATION PLACEHOLDER] + +If you are not, use the wheel of your mouse while pointing at the charts to scroll into the 1 hr time period. You do this so that the backtest runs in the time period for which the strategy was designed. + +No you are ready to click the START BACKTESTING button on the right hand side of the horizontal bar. + +[ILLUSTRATION PLACEHOLDER] + +Once you click the button, it will turn yellow. It may take several minutes for the Trading Engine to do the calculations and get ready to present the simulation over the charts. Once the Trading Engine finishes, the button will turn back to its normal state. That means that you may now turn on the simulation layers in the Layers Panel. + +[ILLUSTRATION PLACEHOLDER] + +You may now navigate the charts by clicking and dragging, or by zooming in and out with the wheel of your mouse. If you change the time period, you will not see the simulated data, as each time period may hold its own simulation. + +Congratulations! You've run your first simulation! + +The rest of this README file contains all the information you need to build your own strategies, modify, test and use existing ones, and eventually start trading live. + # Upgrading Your Existing Installation You should expect patches and even new releases to become available regularly. Appropriate notices will be placed on the [Official Superalgos Telegram Announcements Channel](https://t.me/superalgos), which will be forwarded to the several Community groups when this happens. From 89a40c60c64dfbf362ca3488da1ffecde8f966ff Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 19:16:58 +0200 Subject: [PATCH 06/13] Update README.md --- README.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 53d5b4bd6..2447c6a6f 100644 --- a/README.md +++ b/README.md @@ -141,15 +141,15 @@ Go to the [latest Superalgos Desktop App release](https://github.com/Superalgos/ **2. Extract the ZIP file**: -How you extract/unpack the files depends on the software you use to handle ZIP files. Double clicking the ZIP file should work in most scenarios, however, some systems may "open" the file instead of "extracting" it. Make sure you are "extracting" and not just "opening" the file. You may also right-click the file and check the options available on the pop-up menu. +How you extract/unpack the files depends on the software you use to handle ZIP files. Double-clicking the ZIP file should work in most scenarios, however, some systems may "open" the file instead of "extracting" it. Make sure you are "extracting" and not just "opening" the file. You may also right-click the file and check the options available on the pop-up menu. When you extract the ZIP file, a folder structure will be created with the root folder being ```Superalgos Desktop App```. -You may extract/unpack the files in any location of your drive, however, we recommend unpacking in an accesible route *(i.e.: ```C:\```)*, as you will later need to fit an additional folder inside the ```Superalgos Desktop App``` folder, and you will also need to access these folders every time you launch the app. +You may extract/unpack the files in any location of your drive, however, we recommend unpacking in an accessible route *(i.e.: ```C:\```)*, as you will later need to fit an additional folder inside the ```Superalgos Desktop App``` folder, and you will also need to access these folders every time you launch the app. **3. Download the Data Package**: -For your convenience and [for the reasons explained](https://superalgos.org/tools-superalgos-desktop-app.shtml#expectations) in the Superalgos Desktop App page on the website, we maintain a downloadable market-data file that you can download, so that you may be up and running as quickly as possible. +For your convenience and [the reasons explained](https://superalgos.org/tools-superalgos-desktop-app.shtml#expectations) in the Superalgos Desktop App page on the website, we maintain a downloadable market-data file that you can download, so that you may be up and running as quickly as possible. Go to the [latest Data release](https://github.com/Superalgos/DesktopApp/releases/tag/data.poloniex.btc.usdt.2019.09.24) and download ```Poloniex.BTC.USDT.Historic.Data.zip```. @@ -175,7 +175,7 @@ You should end up with the following folder structure: Go to the ```Superalgos Desktop App``` folder and double click on ```Superalgos.exe``` (for Windows systems) or ```Superalgos.app``` (for Mac systems). -The app will load on your default browser. You should either [set Chrome as your default browser](https://support.google.com/chrome/answer/95417?co=GENIE.Platform%3DDesktop&hl=en) before executing the file, or simply close the non-Chrome browser, open Chrome and go to http://localhost:1337/. +The app will load on your default browser. You should either [set Chrome as your default browser](https://support.google.com/chrome/answer/95417?co=GENIE.Platform%3DDesktop&hl=en) before executing the file or simply close the non-Chrome browser, open Chrome and go to http://localhost:1337/. Also, a Console/Command Line window will open. The Console must be open for as long as the app is running. Do not close the window or stop the processes running on it. You may minimize the Console if your Operating System allows you to do so. @@ -193,7 +193,7 @@ Available Quick Start Examples: **```Share - Workspace - Weak-hands buster - BTC - 1hr.json```**: A functional BTC-based strategy designed for accumulating bitcoin during bear markets or market consolidation situations. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-BTC-WeakHandsBuster](https://github.com/Superalgos/Strategy-BTC-WeakHandsBuster) repository. -**```Share - Workspace - Empty Strategy Structure Template.json```**: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. **You will not be able to run a backtest or trade live with this template, until you set up your strategy.** +**```Share - Workspace - Empty Strategy Structure Template.json```**: A template containing the minimum set of elements required to build your own strategy. Elements are empty (undefined); this is just the structure that will guide you through the process of building your strategy. **You will not be able to run a backtest or trade live with this template until you set up your strategy.** That's it! You are up and running! @@ -213,17 +213,17 @@ If you haven't yet, start by importing either ```Share - Workspace - Bull run ri | :---: | :---: | | ![parameters](https://user-images.githubusercontent.com/13994516/63508921-3f46d780-c4db-11e9-970d-8d5e2ca5ebe3.png) | ![definition](https://user-images.githubusercontent.com/13994516/63503991-deb29d00-c4d0-11e9-8c03-bf2e618f9ef6.png) | -Open up the Designer section of the app by dragging the horizontal bar upwards and locate the two Task Manager elements connected to the Definition element on the left hand side of the screen. +Open up the Designer section of the app by dragging the horizontal bar upwards and locate the two Task Manager elements connected to the Definition element on the left-hand side of the screen. > To move around the Designer, click on the black background and drag to pan in the desired direction. -Then, hover your mouse pointer over either of the Task Manager elements and click ```Run All Tasks``` in the menu. You will not see any immediate effect in your broswer, but if you take a look at the Console, you will notice activity indicating that several processes are running. +Then, hover your mouse pointer over either of the Task Manager elements and click ```Run All Tasks``` in the menu. You will not see any immediate effect in your browser, but if you take a look at the Console, you will notice activity indicating that several processes are running. Do the same with the second Task Manager element. [ILLUSTRATION PLACEHOLDER] -> **NOTES ON MARKET DATA**: You just started the *Trading Engine* along with the *sensors* that extract live data from the exchange and the *inidicators* that process raw trades data. These processes will remain running for as long as you keep the browser open running the app. The bots processing exchange data and building indicators datasets will work to bring your data up to date. In our experience, it may take between 10 to 20 minutes per day worth of Poloniex data to be processed. The time it will take for these processes to complete the job depends on several things: +> **NOTES ON MARKET DATA**: You just started the *Trading Engine* along with the *sensors* that extract live data from the exchange and the *indicators* that process raw trades data. These processes will remain running for as long as you keep the browser open running the app. The bots processing exchange data and building indicators datasets will work to bring your data up to date. In our experience, it may take between 10 to 20 minutes per day worth of Poloniex data to be processed. The time it will take for these processes to complete the job depends on several things: > * The date of the release tells you how many days you are behind with the data set you just downloaded. > * The speed and processing power of your machine will make a difference too. > * The average number of trades per day at the exchange determines the volume of data the app needs to retrieve and process. @@ -231,13 +231,13 @@ Do the same with the second Task Manager element. **3. Run your first backtest**: -Pull down the horizontal bar to go to the charts and make sure you are standing in the 1 hr (one hour) time period. Notice the time period banner in the bottom of the charts: +Pull down the horizontal bar to go to the charts and make sure you are standing in the 1 hr (one hour) time period. Notice the time period banner at the bottom of the charts: [ILLUSTRATION PLACEHOLDER] If you are not, use the wheel of your mouse while pointing at the charts to scroll into the 1 hr time period. You do this so that the backtest runs in the time period for which the strategy was designed. -No you are ready to click the START BACKTESTING button on the right hand side of the horizontal bar. +You are now ready to click the START BACKTESTING button on the right-hand side of the horizontal bar. [ILLUSTRATION PLACEHOLDER] From de100b685eb7b554639bb098271b8597ed71f40d Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 19:32:03 +0200 Subject: [PATCH 07/13] Update README.md --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 2447c6a6f..c4c66c08a 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ Please refer to the [Superalgos Desktop App](https://superalgos.org/tools-supera * [The Extended Version for Regular Folks on Windows and Mac](#the-extended-version-for-regular-folks-on-windows-and-mac) * [Downloads](#downloads/) * [Running the App](#running-the-app) + * [Running Your First Backtest](#running-your-first-backtest) * [Upgrading Your Existing Installation](#upgrading-your-existing-installation) * [Overview](#overview) * [Charts Interface](#charts-interface) @@ -187,7 +188,7 @@ Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag your pr ![Installation-Drag-Workspace](https://user-images.githubusercontent.com/13994516/64358772-5ae7cd00-d007-11e9-9250-77540cc351c8.gif) -Available Quick Start Examples: +**Available Quick Start Examples**: **```Share - Workspace - Bull run rider - USDT- 1hr.json```**: A functional USDT-based strategy designed for bull markets. You will be able to run a backtest and see the strategy in action if you use this template. All details about the strategy may be found in the [Superalgos/Strategy-USDT-BullRunRider](https://github.com/Superalgos/Strategy-USDT-BullRunRider) repository. @@ -257,17 +258,17 @@ You should expect patches and even new releases to become available regularly. A If you have a version of the Superalgos Desktop App and wish to upgrade to a new version you should do the following: -**1.** Stop the app by closing your browser and the Console/Command Line running the programs. +**1.** Stop the app by closing your browser. Allow a minute or two until no activity stops before closing the Console/Command Line running the programs. **2.** Make sure you are not storing any personal files, such as your Workspace backups and so on in your ```Superalgos Desktop App``` folders. Move them to a different location if you are. -**3.** Delete all folders within the Superalgos Desktop App folder **but the ```Data-Storage``` folder**. You do not need to get rid of the historic market data every time you upgrade your app. Do **not** delete your ```Data-Storage``` folder. +**3.** You will keep the ```Data-Storage``` folder intact and delete all the remaining folders within the ```Superalgos Desktop App``` folder. You do not need to get rid of the historic market data every time you upgrade your app. **Do not delete your ```Data-Storage``` folder**. **4.** Download the latest patch or latest release from the location advertised in the Official Announcement Channel. > **WARNING**: Always beware of what random people may post in open Telegram groups or forums. Patches and releases will always be made available at the [Releases page](https://github.com/Superalgos/DesktopApp/releases) of this repository only. -**5.** Extract/unpack the contents of the ZIP file directly into the ```Superalgos Desktop App``` folder. That's it. You are up and running with the new version. Simply start the app the same way you always do. +**5.** Extract/unpack the contents of the ZIP file directly into the ```Superalgos Desktop App``` folder. That's it. You are up and running with the new version. Simply start the app the same way you always do unless new instructions become available in this README file. # Overview From b3519ac7bb02e1da263a1cada98aef2faa055863 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 20:05:53 +0200 Subject: [PATCH 08/13] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c4c66c08a..36b1598a3 100644 --- a/README.md +++ b/README.md @@ -212,7 +212,7 @@ If you haven't yet, start by importing either ```Share - Workspace - Bull run ri | Task Manager | Definition | | :---: | :---: | -| ![parameters](https://user-images.githubusercontent.com/13994516/63508921-3f46d780-c4db-11e9-970d-8d5e2ca5ebe3.png) | ![definition](https://user-images.githubusercontent.com/13994516/63503991-deb29d00-c4d0-11e9-8c03-bf2e618f9ef6.png) | +| ![task](https://user-images.githubusercontent.com/13994516/65537996-a99dce00-df06-11e9-8f02-0bd0fd6d29dd.png) | ![definition](https://user-images.githubusercontent.com/13994516/63503991-deb29d00-c4d0-11e9-8c03-bf2e618f9ef6.png) | Open up the Designer section of the app by dragging the horizontal bar upwards and locate the two Task Manager elements connected to the Definition element on the left-hand side of the screen. From c319d5e6e0c59e024a0cc91d9201b7c518e33d75 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Tue, 24 Sep 2019 21:43:27 +0200 Subject: [PATCH 09/13] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 36b1598a3..652aa15fe 100644 --- a/README.md +++ b/README.md @@ -232,7 +232,7 @@ Do the same with the second Task Manager element. **3. Run your first backtest**: -Pull down the horizontal bar to go to the charts and make sure you are standing in the 1 hr (one hour) time period. Notice the time period banner at the bottom of the charts: +Pull down the horizontal bar to go to the charts and make sure you are standing in the 1 hr (one hour) time period. Notice the time box at the bottom of the charts: [ILLUSTRATION PLACEHOLDER] From 799976b29a1abad81b3704d84ca0e4edf3074f3e Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Wed, 25 Sep 2019 13:17:09 +0200 Subject: [PATCH 10/13] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 652aa15fe..1713f6ebc 100644 --- a/README.md +++ b/README.md @@ -186,7 +186,7 @@ Also, a Console/Command Line window will open. The Console must be open for as l Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag your preferred example file and drop it on the _Designer_ (the area with a black background in the bottom half of the screen) to start with a working template. -![Installation-Drag-Workspace](https://user-images.githubusercontent.com/13994516/64358772-5ae7cd00-d007-11e9-9250-77540cc351c8.gif) +![Designer-Import-Workspace](https://user-images.githubusercontent.com/13994516/65596166-9e927e80-df96-11e9-9cc0-ee9885d3b45f.gif) **Available Quick Start Examples**: @@ -204,7 +204,7 @@ Now you are ready to learn the basic operation of the app so that you may run yo To run your first backtest you will need a functional strategy. -**1. Import the right template** +**1. Import the right template**: If you haven't yet, start by importing either ```Share - Workspace - Bull run rider - USDT- 1hr.json``` or ```Share - Workspace - Weak-hands buster - BTC - 1hr.json```. To do that, follow the instructions above to drag one of the files from the ```Superalgos Desktop App/Quick-Start-Examples``` folder and drop it in the *Designer* section of the app. @@ -222,7 +222,7 @@ Then, hover your mouse pointer over either of the Task Manager elements and clic Do the same with the second Task Manager element. -[ILLUSTRATION PLACEHOLDER] +![Designer-Start-Processes](https://user-images.githubusercontent.com/13994516/65596168-9f2b1500-df96-11e9-9559-7395124c00a0.gif) > **NOTES ON MARKET DATA**: You just started the *Trading Engine* along with the *sensors* that extract live data from the exchange and the *indicators* that process raw trades data. These processes will remain running for as long as you keep the browser open running the app. The bots processing exchange data and building indicators datasets will work to bring your data up to date. In our experience, it may take between 10 to 20 minutes per day worth of Poloniex data to be processed. The time it will take for these processes to complete the job depends on several things: > * The date of the release tells you how many days you are behind with the data set you just downloaded. From d1fa50591734b037314b36c8723c1e880688a7ec Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Wed, 25 Sep 2019 13:30:55 +0200 Subject: [PATCH 11/13] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1713f6ebc..2e733cd4f 100644 --- a/README.md +++ b/README.md @@ -186,7 +186,7 @@ Also, a Console/Command Line window will open. The Console must be open for as l Go to the ```Superalgos Desktop App/Quick-Start-Examples``` folder, drag your preferred example file and drop it on the _Designer_ (the area with a black background in the bottom half of the screen) to start with a working template. -![Designer-Import-Workspace](https://user-images.githubusercontent.com/13994516/65596166-9e927e80-df96-11e9-9cc0-ee9885d3b45f.gif) +![Designer-Import-Workspace](https://user-images.githubusercontent.com/13994516/65597108-a5ba8c00-df98-11e9-812d-b1e3c17ba4c8.gif) **Available Quick Start Examples**: From 9d0d82d69f017b2ed9a43db270d8c39893308d9c Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Wed, 25 Sep 2019 13:53:23 +0200 Subject: [PATCH 12/13] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2e733cd4f..b1ce4f558 100644 --- a/README.md +++ b/README.md @@ -234,13 +234,13 @@ Do the same with the second Task Manager element. Pull down the horizontal bar to go to the charts and make sure you are standing in the 1 hr (one hour) time period. Notice the time box at the bottom of the charts: -[ILLUSTRATION PLACEHOLDER] +![Getting-Started-Charts-Time-Period](https://user-images.githubusercontent.com/13994516/65598453-c0423480-df9b-11e9-9346-04631dd9719e.gif) If you are not, use the wheel of your mouse while pointing at the charts to scroll into the 1 hr time period. You do this so that the backtest runs in the time period for which the strategy was designed. You are now ready to click the START BACKTESTING button on the right-hand side of the horizontal bar. -[ILLUSTRATION PLACEHOLDER] +![Getting-Started-Backtesting](https://user-images.githubusercontent.com/13994516/65598454-c0dacb00-df9b-11e9-8e58-a149b0bffef7.gif) Once you click the button, it will turn yellow. It may take several minutes for the Trading Engine to do the calculations and get ready to present the simulation over the charts. Once the Trading Engine finishes, the button will turn back to its normal state. That means that you may now turn on the simulation layers in the Layers Panel. From 80fa5ab3a686fe7664508635df94efc2c3eb97dc Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Wed, 25 Sep 2019 14:00:59 +0200 Subject: [PATCH 13/13] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b1ce4f558..93569d67c 100644 --- a/README.md +++ b/README.md @@ -244,7 +244,7 @@ You are now ready to click the START BACKTESTING button on the right-hand side o Once you click the button, it will turn yellow. It may take several minutes for the Trading Engine to do the calculations and get ready to present the simulation over the charts. Once the Trading Engine finishes, the button will turn back to its normal state. That means that you may now turn on the simulation layers in the Layers Panel. -[ILLUSTRATION PLACEHOLDER] +![Getting-Started-Backtesting02](https://user-images.githubusercontent.com/13994516/65598904-c97fd100-df9c-11e9-93f4-324979e67a2d.gif) You may now navigate the charts by clicking and dragging, or by zooming in and out with the wheel of your mouse. If you change the time period, you will not see the simulated data, as each time period may hold its own simulation.