Welcome - before reading anything else below, note that the main functionality of this project is based on Dr. Juan Lorenzo's work at LSU (more info here. The Dockerizing portion, graphics rending (NOT GUI), versioning, docs herein and some other presumably "nice stuff" is added by Nathan Benton here.
- Install Docker Desktop (or equivalent) on your machine (if this is your first time using Docker).
- Clone this repo to your local machine (if this is your first time using this project).
- Acquire or update the Docker image by running this command:
docker pull nathanbenton/sug. - Start the graphics rendering software with (for Windows users):
& 'C:\Program Files\VcXsrv\vcxsrv.exe' :0 -ac. If you haven't installed that yet (via choco - see further note), refer to the Appendix below by clicking here: Appendix. - Run Docker container with basic, non-file sharing command:
docker run -it nathanbenton/sug. - If you want to enable file sharing, run this command:
docker run --mount type=bind,source=C:\Users\nbent\dev_testing\k8s\youtube\videos,target=/usr/local/cwp_su_all_44R22/data -it nathanbenton/sug(see email to Dr. Lorenzo for more details in regards to changing the source file path example here).
- All preliminary, ongoing, and future work based strictly on initial dev provided by Dr. Juan Lorenzo (at LSU), which his work is here: https://github.com/gllore. Right now, these notes are not listed in order, and are here mostly for reference. Read everything here in this README file before doing anything else in this project.
& 'C:\Program Files\VcXsrv\vcxsrv.exe' :0 -ac= use this command to start Xserver graphics UI for Windos OS (it's advised to use the latest Windows Terminal with Powershell, so NOT CMD or something else like it).- Run this command to start SUG:
SeismicUnixGui(inside the running container, which you can provision with #8 below). - Samples here.
- Use Choco (for Windows users) to install stuff for #1 above:
choco install vcxsrv. - For macOS users, use XQuartz instead of VcXsrv and install that via Homebrew:
brew cask install xquartz(and in case one does not have brew, install it via:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". - For Linux users, use X11 and install it via:
sudo apt-get install x11-apps. - To acquire the Docker image, run this:
docker pull nathanbenton/sug. - To run the container with file sharing enabled and interacting with it directly, run this command (which is similar to the initial one, which is docker
run -it nathanbenton/sug):docker run --mount type=bind,source=C:\Users\nbent\dev_testing\k8s\youtube\videos,target=/usr/local/cwp_su_all_44R22/data -it nathanbenton/sug(see email to Dr. Lorenzo for more details). - Note that this file is to automatically handle all the initial prompts thrown from Seismic Unix during the install/config:
./install_cwp.exp. - In order to see any graphics from the container, make sure you have Xserver (or equivalent software for other non-Windos OS) running.
- This is the unzipped SU download (i.e. SeisUnix-master) from here: https://github.com/JohnWStockwellJr/SeisUnix.
- Also, this is the unzipped folder download (i.e. sioseis-2024.1.1) from here: https://sioseis.com/index.html.