NGIAB-Prerequisites
Windows:
- Install WSL: Head over to Microsoft's official documentation and follow their comprehensive guide on installing WSL: https://learn.microsoft.com/en-us/windows/wsl/install
- Install Docker Desktop: Begin by downloading and installing Docker Desktop from the official website: https://docs.docker.com/desktop/install/windows-install/#install-docker-desktop-on-windows
- Start Docker Desktop: After installation, launch the Docker Desktop application.
- Open WSL as Admin: Right-click on the WSL icon and select "Run as Administrator".
- Verify Installation: In the WSL window, type the command docker ps -a to check if Docker is running correctly. This command should display a list of Docker containers.
Mac:
- Install Docker Desktop: Download and install Docker Desktop for Mac from: https://docs.docker.com/desktop/install/mac-install/
- Start Docker Desktop: Launch the Docker Desktop application once the installation is complete.
- Open Terminal: Open the Terminal application on your Mac.
- Verify Installation: Similar to Windows, use the command docker ps -a in the Terminal to verify Docker is functioning as expected.
Linux:
- Install Docker: The installation process for Linux varies depending on your distribution. Refer to the official documentation for detailed instructions: https://docs.docker.com/desktop/install/linux-install/
- Start Docker and Verify: Follow the same steps as described for Mac to start Docker and verify its installation using the docker ps -a command in the terminal.
- Input Data:
- Download Sample Data: Use the provided commands to download sample data for the Sipsey Fork case study.
- To generate your own data: Refer to the NGIAB-datapreprocessor for instructions on generating custom input data.
- To generate your own data and run using NGIAB: Refer to the ngen-datastream repository for instructions on generating custom input data.
This section guides you through downloading and preparing the sample input data for the NextGen In A Box project.
Step 1: Create Project Directory
- Linux/Mac users: Open your terminal and go to your desired folder where you want to checkout repo and ngen-data folder and run the following commands:
mkdir -p NextGen/ngen-data
cd NextGen/ngen-data
- Windows users: WSL (Right click and run as Admin): Open WSL with administrator privileges and execute:
cd /mnt/c/Users/<Folder>
mkdir -p NextGen/ngen-data
cd NextGen/ngen-data
Step 2: Download Sample Data
- Linux/Mac/Windows WSL: Use wget to download the compressed data file:
wget --no-parent https://ciroh-ua-ngen-data.s3.us-east-2.amazonaws.com/AWI-006/AWI_16_2853886_006.tar.gz
Step 3: Extract and Rename
- All Platforms: Extract the downloaded file and optionally rename the folder:
tar -xf AWI_16_2853886_006.tar.gz
Rename the folder
mv AWI_16_2853886_006 my_data
Now you have successfully downloaded and prepared the sample input data in the NextGen/ngen-data directory.
Step 4: Pull images (Optional)
-
For Mac:
docker pull awiciroh/ciroh-ngen-image:latest
docker pull docker.osgeo.org/geoserver:2.25.x
docker pull awiciroh/tethys-ngiab:main -
For Windows/Linux:
docker pull awiciroh/ciroh-ngen-image:latest-x86
docker pull docker.osgeo.org/geoserver:2.25.x
docker pull awiciroh/tethys-ngiab:main