Command-Line Utilities

DaCe provides a set of command-line utilities to simplify interaction with SDFGs and tools or workflows within the DaCe framework.

sdfgcc - SDFG Command-line Compiler

The SDFG Command-line Compiler sdfgcc enables compilation of SDFG files from the command-line.

Usage:

sdfgcc [-o OUT] [-O] <filepath>

Argument	Required	Description
<filepath>	Yes	Path to the SDFG file to compile.
-O,--optimize		If set, invokes the command-line optimization interface.
-o,--out		If provided, saves the library as the given file or in the specified path, together with a header file.

sdfv - SDFG Viewer

The SDFG Viewer sdfv displays SDFGs in the system’s HTML viewer. It reads an SDFG and creates a temporary HTML file that contains a standalone viewer, which is then opened.

Usage:

sdfv <filepath>

Argument	Required	Description
<filepath>	Yes	Path to the SDFG file to show. If a directory is provided, the tool searches for a file called program.sdfg in said folder

sdprof - SDFG Profile Viewer

The SDFG Profile Viewer sdprof shows summarizations of SDFG profiling and instrumentation reports in the command-line.

Usage:

sdprof [-s CRITERION] [-a] <filepath>

Argument	Required	Description
<filepath>	Yes	Path to the file containing the report.
-s,--sort		Sort by a specific criterion. Choices are: min|max|mean|median: Sort by the minimum/maximum/mean/median observed value. counter: Sort by counter name/type. value: Sort by the observed value.
-a,--ascending		If given, sort in ascending order.

For a more detailed guide on how to profile SDFGs and work with the resulting data, see Profiling and Instrumentation and this tutorial.