Right-pointing chevronfacebooklinkedintwitter

XBeach

Nerdalize

Versions

1.23

XBeach is an open-source numerical model which is originally developed to simulate hydrodynamic and morphodynamic processes and impacts on sandy coasts with a domain size of kilometers and on the time scale of storms. Since then, the model has been applied to other types of coasts and purposes.

Running your XBeach workload on Nerdalize

  1. Make sure you’ve set up Nerd, our CLI.

  2. Set up your dataset.

    Download our example dataset and unzip it.

    Alternatively you can use your own dataset, for which this README explains the required dataset structure.

  3. Upload your dataset.

    $ nerd dataset upload --name=xbeach-input <path>
    Archiving (Step 1/2): 1.42 MB / 1.42 MB [=======] 100.00% 0s
    Uploading (Step 2/2): 1.42 MB / 1.42 MB [=======] 100.00% 0s
    Uploaded dataset: 'xbeach-input'
    To run a job with a dataset, use: 'nerd job run'
    
  4. Start XBeach.

    $ nerd job run --name=xbeach-run --input=xbeach-input:/data --output=xbeach-output:/output quay.io/nerdalize/xbeach
    Submitted job: 'xbeach-run'
    To see whats happening, use: 'nerd job list'
    
  5. Check on the status of your job.

    $ nerd job list
    JOB      IMAGE    INPUT       OUTPUT       MEMORY   VCPU   CREATED AT      PHASE     DETAILS   
    xbeach-run  xbeach  xbeach-input   xbeach-output   3.0      2.0    6 seconds ago   Running    
    

    When your task’s status is Completed it’s finished and you can continue to download the output.

    If you want to review the log output, run:

    $ nerd job logs xbeach-run
     **********************************************************
                     Welcome to XBeach
    
               version 1.23.Unversioned directory XBeachX BETA release
               dateTue Jun 26 03:06:38 UTC 2018
     URL:
      **********************************************************
    
  6. Download the collection of output files.

    $ nerd dataset download --output-of xbeach-run ~/my-xbeach-output
    Downloading (Step 1/2): 22.52 MB / 22.52 MB [=======] 100.00% 0s
    Unarchiving (Step 2/2): 22.52 MB / 22.52 MB [=======] 100.00% 0s
    Downloaded 1 dataset
    

You’ve run a XBeach simulation. Awesome!

You can run another simulation or use your one of our other applications.
Have any questions about using Nerdalize compute?

Get in touch