SparseTransform

This is a program to transform sparse matrices from the SuiteSparse matrix collection to DOT graphs and perform coloring on them.

How to Run

Using Microsoft Visual Studio 2022: Open SparseTransform.sln, set the SparseTransform.CLI project as default and run using the provided interface tools. This might be done by pressing CTRL + F5.

The instructions below assume that your working directory is at the project root

Using the .NET SDK command dotnet: Execute dotnet run --project ./src/SparseTransform.CLI/SparseTransform.CLI.csproj -- <ARGS>. <ARGS> are the commands and arguments to pass depending on the task you want to perform. For example to read a MatrixMarket string from a file, partition it and output the result as a colored DOT graph, use the following arguments: partition -f dot -i inFile -o outFile.

Make sure you specify the SparseTransform.CLI project as the library project is not runnable by itself.

How to Build the Program

The instructions below assume that your working directory is at the project root

Using the .NET SDK command dotnet you can choose between building for execution with an installed .NET framework or as a standalone executable.

Using .NET Framework:

dotnet build ./src/SparseTransform.CLI/SparseTransform.CLI.csproj --configuration Release

As a Standalone Executable:

dotnet build ./src/SparseTransform.CLI/SparseTransform.CLI.csproj --runtime <RID> --self-contained --configuration Release

<RID> specifies the Runtime-ID that you want to build for. For available options see the .NET RID Catalog

How to Build the Documentation

We currently use Doxygen to generate an HTML documentation as well as the LaTeX files needed to generate a PDF manual. Make sure you have a working installation of Doxygen installed.

The instructions below assume that your working directory is in the /docs folder located in the project root.

To build both documentations execute

doxygen Doxyfile

This will generate 2 folders: html and latex. The html folder contains the HTML source. You can open it by opening the file index.html in your browser.

The latex folder contains LaTeX source to generate a PDF manual. You will need either Make or latexmk to ensure the right number of pdflatex runs.

To compile the files into a single PDF document using Make execute

make

If you do not have Make installed use latexmk (Obtainable e.g. via the MiKTeX installer):

latexmk refman

The compiled PDF file is named refman.pdf and also stored in the latex folder.