WPS Builder

What is WPS Builder ?

WPS Builder allows to creates graphical process workflows that can be easily executed and reproduced. It allows Web Processing Services to operate through a user interface.

We have developed a version of WPS Builder adapted to the needs of NoiseModelling. This version being very close to the original version initially developed by former BoundlessGEO company.

Frequently Asked Question

What do the colors correspond to?

Orange block are mandatory
Beige blocks are optional
Green block are the output of the process*
Blocks get solid border when they are ready/filled

Can I save my WPS Builder project?

Yes. To save your WPS Builder project you two possibilities:

Export the blocks state into a JSON file
Export the blocks state and the whole database into a zip file (limited to 500 MB database)

1. Export/Import the blocks state

Click on the File icon and then choose Save project. The browser will save the file in your download folder.

Once you want to recover the saved state, click on File / Open project and select the saved file.

2. Export/Import the database

Click on the File icon and then choose Save project with database. The browser will save the file in your download folder.

How to run multiple processing at once ?

You can use the output of a processing block (like Import File) as the input of another process. To do this keep the left button of your mouse down while dragging the white square on the right side of a green output block to the left white square of the input of another process. Then run the last process in the chain in order to execute the whole processing.

I want to run the same processing but using a script not using my web browser, how do it ?

NoiseModelling WebServer is using the standard protocol named OGC Web Processing Service (WPS) Interface Standard. When you run a WPS block the WPS Builder is generating an equivalent Python script into the Python tab in the user interface. You can just copy/paste the script in a Python console and it should work (no dependency) as long as the NoiseModelling program is running in the background.

The generated Python script is using the synchronous WPS execution, so the server will not respond until the process is done or after the 60 seconds default timeout.

If the timeout is reached it will always return a message “Long running process..” like in the WPS Builder (But the job will still running on the server).

But you can use the asynchronous WPS API so the server will return a message immediately with links to follow the progression of the execution of your job.

You can use the OwsLib Python library to do so, here is an example of how to do it:

List all available processes

import logging
import sys
from owslib.wps import WebProcessingService

def main():
    # Configure the root logger to output to stdout
    logging.basicConfig(stream=sys.stdout, level=logging.INFO)

    url = "http://localhost:8000/builder/ows"

    # use jwt cookie header for authentification
    jwt_token = ""
    wps = WebProcessingService(url, skip_caps=False, headers={"Authorization": jwt_token})

    # 2. List all available processes
    print(f"\n--- Available Processes ---")
    for process in wps.processes:
        print(f"ID: {process.identifier}")
        print(f"   Title: {process.title}")
        print(f"   Abstract: {process.abstract}\n")
        process_details = wps.describeprocess(process.identifier)
        print(f"   Inputs:")
        for data_input in process_details.dataInputs:
            print(f"      ID: {data_input.identifier}")
            if hasattr(data_input, 'title'):
                print(f"      Title: {data_input.title}")
            if hasattr(data_input, 'dataType'):
                print(f"      Data Type: {data_input.dataType}")
            if hasattr(data_input, 'minOccurs') and data_input.minOccurs == 0:
                print(f"      Optional")
            if hasattr(data_input, 'abstract'):
                print(f"      Abstract: {data_input.abstract}")
            if hasattr(data_input, 'allowedValues') and len(data_input.allowedValues) > 0:
                print(f"      Allowed values: {data_input.allowedValues}")
            if hasattr(data_input, 'defaultValue') and data_input.defaultValue is not None:
                print(f"      Default : {data_input.defaultValue}")
            print("")

if __name__ == "__main__":
    main()

Execute a processes

import logging
import sys
from owslib.wps import WebProcessingService, monitorExecution

def main():
    # Configure the root logger to output to stdout
    logging.basicConfig(stream=sys.stdout, level=logging.INFO)

    url = "http://localhost:8000/builder/ows"

    # use java web token for authentification
    jwt_token = ""
    wps = WebProcessingService(url, skip_caps=False, headers={"Authorization": jwt_token})

    target_id = "Database_Manager:Display_Database"

    inputs = [('showColumns', "true")]

    # Execute (sync or async)
    execution = wps.execute(target_id, inputs)

    # Monitor progress if it's a long task
    monitorExecution(execution, sleepSecs=2)

    if execution.isSucceded():
        for output in execution.processOutputs:
            print(f"Result {output.identifier}: {output.data}")
    else:
        print("Execution failed.")

if __name__ == "__main__":
    main()