galitime 0.1.2

description

Introduction

Software for benchmarking programs using GNU Time.

Quick example

if [[ $(uname) == "Darwin" ]]; then brew install gnu-time; fi
conda install -y -c bioconda -c conda-forge galitime
galitime --log time.log ls

Installation

Dependencies

Galitime has no dependencies beyond Python 3. However, on OS X it requires the GNU version of the time command (gtime), which can be installed by brew install gnu-time.

Using Bioconda

conda install -y -c bioconda -c conda-forge galitime

Using PyPI

Install the Galitime Python package:

pip install -U galitime

Command-line parameters

$ galitime -h
usage: galitime [-h] --log LOG [--experiment EXPERIMENT] [-v] command

Benchmark a command.

positional arguments:
  command               The command to be benchmarked

options:
  -h, --help            show this help message and exit
  --log LOG             Path to the log file with benchmark statistics (if the directory doesn't exist, it will be created).
  --experiment EXPERIMENT
                        Name of the experiment (to be attached to the output)
  -v                    show program's version number and exit

Output

• experiment - Name of the experiment, if provided via -n

• real_s - Real time in seconds (wall clock time)

• user_s - User CPU time in seconds (user mode, excluding system calls)

• sys_s - System CPU time in seconds (kernel mode)

• percent_cpu - CPU usage percentage

• ram_kb - Maximum RAM usage in kilobytes

• fs_inputs - File system read read operations count

• fs_outputs - File system write operations count

• python_real_s - Python-measured real time in seconds

• command - Command executed, with tabs replaced by spaces

Issues

Please use Github issues.

Changelog

See Releases.

Licence

MIT

Authors

• Karel Brinda <[e-mail]>

• Leandro Lima