--- a/README.md Thu Aug 29 00:00:00 2024 -0500 +++ b/README.md Tue Dec 31 09:25:45 2024 -0500 @@ -52,35 +52,29 @@ ### Building and running the experiments -To compile the code and run the experiments in the manuscript, use +To compile and install the program, use +```console +cargo install --path=. +``` +When doing this for the first time, several dependencies will be downloaded. +Now you can run the default experiment with +``` +pointsource_algs -o results +``` +The `-o results` option tells `pointsource_algs` to write results in the +`results` directory. The option is required. + +Alternatively, you may build and run the program without installing with ```console cargo run --release -- -o results ``` -When doing this for the first time, several dependencies will be downloaded. -The double-dash (`--`) separates the arguments of Cargo and this software, -`pointsource_algs`. The `--release` option to Cargo is required for `rustc` to -build optimised high performance code. Without that flag the performance will -be significantly worse. The `-o results` option tells `pointsource_algs` to -write results in the `results` directory. The option is required. - -Alternatively, you may build the executable with -```console -cargo build --release -``` -and then run it with -``` -target/release/pointsource_algs -o results -``` +The double-dash separates the options for the Cargo build system +and `pointsource_algs`. ### Documentation Use the `--help` option to get an extensive listing of command line options to -customise algorithm parameters and the experiments performed. As above with -`-o`, if using `cargo` to run the executable, you have to pass any arguments -to `pointsource_algs` after a double-dash: -```console -cargo run --release -- --help -``` +customise algorithm parameters and the experiments performed. ## Internals