Difference between revisions of "SCEC VDO"

From SCECpedia
Jump to navigationJump to search
(→‎Troubleshooting: Update macOS troubleshoot instructions)
(→‎Downloads: Update v24.10.0 download path)
 
(4 intermediate revisions by the same user not shown)
Line 6: Line 6:
  
 
== Releases ==
 
== Releases ==
=== v0.1.0 ===
+
=== v24.10.0 ===
 
==== Info ====
 
==== Info ====
 
* Added support for Apple Silicon Macs
 
* Added support for Apple Silicon Macs
Line 14: Line 14:
  
 
==== Downloads ====
 
==== Downloads ====
* Linux Download: [https://g-c662a6.a78b8.36fe.data.globus.org/scec-vdo/v0.1.0/scec-vdo-linux.zip v0.1.0/scec-vdo-linux.zip (532 MB)]
+
* Linux Download: [https://g-c662a6.a78b8.36fe.data.globus.org/scec-vdo/v24.10.0/scec-vdo-linux.zip v24.10.0/scec-vdo-linux.zip (532 MB)] (MD5: 03fb57593ae33d9b475799d0d153b6b2)
* macOS Download: [https://g-c662a6.a78b8.36fe.data.globus.org/scec-vdo/v0.1.0/scec-vdo-mac-osx.zip v0.1.0/scec-vdo-mac-osx.zip (516 MB)]
+
* macOS Download: [https://g-c662a6.a78b8.36fe.data.globus.org/scec-vdo/v24.10.0/scec-vdo-mac-osx.zip v24.10.0/scec-vdo-mac-osx.zip (516 MB)] (MD5: 9e4c9a8592baf574a8e9bfac5b8a07fb)
* Windows Download: [https://g-c662a6.a78b8.36fe.data.globus.org/scec-vdo/v0.1.0/scec-vdo-windows.zip v0.1.0/scec-vdo-windows.zip (390 MB)]
+
* Windows Download: [https://g-c662a6.a78b8.36fe.data.globus.org/scec-vdo/v24.10.0/scec-vdo-windows.zip v24.10.0/scec-vdo-windows.zip (390 MB)] (MD5: 9aeb73faebcd154d850d58ba86638e3e)
  
 
== Troubleshooting ==
 
== Troubleshooting ==
=== v0.1.0 on macOS ===
+
=== macOS ===
 
As of SCEC-VDO v0.1.0, the macOS application is bundled as a zip file instead of an app file. macOS GateKeeper refuses to execute applications bundled this way by default, regardless of codesigning.
 
As of SCEC-VDO v0.1.0, the macOS application is bundled as a zip file instead of an app file. macOS GateKeeper refuses to execute applications bundled this way by default, regardless of codesigning.
 
We'll consider bundling a proper macOS app instead of a zip file as a permanent solution.  
 
We'll consider bundling a proper macOS app instead of a zip file as a permanent solution.  
  
[[File:java_cannot_be_opened.png|600px|thumb|left|Cannot be Opened Error]]
+
[[File:java_cannot_be_opened.png|600px|thumb|macOS "java cannot be opened" error]]
  
[[File:JRE_Signed.png|600px|thumb|left|App will not run because it's bundled as a zip file]]
+
[[File:JRE_Signed.png|600px|thumb|macOS app will not run because it's bundled as a zip file]]
  
 
Unauthorized applications cannot be directly executed in the Terminal or opened by double-clicking without making a GateKeeper exception.
 
Unauthorized applications cannot be directly executed in the Terminal or opened by double-clicking without making a GateKeeper exception.
Line 31: Line 31:
  
 
To create a security exception, you need to enable Developer Tools and allow the Terminal permission to bypass the system security policy.
 
To create a security exception, you need to enable Developer Tools and allow the Terminal permission to bypass the system security policy.
Enable Developer Tools by running <code>spctl developer-mode enable-terminal</code> and restarting the Terminal.
+
Enable Developer Tools by running <code>spctl developer-mode enable-terminal</code> and quitting the Terminal.
 
Then navigate to Developer Tools inside System Settings, enable the Terminal to bypass security, and try running the SCEC-VDO application.
 
Then navigate to Developer Tools inside System Settings, enable the Terminal to bypass security, and try running the SCEC-VDO application.
  
Line 38: Line 38:
 
==== Intel Mac Demo (1:11) ====
 
==== Intel Mac Demo (1:11) ====
 
[[File:Intel_Mac_4GB_SCEC-VDO_Demo.mp4]]
 
[[File:Intel_Mac_4GB_SCEC-VDO_Demo.mp4]]
 +
 
==== M1 Mac Demo (1:37) ====
 
==== M1 Mac Demo (1:37) ====
 
[[File:M1_Mac_8GB_SCEC-VDO_Demo.mp4]]
 
[[File:M1_Mac_8GB_SCEC-VDO_Demo.mp4]]
 +
 +
=== Linux ===
 +
For our Linux users, the <code>launch_linux.sh</code> script installs the dependency <code>freeglut3-dev</code>
 +
using the Aptitude package manager. For users of non-Debian based distributions, you must
 +
install an equivalent with your package manager or compile [https://github.com/freeglut/freeglut from source].

Latest revision as of 20:41, 21 October 2024

SCEC Virtual Display of Objects (SCEC VDO)

Researchers and interns at the Southern California Earthquake Center (SCEC) have built a seismic data visualization software tool called the SCEC Virtual Display of Objects (SCEC-VDO). Written in Java with the Swing GUI toolkit to create interactive menus and the Visualization Toolkit (VTK) to render 3D content, SCEC-VDO allows for the visualization of 3D earthquake and fault objects on maps and the creation of images and movies for analysis, presentation, and publication.

View source code on GitHub

Releases

v24.10.0

Info

  • Added support for Apple Silicon Macs
  • Create Windows batch launcher
  • Upgraded all platforms to VTK9.1
  • Bundled OpenJDK 23+37, OpenJ9 0.47.0

Downloads

Troubleshooting

macOS

As of SCEC-VDO v0.1.0, the macOS application is bundled as a zip file instead of an app file. macOS GateKeeper refuses to execute applications bundled this way by default, regardless of codesigning. We'll consider bundling a proper macOS app instead of a zip file as a permanent solution.

macOS "java cannot be opened" error
macOS app will not run because it's bundled as a zip file

Unauthorized applications cannot be directly executed in the Terminal or opened by double-clicking without making a GateKeeper exception. This is a very simple, one time process that should not take longer than a minute.

To create a security exception, you need to enable Developer Tools and allow the Terminal permission to bypass the system security policy. Enable Developer Tools by running spctl developer-mode enable-terminal and quitting the Terminal. Then navigate to Developer Tools inside System Settings, enable the Terminal to bypass security, and try running the SCEC-VDO application.

I've created video demonstrations showing exactly how to do this.

Intel Mac Demo (1:11)

File:Intel Mac 4GB SCEC-VDO Demo.mp4

M1 Mac Demo (1:37)

File:M1 Mac 8GB SCEC-VDO Demo.mp4

Linux

For our Linux users, the launch_linux.sh script installs the dependency freeglut3-dev using the Aptitude package manager. For users of non-Debian based distributions, you must install an equivalent with your package manager or compile from source.