Windows Installation: Difference between revisions

From Global Meteor Network
Jump to navigation Jump to search
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Brief Instructions =
= Basic Instructions =
There are more detailed instructions, with pictures, [[Detailed_Windows_Installation|here]] but the below should work for most users.


Note: you will need about 2.5GB of space on your hard disk for the support tools.  
'''Note: you will need about 2.5GB of space on your hard disk for the support tools. '''


== Install Required Tools ==
== Install Required Tools ==
Line 9: Line 10:


* Run the installer.
* Run the installer.
* In the left panel, under Desktop & Mobile make sure C++ Build tools is ticked
* In the left panel, under Desktop & Mobile ensure C++ Build tools are selected.


* On the right panel ensure the latest versions of MSVCv142 - VS 2019 C++ x64/x86 build tools and Windows 10 SDK are checked.
* On the right panel ensure the latest versions of MSVCv142 - VS 2019 C++ x64/x86 build tools and Windows 10 SDK are selected.
* Click install.  Its a 1.5GB package so it'll take a while.  
* Click install.  Its a 1.5GB package so it'll take a while.


=== Install Anaconda for Windows ===
=== Install Anaconda for Windows ===
Line 26: Line 27:
== Download RMS and Set it Up ==
== Download RMS and Set it Up ==
=== Clone the RMS code to your PC ===
=== Clone the RMS code to your PC ===
* Open an Anaconda Powershell prompt and change directory to the place you want to keep the code.
* From the Start Menu, open an Anaconda Powershell prompt and change directory to the place you want to keep the code.
* Run this command:
* Run this command:
<pre> git clone https://github.com/CroatianMeteorNetwork/RMS.git</pre>
<pre> git clone https://github.com/CroatianMeteorNetwork/RMS.git</pre>
*This will create a new folder "RMS" containing the code.  
*This will create a new folder "RMS" containing the code.


=== Create an Anaconda virtual environment ===
=== Create an Anaconda virtual environment ===
Line 41: Line 42:
* the prompt should change to "(RMS) c:\source\" or something similar
* the prompt should change to "(RMS) c:\source\" or something similar
* change directory into the RMS folder.
* change directory into the RMS folder.
* Now install the support libraries by running these commands:
* Now install the required Python modules by running these commands:
<pre>
<pre>
pip install -r requirements.txt
pip install -r requirements.txt
Line 58: Line 59:
SkyFit2.py: error: the following arguments are required: INPUT_PATH </pre>
SkyFit2.py: error: the following arguments are required: INPUT_PATH </pre>
* This indicates that RMS is installed properly.  
* This indicates that RMS is installed properly.  
== Setting RMS up for your Cameras ==
RMS reads its settings from a hidden file '''.config''' which is in the folder /home/pi/source/RMS on each Pi, and is also copied to the ArchivedFiles/ folder containing the night's data. You can copy this file to the RMS folder on your PC if you want.
== Update Regularly!!! ==
The RMS code is FREQUENTLY updated and so its important that you update it too. On the Pi, this is automatic but on your PC you need  to do it yourself.
To update the code, open an Anaconda Powershell window, activate the RMS environment and then type:
<pre>
git stash
git pull
git stash apply
</pre>
This will 'stash' your local changes such as the config file, pull the latest code, and then reapply your local changes.


== Thats It ==
== Thats It ==

Revision as of 17:14, 2 May 2021

Basic Instructions

There are more detailed instructions, with pictures, here but the below should work for most users.

Note: you will need about 2.5GB of space on your hard disk for the support tools.

Install Required Tools

install MS Visual Studio Build Tools

  • Download Microsoft Build Tools for Visual Studio 2019.

https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019

  • Run the installer.
  • In the left panel, under Desktop & Mobile ensure C++ Build tools are selected.
  • On the right panel ensure the latest versions of MSVCv142 - VS 2019 C++ x64/x86 build tools and Windows 10 SDK are selected.
  • Click install. Its a 1.5GB package so it'll take a while.

Install Anaconda for Windows

  • Download Anaconda from here https://www.anaconda.com/products/individual
  • Run the installer.
  • Unless you intend to use Anaconda for other python development, you can select the default options at every stage.
  • Its a 500MB download and installation may take 20-30 minutes.

Install Git for Windows

Download RMS and Set it Up

Clone the RMS code to your PC

  • From the Start Menu, open an Anaconda Powershell prompt and change directory to the place you want to keep the code.
  • Run this command:
 git clone https://github.com/CroatianMeteorNetwork/RMS.git
  • This will create a new folder "RMS" containing the code.

Create an Anaconda virtual environment

  • Still in the anaconda powershell window, type the following:
conda create -n RMS python=3.8
  • This will create a python virtual environment named "RMS" containing python 3.8

Install the required Python packages

  • Still in the anaconda powershell window type the following to activate the virtual environment:
conda activate RMS
  • the prompt should change to "(RMS) c:\source\" or something similar
  • change directory into the RMS folder.
  • Now install the required Python modules by running these commands:
pip install -r requirements.txt
pip install PyQt5
pip install opencv_python

Test RMS worked

  • To test that RMS worked, type the following in the same Window:
 python -m Utils.SkyFit2 
  • The first time you run RMS it will compile various code modules, but at the end of the process you should see this message:
usage: SkyFit2.py [-h] [-c CONFIG_PATH] [-r] [-t TIME] [-f FPS]
                  [-g CAMERA_GAMMA] [-p GEO_POINTS_PATH]
                  INPUT_PATH
SkyFit2.py: error: the following arguments are required: INPUT_PATH 
  • This indicates that RMS is installed properly.

Setting RMS up for your Cameras

RMS reads its settings from a hidden file .config which is in the folder /home/pi/source/RMS on each Pi, and is also copied to the ArchivedFiles/ folder containing the night's data. You can copy this file to the RMS folder on your PC if you want.

Update Regularly!!!

The RMS code is FREQUENTLY updated and so its important that you update it too. On the Pi, this is automatic but on your PC you need to do it yourself.

To update the code, open an Anaconda Powershell window, activate the RMS environment and then type:

git stash
git pull
git stash apply

This will 'stash' your local changes such as the config file, pull the latest code, and then reapply your local changes.

Thats It

That's it! Any time you want to run RMS you just

  • open an Anaconda Powershell prompt
  • change directory to the RMS folder
  • activate the virtual environment
 conda activate RMS
  • and then run the module you want to use.