***Gryphon** - Runs the trace-generator and displays results in a stand-alone environment.
***trace-generator** - Generates models from MP code.
***Preloaded examples** - Contains examples and snippets of MP code.
# Compatibility
The MP Gryphon toolset 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 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.
***Linux flavors** - An installer is available for several Linux flavors.
***Mac** - An installer is available. Newer Mac systems offer a limited read-only mode (MacOS High Sierra 10.13.4 and newer).
...
...
@@ -26,33 +33,14 @@ The Gryphon Python GUI works in tandem with the Monterey Phoenix V4 trace genera
| Older Mac OS | macos |
| Newer Mac OS (Gryphon only) | macos_read_only |
1. Identify what version of Gryphon you would like to use:
| Your version preference | Use this |
| --- | --- |
| Gryphon v0.5.1c | v0.5.1c
| Latest under development | master |
1. Run the installer by typing `./install_mp.bash <OS> <Gryphon version>`. For example to install MP on Ubuntu 18 with Gryphon v0.5.1c type:
1. Run the installer by typing `./install_mp.bash <OS>`. For example to install MP on Ubuntu 18 type:
cd ~/Downloads
./install_mp.bash ubuntu18 v0.5.1c
**Note: The installer attempts to install the MP preloaded examples. This repository is currently not public and will not install. For now, please see section "Installing Curated Examples", below.**
./install_mp.bash ubuntu18
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.
# Installing Curated Examples
**The preloaded-examples repository is not yet available.** You may configure Gryphon to use a smaller set of examples that are publicly available. To do this:
1. Download the curated examples to a directory, for example:
1. Run Gryphon. Select menu "Settings | Preloaded examples path..." and select the `~/mp_gryphon/curated-examples` folder.
When the preloaded-examples repository becomes available, you may install them using the MP installer. Once installed, run Gryphon and select menu "Settings | Preloaded examples path..." to select the `~/mp_gryphon/preloaded-examples` folder.
Run the installer again to update Gryphon and any other components.
# Running Gryphon
To run the Gryphon GUI open a command window and type:
...
...
@@ -60,14 +48,6 @@ To run the Gryphon GUI open a command window and type:
cd ~/mp_gryphon/gryphon/python
./mp.py
# Updating Gryphon
Re-run the MP installer to update Gryphon to the latest version. Alternatively, install a specific version of MP Gryphon using version parameters.
To just update Gryphon type:
cd ~/Downloads
./install_mp.bash gryphon_only master
# Special Provisions
## OS Version
...
...
@@ -110,25 +90,25 @@ When running the MP installer, if Developer Tools is not installed, a pop-up wil
Type:
cd ~/Downloads
./install_mp.bash macos master
./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 master
./install_mp.bash macos
### Older than High Sierra 10.13.4
Might work, try typing:
cd ~/Downloads
./install_mp.bash macos master
./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 master
./install_mp.bash macos_read_only
### Mac with M1
Currently Mac offers Rosetta 2 for running code compiled for X86 arcitecture.
...
...
@@ -158,7 +138,7 @@ Currently Mac offers Rosetta 2 for running code compiled for X86 arcitecture.
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 master
./install_mp.bash macos_read_only
1. Run Gryphon from the Rosetta Terminal:
...
...
@@ -170,7 +150,7 @@ Currently Mac offers Rosetta 2 for running code compiled for X86 arcitecture.
To install Gryphon and preloaded examples only:
cd ~/Downloads
./install_mp.bash macos_read_only master
./install_mp.bash macos_read_only
## Windows
See [Running Gryphon on Windows](Running Gryphon on Windows).
