Command Line Interface

Overview

This document details the usage of the Command Line Interface (CLI) for Ainur. It covers the various arguments the CLI can take.

Usage

The usage of the core Ainur implementation's CLI is as follows.

java −jar Ainur.jar INPUT.dot P [OPTIONS]

INPUT. dot a task graph with integer weights in dot format
P          number of processors to schedule the INPUT graph on

Optional :
-p N       use N cores for execution in parallel (default is sequential)
-v         visualise the search
−o         OUTPUT output file is named OUTPUT (default is INPUT−output .dot)

In terms of file input/output location arguments: the program must be given a complete path to the input data specified. This means if input.dot is located in a folder called data/, then the program must be passed the string data/input.dot to read.

If no -o argument is given the output name will default to data/input-output.dot. Note how by default the output file is placed in the same file as the data. By contrast, if the -o argument is used, then the output file's location will go to the precise specified location of the -o argument. For example an argument of -o input-output.dot will place the file in the directory of the Ainur .jar file, and not the data/ file. If the user wishes for output to be placed in data/, they must specify -o data/input-output.dot.