Install git (https://git-scm.com/downloads)
Install 7-Zip (https://www.7-zip.org/)
Install Anaconda (https://www.anaconda.com/download/)
Be sure to enable the "Add Anaconda3 to my PATH environment variable" option during the installation.
Download MinGW (https://winlibs.com/#download-release)
Select UCRTG runtime GCC 13.2.0 (with POSIX threads) + LLVM/Clang/LLD/LLDB 17.0.6 + MinGW-w64 11.0.1 (UCRT) - release 5 Win64 7-Zip archive.
Open winlibs-x86_64-... using 7-Zip File Manager and extract the mingw64 folder.
Inside C:/, create a new MinGW folder. Move the mingw64 folder inside the MinGW folder.
You now should have a C:/MinGW/mingw64/bin folder and a C:/MinGW/mingw64/lib folder, along other files.
Be sure to add C:\MinGW\mingw64\bin and C:\MinGW\mingw64\lib to Path in the environment variables.
Create a new conda environment with python version 3.11, using the following commands:
conda update -n base -c defaults conda
conda create -n rocket python=3.11
conda activate rocket
Install python requirements:
pip install -r requirements.txt
You can check if rocketcea has been successfully installed using the following command:
python -c "from rocketcea.cea_obj import CEA_Obj; C=CEA_Obj(oxName='LOX', fuelName='LH2'); print(C.get_Isp())"
Its output must be about 374.303617.
Now you should be able to run python code. If you want to build it into an executable file, read the following steps.
Install PyInstaller from source:
git clone https://github.com/pyinstaller/pyinstaller.git
cd pyinstaller
pip install .
Build PyInstaller bootloader using the MinGW-w64 suite as described in https://pyinstaller.org/en/stable/bootloader-building.html
cd bootloader
python waf --gcc configure all
Find python libraries installation folder. It will be displayed after "Location: " in the output of the following command:
pip show rocketcea
Assign a temporary variable to that folder:
SET "FOLDER=C:\path\to\that\folder"
Be sure to disable antivirus for the Rocket Forge installation folder.
Use PyInstaller inside the Rocket Forge installation folder to compile the software using the %FOLDER% variable:
pyinstaller --windowed --onefile --add-data "%FOLDER%/rocketcea:rocketcea/" --add-data "%FOLDER%/rocketprops:rocketprops/" --add-data "%FOLDER%/rocketpy:rocketpy/" --add-data "%FOLDER%/pyvista:pyvista/" --add-data "%FOLDER%/customtkinter:customtkinter/" --add-data "%FOLDER%/PIL:PIL/" --add-data "rocketforge/resources:rocketforge/resources/" --add-data "theme.json:." --icon=rocketforge/resources/icon.png -n "Rocket Forge" --clean main.py
Executable file will be built inside the dist folder. To build an updated version of the executable, just use:
pyinstaller "Rocket Forge.spec"
Open Terminal.
Type the following command to install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Type the following commands to add Homebrew to PATH, replace username with your computer username:
(echo; echo 'eval "$(/usr/local/bin/brew shellenv)"') >> /Users/username/.zprofile
eval "$(/usr/local/bin/brew shellenv)"
Type the following commands to install git, GitHub command-line tool and the GCC compiler:
brew install git
brew install gh
brew install gcc
Download Miniconda3 installation script for MacOS https://docs.anaconda.com/free/miniconda/index.html (check for Intel or Apple M1 CPU).
Move to the Downloads folder inside the Terminal using the following command:
cd Downloads
Run Miniconda3 installation script using the following command:
bash Miniconda3-lastest-MacOSX-x86_64.sh
Press ENTER and type yes when needed to complete the installation. You can skip the license text by pressing q.
Close and reopen the terminal window to be able to use Miniconda.
Update conda libraries using the following command:
conda update -n base -c defaults conda
Create and activate a new virtual environment with Python 3.11 using the following commands:
conda create -n rocket python=3.11
conda activate rocket
Install python dependencies using the following commands:
pip3 install -r requirements.txt
Try a quick test of the install using the following command:
python -c "from rocketcea.cea_obj import CEA_Obj; C=CEA_Obj(oxName='LOX', fuelName='LH2'); print(C.get_Isp())"
Download Visual Studio Code https://code.visualstudio.com/
Install the Python extension inside Visual Studio Code.
Login in GitHub command-line tool using the following command:
gh auth login
Then select GitHub.com -> HTTPS -> Y -> Paste an authentication token and type your GitHub authentication token.
Clone the repository using the following command
git clone https://github.com/Polito-Rocket-Team/rocket-forge
Open the rocket-forge folder inside Visual Studio Code.
Use Cmd+Shift+P to open the Visual Studio Code command palette, then type and select Python: Select interpreter and choose Python 3.11.8 ("rocket").
You should now be able to run Rocket Forge using the run button in the main.py file.
Install gfortran https://fortran-lang.org/en/learn/os_setup/install_gfortran/
Install python requirements:
pip install -r requirements.txt
Assign a temporary variable to python libraries folder:
FOLDER=/path/to/your/python/libraries/folder
Use PyInstaller to compile the software using the $FOLDER variable:
pyinstaller --windowed --onefile --add-data "$FOLDER/rocketcea:rocketcea/" --add-data "$FOLDER/rocketprops:rocketprops/" --add-data "$FOLDER/rocketpy:rocketpy/" --add-data "$FOLDER/pyvista:pyvista/" --add-data "$FOLDER/vtkmodules:vtkmodules/" --add-data "$FOLDER/customtkinter:customtkinter/" --add-data "$FOLDER/PIL:PIL/" --add-data "rocketforge/resources:rocketforge/resources/" --add-data "theme.json:." --icon=rocketforge/resources/icon.png -n "Rocket Forge" --clean main.py
Executable file will be built inside the dist folder. To build an updated version of the executable, just use:
pyinstaller "Rocket Forge.spec"