README for Osdag installation and use
======================================
 
System Requirements:
====================    
    Supported Operating Systems:
        Windows Vista
        Windows 7,
        Windows 8,
        Windows 8.1,
        Windows 10
    Supported Architecture:
             64-bit
    RAM and Storage Space:
        Minimum 2 Gb RAM recommended
        Minimum 4 Gb free storage space recommended        
        
================================================================================================
================================================================================================
Basic User:
===========
 # If you have already installed the  previous version of Osdag in your system then skip step 1) & 2) and just run the new downloaded Osdag_setup_x86.exe.

    Installation steps:
    ===================
    # See Advanced-User section below, before you execute these steps.
    1) Run Miniconda2-latest-Windows-x86.exe
        # Follow on-screen instructions AND select the following options in the Setup:
        a) Install for: [All Users (requires admin privileges)]
        b) Destination Folder: ["C:\Program Files (x86)\Miniconda2"]
				1. After selecting the “Program Files (x86)\” directory, manually type “Miniconda2” (without quotes)
				2. If an error message appears saying, “The installation directory has 2 spaces”, ignore it by clicking OK.
        c) Advanced Options: Check both the options:
            i) Add Anaconda to my PATH environment variable
            ii) Register Anaconda as my default Python 2.7            
    2) Run Osdag_setup_x86.exe    and follow on-screen instructions
        # The default directory to install Osdag is the User’s Desktop.  
        You may choose any other location. However, DO NOT choose any of the following locations:
            a) Program Files  
            b) Program Files (x86)
            c) ProgramData
    
    Running Osdag:
    ==============
    After the installation is complete, you may run Osdag by one of the following methods:
        i) double-clicking on the Desktop shortcut or
        ii) double-clicking on the Start Menu shortcut or
        iii) navigating to the installation-directory and double-clicking on the Osdag shortcut
    
================================================================================================
================================================================================================
Advanced User:
==============
    Criteria:
    =========
    If you satisfy one of the following two conditions, then you will need to follow a different installation procedure.  
    Condition a) You already use Anaconda/Miniconda
    Condition b) You have already installed a version of python on your computer AND you wish to keep that as the system default instead of the Miniconda(/Anaconda)-python
    
    Installation:
    =============
    1) Run wkhtmltox-0.12.4_msvc2015-win32.exe
        # Follow on-screen instructions AND select the following option in the Setup:
        a) Destination Folder: ["C:\Program Files (x86)\wkhtmltopdf"]
        
    2) Miniconda
        a) If you already are a Miniconda/Anaconda user:-
            i) Navigate to the "dependencies" folder in the installation-directory
            ii) Open the "install_osdag_dependencies.bat" in a text editor and  
            iii) Manually install the missing python packages listed in the .bat file, through conda.            
            iv) In Step 3 ("Run Osdag_setup_x86"), when the installer prompts if you have Miniconda installed, just close the window and let the installer continue.
        b) If you do not have Miniconda installed and are OK with installing it and but do not wish to Register Anaconda as the default Python 2.7:
            i) First install Miniconda2-latest-Windows-x86.exe (same as the basic user) BUT follow the steps in the "Running Osdag" section below, instead of the "Running Osdag" steps of the basic user.
    3) Run Osdag_setup_x86.exe and follow on-screen instructions
        # The default directory to install Osdag is the User Desktop.  
        You may choose any other location. However, DO NOT choose any of the following locations:
            a) Program Files  
            b) Program Files (x86)
            c) ProgramData    
    
    Running Osdag:
    =============
    You need navigate to the Osdag-installation folder, in a command prompt, and use the following command to run Osdag:
        python osdagMainPage.py
        # You need to replace 'python' in the above command with python from the miniconda-package, if you opted not to register it as the system default python
    You may choose to create a batch file that contains the above command and create a shortcut to Run Osdag.
================================================================================================
================================================================================================
