Windows Installation: Difference between revisions

From Global Meteor Network
Jump to navigation Jump to search
No edit summary
No edit summary
 
(14 intermediate revisions by 2 users 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 ==
=== install MS Visual Studio Build Tools ===
=== install MS Visual Studio Build Tools ===
* Download Microsoft Build Tools for Visual Studio 2019.
(updated Nov 2021)
https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019


* Run the installer.
* Download Visual Studio 2022 Community Edition.
* In the left panel, under Desktop & Mobile make sure C++ Build tools is ticked
https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019. (this now takes you to the Visual Studio 2022 installation page)


* On the right panel ensure the latest versions of MSVCv142 - VS 2019 C++ x64/x86 build tools and Windows 10 SDK are checked.
* Click the "Free Download" button to install Community edition. This will download and run the installer.
* Click install.  Its a 1.5GB package so it'll take a while.  
* In the left panel, select Desktop Development with C++.
* ''Note that you do not need python development''.
* On the right panel ensure the latest versions of MSVC v143 - VS 2022 C++ x64/x86 build tools and Windows 10 SDK are selected. This should be automatic. You can also select CLI Tools.  
 
* Click install.  Its a '''10.5GB''' package so it'll take a while.


=== Install Anaconda for Windows ===
=== Install Anaconda for Windows ===
Line 22: Line 26:
=== Install Git for Windows ===
=== Install Git for Windows ===
* Download Git from here https://git-scm.com/download/win
* Download Git from here https://git-scm.com/download/win
* Again, select the default options unless you have some specific requirement.  
* Again, select the default options unless you have some specific requirement.


== 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 45:
* 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>
cd RMS
conda install -c conda-forge PyGObject
pip install -r requirements.txt
pip install -r requirements.txt
pip install PyQt5
pip install PyQt5
pip install opencv_python
pip install opencv_python
pip install rawpy
</pre>
</pre>


Line 58: Line 65:
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 ==
That's it! Any time you want to run RMS you just
That's it! Any time you want to run RMS you just
* open an Anaconda Powershell window
* open an Anaconda Powershell prompt
* change directory to the RMS folder
* change directory to the RMS folder
* activate the virtual environment
* activate the virtual environment
<pre> conda activate RMS</pre>
<pre> conda activate RMS</pre>
* and then run the module you want to use.
* and then run the module you want to use.

Latest revision as of 03:56, 1 May 2024

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

(updated Nov 2021)

  • Download Visual Studio 2022 Community Edition.

https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019. (this now takes you to the Visual Studio 2022 installation page)

  • Click the "Free Download" button to install Community edition. This will download and run the installer.
  • In the left panel, select Desktop Development with C++.
  • Note that you do not need python development.
  • On the right panel ensure the latest versions of MSVC v143 - VS 2022 C++ x64/x86 build tools and Windows 10 SDK are selected. This should be automatic. You can also select CLI Tools.
  • Click install. Its a 10.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:
cd RMS
conda install -c conda-forge PyGObject
pip install -r requirements.txt
pip install PyQt5
pip install opencv_python
pip install rawpy

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.