Searching...

No Matches

All YAC tools are built together with the YAC libraries.

The *.x-tools can be found in <yac_build_dir>/tools and the *.py-tools int <yac_repo_dir>/tools.

One major task of the tools is the visualisation of weight files, which is essential for analysing and debugging of interpolation generated by YAC.

debug_grid2vtk.x

This tool turns grid-files generated by YAC using the configuration file output_grids debug option into a vtk-file, which can easily be visualised using Paraview.

weights2vtk.x

Based on weight files created by YAC, this tool can generate a VTK-file, which can be used to visualise weights using Paraview.
(for more Information see Creating weight files and visualise them)

yac_plot_grids.py

Tool for plotting YAC debug grid files on an interactive map. Accepts one or more NetCDF grid files, auto-discovers all grids contained in them, and renders each grid in a distinct colour. Supports the same projection, centre, radius, and coastline options as yac_plot_weights.py. Core and halo cells are distinguished visually; cell IDs can be toggled via keyboard shortcuts. (for more Information see YAC Grid Visualisation Tool)

yac_plot_weights.py

Tool for plotting weights and weight stencils from YAC-created weight files on an interactive map.
(for more Information see Creating weight files and visualise them)

yac_record.py & yac_replay.py

Tools for recording data in a coupled setup and write the data to a netCDF file. This recordings can then be used to replay the data in a coupled setup and use the replay component as a source.
For detailed explanation see Recording and Replaying Coupling Data.

yac_compute_weights.x

This tool allows the user to easily generate interpolation weights for the remapping between two grids and write them to file. The grid information can be provided via a grid file (multiple formats are supported) or YAC can generate it based on user specifications. The interpolation is freely configurable via a JSON-formatted command line argument and follows the defintion of the interpolation stack in the configuration file.
The tool is MPI-parallel and can be run with an arbitrary number of processes.
(for more Information see YAC Weight File Generation Tool)

yac_generate_weights.py

This Python-based tool generates interpolation weight files similar to yac_compute_weights.x but uses uxarray for grid processing. This implementation supports diverse grid formats including ICON, FESOM, and HEALPix.
(for more Information see YAC Python Weight File Generator)

yac_plot_coupling_config.py

Tool for visualising a YAC coupling configuration as a directed graph. It reads a coupling config YAML file and renders the components and their field couplings as an SVG graph.
(for more Information see YAC Coupling Configuration Visualisation Tool)