... | ... | @@ -9,52 +9,25 @@ The MP Gryphon toolset consists of the following: |
|
|
Gryphon is compatible with Mac, Windows, and Ubuntu Linux. For Mac and Windows, trace generation is performed on a remote server inside the NPS VPN. These users must have a VPN connection to NPS. For Linux, trace generation is performed locally. Linux users do not need to be connected to NPS by VPN.
|
|
|
|
|
|
# Installing Gryphon
|
|
|
## Windows:
|
|
|
* **Windows, Mac M1, and Mac X86** installations currently require access to the Gryphon server on the NPS Intranet to generate traces. If you are outside the NPS Intranet, you must use GlobalProtect (VPN) to reach the Gryphon server in order to generate traces.
|
|
|
* **Linux** installations have the trace generator built in so Linux users can generate traces without being connected to the NPS Intranet or even the Internet.
|
|
|
|
|
|
1. Download the latest Gryphon Windows executable from https://nps01-my.sharepoint.com/:f:/g/personal/bdallen_nps_edu/EuooSvkrwFtPkXBgGqBVcN4BpyrDCm7lz3vVaR9QcZ5tJQ?e=MJjt3e.
|
|
|
## Windows, Mac M1, Mac X86:
|
|
|
**NOTE: Mac X86 is not available yet.**
|
|
|
1. Download the latest Gryphon executable for your operating system from https://nps01-my.sharepoint.com/:f:/g/personal/bdallen_nps_edu/EuooSvkrwFtPkXBgGqBVcN4BpyrDCm7lz3vVaR9QcZ5tJQ?e=MJjt3e.
|
|
|
1. Download the preloaded examples from the MP models collection, also from https://nps01-my.sharepoint.com/:f:/g/personal/bdallen_nps_edu/EuooSvkrwFtPkXBgGqBVcN4BpyrDCm7lz3vVaR9QcZ5tJQ?e=MJjt3e.
|
|
|
1. Unzip the models collection. Rename the folder, if desired, from `preloaded-examples-master` to `preloaded-examples`.
|
|
|
1. Click on the MP Gryphon icon to run Gryphon.
|
|
|
1. When Gryphon starts, set the preloaded examples path to the path where you unzipped the preloaded examples. You may change the preloaded examples path using the `Settings | Preloaded Examples Path...` menu option.
|
|
|
|
|
|
## Mac
|
|
|
This process will be changed to be similar to that for installing Windows.
|
|
|
1. Install the latest Python from python.org/downloads. When installing, check the option for adding Python to PATH. Verify the installation by opening a fresh command window and typing:
|
|
|
|
|
|
python --version
|
|
|
|
|
|
and observing version information being printed back.
|
|
|
1. Download the compressed zip of the Gryphon tool by browsing to https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/ and clicking the download icon near the upper right: ![download](uploads/509a7e72dfa75dded2c31b3cb70d0fdc/download.png).
|
|
|
1. Unzip the compressed zip package to a folder and note the path to it.
|
|
|
1. Download the compressed zip of the preloaded examples by browsing to https://gitlab.nps.edu/monterey-phoenix/mp-model-collection/preloaded-examples and clicking the download icon near the upper right: ![download](uploads/509a7e72dfa75dded2c31b3cb70d0fdc/download.png).
|
|
|
1. Unzip the compressed zip package to a folder and note the path to it.
|
|
|
1. Create a new folder in your home directory and name it `mp_gryphon`.
|
|
|
1. Move the `gryphon` folder and the `preloaded-examples` folders into the `mp_gryphon` folder.
|
|
|
1. Install requisite packages. Open a terminal emulator command window, ![terminal_emulator](uploads/2e92ad4cfa2db13bd7f47976ca2c184d/terminal_emulator.png), and type:
|
|
|
|
|
|
pip install --upgrade pip
|
|
|
pip install PySide6
|
|
|
pip install qdarkstyle
|
|
|
|
|
|
if `pip` doesn't work, try `pip3`.
|
|
|
|
|
|
## Ubuntu Linux
|
|
|
Download the installer from https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash. Use a command window, Install Gryphon by typing commands in a command window. Open a command window, ![terminal_emulator](uploads/2e92ad4cfa2db13bd7f47976ca2c184d/terminal_emulator.png), and type this to make it executable and to run it:
|
|
|
Download the MP Gryphon installer from https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash. Make the installer executable and then run it by typing this in a command window ![terminal_emulator](uploads/2e92ad4cfa2db13bd7f47976ca2c184d/terminal_emulator.png):
|
|
|
|
|
|
cd ~/Downloads
|
|
|
chmod +x install_mp.bash
|
|
|
./install_mp.bash ubuntu
|
|
|
|
|
|
# Running Gryphon
|
|
|
Run Gryphon from a command window. Open a command window and type commands to navigate to the folder containing the Gryphon tool and to run it:
|
|
|
## Windows
|
|
|
Move to the Gryphon\python folder and then run Gryphon:
|
|
|
|
|
|
chdir mp_gryphon\gryphon\python
|
|
|
python mp.py
|
|
|
|
|
|
## Mac/Ubuntu Linux
|
|
|
Move to the Gryphon/python folder and then run Gryphon:
|
|
|
Once installed, run Gryphon from a command window by changing to the directory conatining the Gryphon tool and running it:
|
|
|
|
|
|
cd ~/mp_gryphon/gryphon/python
|
|
|
./mp.py
|
... | ... | |