|
|
Gryphon provides a Python GUI interface for viewing graphs created using the Monterey Phoenix V4 trace-generator.
|
|
|
Gryphon provides a Python GUI interface for viewing graphs created using the Monterey Phoenix V4 trace-generator. Gryphon is similar to the Firebird web-based GUI at https://firebird.nps.edu/. Here are some notable differences:
|
|
|
|
|
|
* Gryphon runs as a stand-alone application along with the trace generator and does not access the Internet. Firebird runs in the Browser and requires the Server to run the trace-generator.
|
|
|
* Each may have some differences in features and appearance.
|
|
|
|
|
|
# Example screenshot
|
|
|
Here is an example screenshot of the Gryphon GUI showing graph 4 scope 1 for MP code example 45, martian lander, with line `SHOW ACTIVITY DIAGRAM Landing;` added to the bottom to additionally show the activity diagram:
|
|
|
|
|
|
![screenshots/gryphon_gui_example.png](screenshots/main_window_ex45mod.png)
|
|
|
|
|
|
# Compatibility
|
|
|
The Gryphon GUI is compatible with Linux flavors. It is currently not compatible with Windows systems or MacOS High Sierra 10.13.4 and newer.
|
|
|
# Example usage
|
|
|
Click on the Open button ![open](uploads/437f889fb210721f15868fb75a819c36/open.png) and under Open Example | Preloaded Examples select an example, for example select Example 5 Car Race. Choose Scope one ![scope1](uploads/7dc51f4e8ba41eb1b1b823250e7bbaf5/scope1.png) to bound the scope of trace generation to one, then click Run ![run](uploads/d9332fa6dcb8443f8e7d7050162fc8a1/run.png). The MP code text is shown on the left, the selected trace is shown in the middle, and the list of traces along with any global view is shown on the right. From here, browse through, sort, and filter generated traces. Click on items in the main graph. Try out the toolbar and menu options. Modify the MP code and re-run the trace generator. Click Help for more information.
|
|
|
|
|
|
# Installing Gryphon
|
|
|
The Gryphon Python GUI works in tandem with the Monterey Phoenix V4 trace generator. Both must be installed to use Gryphon.
|
|
|
|
|
|
Install Gryphon and the Trace Generator by running the MP installer. Download the installer, make it executable, and run it:
|
|
|
|
|
|
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 your operating system from the following table:
|
|
|
|
|
|
| Your OS | Use this |
|
|
|
| --- | --- |
|
|
|
| Ubuntu 20+ | ubuntu20 |
|
|
|
| Ubuntu 18 | ubuntu18 |
|
|
|
| Centos 8+ | centos8 |
|
|
|
| Centos 7 | centos7 |
|
|
|
| Older Mac OS | macos |
|
|
|
| Newer Mac OS (Gryphon only) | macos_demo |
|
|
|
|
|
|
1. Identify what version of Gryphon and Trace Generator you would like to use:
|
|
|
|
|
|
| | Latest stable | Latest under development |
|
|
|
| --- | --- | --- |
|
|
|
| Trace Generator | master | master |
|
|
|
| Gryphon | v0.5.0 | master |
|
|
|
|
|
|
1. Run the installer by typing `./install_mp.bash <OS> <trace-generator version> <Gryphon version>`. For example to install MP on Ubuntu 18 with Gryphon v0.5.0 and the latest trace-generator type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash ubuntu18 master v0.5.0
|
|
|
|
|
|
or to install the latest Gryphon and Trace Generator code under development type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash ubuntu18 master master
|
|
|
|
|
|
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.
|
|
|
|
|
|
### Special provisions
|
|
|
|
|
|
#### 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.
|
|
|
|
|
|
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 master master
|
|
|
|
|
|
##### 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 master
|
|
|
|
|
|
##### Older than High Sierra 10.13.4
|
|
|
Might work, try typing:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash macos master master
|
|
|
|
|
|
##### Catalina 10.15 and newer
|
|
|
The Trace Generator is currently not available on newer Mac systems. However Gryphon may be run in demo mode and .gry files may be imported and viewed. Type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash macos_demo master master
|
|
|
|
|
|
#### Ubuntu 20
|
|
|
The master branch of trace-generator currently does not build on Ubuntu 20. A temporary work-around is to install the unofficial `modernize_build` branch by running the MP installer as follows:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash ubuntu20 modernize_build master
|
|
|
|
|
|
# Running Gryphon
|
|
|
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:
|
|
|
Please see [Installing Gryphon](Installing Gryphon)
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash gryphon_only master master
|
|
|
# Resources
|
|
|
* [Installing Gryphon](Installing Gryphon)
|
|
|
* MP home page: https://wiki.nps.edu/display/MP/Monterey+Phoenix+Home
|
|
|
* MP Language manual v4: https://wiki.nps.edu/download/attachments/604667916/MP2-syntax-v4.pdf?api=v2
|
|
|
* Firebird web-based GUI: https://firebird.nps.edu/, https://staging.firebird.nps.edu |