Skip to main content
Latch workflows can output thousands of files, making it difficult for users to find the most relevant output files. To help users navigate these outputs, Latch provides a results page that displays the outputs of a workflow in a user-friendly interface.

Usage

SDK Example

To expose specific outputs to users, developers must explicitly supply a list of paths to publish. For example:
...

from latch.executions import add_execution_results

@small_task
def assembly_task(
    read1: LatchFile, read2: LatchFile, output_directory: LatchOutputDir
) -> LatchFile:

    ...

    results = []
    results.append(str(output_directory.remote_path))
    results.append(os.path.join(output_directory.remote_path, 'pipeline_info/execution_report.html'))
    add_execution_results(results)

    ...

Nextflow Example

Developers can explicitly define a list of subpaths for any output directory defined in latch_metadata/parameters.py. For example, the following code snippet exposes shortcuts for the workflows publishDir and execution report:
parameters = {
  'outdir': NextflowParameter(
    type=LatchDir,
    results_paths=[
      Path("/"),
      Path("/pipeline_info/execution_report.html")
    ]
  )
}

Results Interface

Both methods render a “Results” page in the Latch Console that displays the outputs of the workflow in a user-friendly interface: Results GUI
I