... | @@ -6,46 +6,31 @@ The MP Gryphon toolset consists of the following: |
... | @@ -6,46 +6,31 @@ The MP Gryphon toolset consists of the following: |
|
* **Preloaded examples** - Contains examples and snippets of MP code.
|
|
* **Preloaded examples** - Contains examples and snippets of MP code.
|
|
|
|
|
|
# Compatibility
|
|
# Compatibility
|
|
Gryphon is compatible with Linux flavors and currently has limited support for Mac and Windows systems. Specifically, the trace-generator currently must be able to build and run 32-bit x86 code.
|
|
Gryphon is compatible with Mac, Windows, and Ubuntu Linux. For Mac and Windows, trace generation is performed on a remote server. For Linux, trace generation is performed locally.
|
|
|
|
|
|
* **Linux flavors** - An installer is available for several Linux flavors.
|
|
|
|
* **Mac** - An installer is available for MACs older than High Sierra 10.13.4 (click on the apple icon on the menu bar and select "About This Mac" to identify your Mac version). Newer Mac systems offer a limited read-only mode.
|
|
|
|
* **Windows** - Windows support is currently not available. MP Gryphon may be accessed on Windows using a Linux emulator, see [Running Gryphon on Windows](Running Gryphon on Windows).
|
|
|
|
|
|
|
|
# Installing Gryphon
|
|
# Installing Gryphon
|
|
The Gryphon Python GUI works in tandem with the Monterey Phoenix V4 trace generator. To install these, download the MP Gryphon installer, make it executable, and then run it:
|
|
## Windows/Mac
|
|
|
|
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:
|
|
1. Browse to https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash.
|
|
|
|
1. Click on the download icon near the upper right: ![download](uploads/509a7e72dfa75dded2c31b3cb70d0fdc/download.png) and save the installer in your Downloads folder.
|
|
|
|
1. In a terminal emulator command window ![terminal_emulator](uploads/2e92ad4cfa2db13bd7f47976ca2c184d/terminal_emulator.png) type this to make the installer executable:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
chmod +x install_mp.bash
|
|
|
|
|
|
|
|
1. Identify the operating system you are using. This information is needed for running the installer. To do this:
|
|
python --version
|
|
* Open a command window.
|
|
|
|
* In the command window, type any of the following: `cat /etc/os-release` or `hostnamectl` or `lsb_release -a` and look for your operating system name and version number.
|
|
|
|
|
|
|
|
1. Identify your operating system in the following table (See section Special Provisions, below, for version details):
|
|
and observing version information being printed back.
|
|
|
|
1. Download and unzip Gryphon from https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/ by browsing to this page, clicking the download icon near the upper right: ![download](uploads/509a7e72dfa75dded2c31b3cb70d0fdc/download.png) and downloading the zip content. When downloaded, unzip it to a folder and note the path.
|
|
|
|
1. Download and unzip the preloaded examples from https://gitlab.nps.edu/monterey-phoenix/mp-model-collection/preloaded-examples by browsing to this page, clicking the download icon near the upper right: ![download](uploads/509a7e72dfa75dded2c31b3cb70d0fdc/download.png) and downloading the zip content. When downloaded, unzip it to a folder adjacent to the Gryphon folder.
|
|
|
|
1. Install requisite packages. In a command window type:
|
|
|
|
|
|
| Your OS | Use this |
|
|
pip install --upgrade pip
|
|
| --- | --- |
|
|
pip install PySide6
|
|
| Ubuntu 20.10+ | ubuntu20 |
|
|
pip install qdarkstyle
|
|
| Ubuntu 18, Ubuntu 20.04 | ubuntu18 |
|
|
|
|
| Centos 8+ | centos8 |
|
|
|
|
| Centos 7 | centos7 |
|
|
|
|
| Older Mac OS | macos |
|
|
|
|
| Newer Mac OS (Gryphon only) | macos_read_only |
|
|
|
|
| MP Gryphon repositories only | gryphon_only |
|
|
|
|
|
|
|
|
1. Run the installer by typing `./install_mp.bash <OS>`. For example to install MP on Ubuntu 18 type:
|
|
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, make it executable, then run it:
|
|
|
|
|
|
cd ~/Downloads
|
|
cd ~/Downloads
|
|
./install_mp.bash ubuntu18
|
|
chmod +x install_mp.bash
|
|
|
|
./install_mp.bash ubuntu
|
|
If the installer does not support your operating system, please suggest that one be made for it. For a reference of packages required by MP please see the installation steps that are most similar to your OS under "update packages" in the MP install file at https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash.
|
|
|
|
|
|
|
|
Run the installer again to update Gryphon and any other components.
|
|
|
|
|
|
|
|
# Running Gryphon
|
|
# Running Gryphon
|
|
To run the Gryphon GUI open a command window and type:
|
|
To run the Gryphon GUI open a command window and type:
|
... | @@ -53,109 +38,3 @@ To run the Gryphon GUI open a command window and type: |
... | @@ -53,109 +38,3 @@ To run the Gryphon GUI open a command window and type: |
|
cd ~/mp_gryphon/gryphon/python
|
|
cd ~/mp_gryphon/gryphon/python
|
|
./mp.py
|
|
./mp.py
|
|
|
|
|
|
# Special Provisions
|
|
|
|
|
|
|
|
## OS Version
|
|
|
|
To identify the version of Linux you are running, type:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
cat /etc/*-release
|
|
|
|
```
|
|
|
|
|
|
|
|
## Centos 7
|
|
|
|
|
|
|
|
1. Download and run the MP installer for Centos 7 as described above.
|
|
|
|
|
|
|
|
1. The installer for Centos 7 additionally installs and sets up a Python environment for running Gryphon. Enable this environment by typing the following in a shell before starting Gryphon:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
source /opt/rh/rh-python36/enable
|
|
|
|
source ~/python_gryphon_venv/bin/activate
|
|
|
|
```
|
|
|
|
1. Then run Gryphon:
|
|
|
|
```
|
|
|
|
cd ~/mp_gryphon/gryphon/python
|
|
|
|
./mp.py
|
|
|
|
```
|
|
|
|
|
|
|
|
Note: If you are running Centos 7 virtually from a .vdi image downloaded from virtualbox.org then configure it to reach the the network through your host OS by adding this text to the bottom of your virtual OS file `/etc/sysconfig/network-scrpts/ifcfg-enp0s3` and then rebooting your virtual OS:
|
|
|
|
|
|
|
|
DNS1=8.8.8.8
|
|
|
|
DNS2=8.8.4.4
|
|
|
|
ONBOOT=yes
|
|
|
|
|
|
|
|
## Mac OS
|
|
|
|
MP Gryphon support may be limited depending on your Mac OS version. To check your Mac OS version, click on the apple icon on the menu bar and select "About This Mac".
|
|
|
|
|
|
|
|
Before running the MP installer, install Python3 from https://www.python.org/downloads/mac-osx/.
|
|
|
|
|
|
|
|
When running the MP installer, if Developer Tools is not installed, a pop-up will ask if you if you want it installed. If this is the case, install it and when done, re-run the MP installer.
|
|
|
|
|
|
|
|
### High Sierra OS 10.13.4
|
|
|
|
Type:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
./install_mp.bash macos
|
|
|
|
|
|
|
|
### Mojave OS 10.14
|
|
|
|
Disable automatic updates and then install older Xcode 9.4.1 available at https://download.developer.apple.com/Developer_Tools/Xcode_9.4.1/Xcode_9.4.1.xip, see https://stackoverflow.com/questions/52470524/xcode-9-support-on-macos-mojave. After installing Xcode 9.4.1 type:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
./install_mp.bash macos
|
|
|
|
|
|
|
|
### Older than High Sierra 10.13.4
|
|
|
|
Might work, try typing:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
./install_mp.bash macos
|
|
|
|
|
|
|
|
### Catalina 10.15 and newer
|
|
|
|
The Trace Generator is currently not available on newer Mac systems. However Gryphon may be run in read-only mode and .gry files may be imported and viewed. Type:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
./install_mp.bash macos_read_only
|
|
|
|
|
|
|
|
### Mac with M1
|
|
|
|
Currently Mac offers Rosetta 2 for running code compiled for X86 arcitecture.
|
|
|
|
We use this to run Gryphon. Install and run MP Gryphon as follows:
|
|
|
|
|
|
|
|
1. Might need to type this in a command window if it is not already installed:
|
|
|
|
|
|
|
|
softwareupdate --install-rosetta
|
|
|
|
|
|
|
|
1. Create a command window that is configured to emulate X86, ref. https://dev.to/courier/tips-and-tricks-to-setup-your-apple-m1-for-development-547g:
|
|
|
|
|
|
|
|
* Open Finder.
|
|
|
|
* Click Applications to see applications.
|
|
|
|
* Click the Utilities folder from the list of applications.
|
|
|
|
* right click (Control-click) the Terminal icon and from the pop-up menu, select Duplicate.
|
|
|
|
* Right click the new copy, click Rename, and name it Rosetta Terminal.
|
|
|
|
* Right click Rosetta Terminal, select Get Info.
|
|
|
|
* In the Rosetta Terminal info window, check Open using Rosetta. Close the Info window.
|
|
|
|
* For easier access to the new Rosetta Terminal, drag it to the bar at the bottom.
|
|
|
|
1. Open the new Rosetta Terminal.
|
|
|
|
1. Verify that it is emulating x86 instead of arm64 by typing `arch`:
|
|
|
|
|
|
|
|
arch
|
|
|
|
|
|
|
|
It should return `i386` instead of `arm64`. Although it says i386, it still will not run the 32-bit mode trace-generator.
|
|
|
|
|
|
|
|
1. Using the Rosetta Terminal, install MP Gryphon following the instructions for Catalina 10.15 and newer:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
./install_mp.bash macos_read_only
|
|
|
|
|
|
|
|
1. Run Gryphon from the Rosetta Terminal:
|
|
|
|
|
|
|
|
cd ~/mp_gryphon/gryphon/python
|
|
|
|
./mp.py
|
|
|
|
|
|
|
|
|
|
|
|
## Gryphon only
|
|
|
|
To install Gryphon and preloaded examples only:
|
|
|
|
|
|
|
|
cd ~/Downloads
|
|
|
|
./install_mp.bash macos_read_only
|
|
|
|
|
|
|
|
## Windows
|
|
|
|
See [Running Gryphon on Windows](Running Gryphon on Windows). |
|
|