|
|
# MP Gryphon Toolset
|
|
|
The MP Gryphon toolset consists of the following:
|
|
|
|
|
|
* **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:
|
|
|
|
|
|
cd ~/mp_gryphon
|
|
|
git clone https://gitlab.nps.edu/monterey-phoenix/mp-model-collection/curated-examples.git
|
|
|
|
|
|
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).
|
... | ... | |