---
name: "vbbatch"
section: "1"
platform: "linux"
package: "voxbo"
version: "1.8.5~svn1246-3+b1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/vbbatch"
---

# vbbatch(1)

run a command line multiple times with variable substitution

## NAME

vbbatch - run a command line multiple times with variable substitution

## SYNOPSIS

**vbbatch** \<flag\> ...

## DESCRIPTION

**vbbatch** is part of the VoxBo suite of tools for brain image analysis.

**vbbatch** allows you to run a command multiple times with some variable substitutions (typically replacing the token FILE with each of a set of filenames).  The commands are then run in parallel.  If a VoxBo cluster is detected, the jobs will be submitted to the cluster.

## OPTIONS

## EXAMPLES

To run myscript.sh on all your subjects' Anatomy directories:

-

  vbbatch -c "myscript.sh FILE" study\*/sub\*/Anatomy -r

To run myperms.sh 1000 times at low priority, with different output files:

-

  vbbatch -c "myperms.sh results\_IND.nii.gz" -d 1000 -r -p xnice

## AVAILABILITY

Pre-built VoxBo binaries are available for Linux, OSX, and Cygwin, and via the NeuroDebian project (neuro.debian.net) for Debian derivatives.

## CAVEATS

VoxBo is provided with no warranty whatsoever.

## AUTHOR

For an historical roster of the VoxBo development team, visit www.voxbo.org.

## SEE ALSO

For detailed help on any VoxBo command-line program, run it with no arguments.  For graphical programs, use the -h flag.  For more help with VoxBo, for information about the mailing list, or to report bugs, visit the web site at www.voxbo.org.

For information about file format support in VoxBo, see [**voxbo-fileformats**(7)](/voxbo-fileformats/7.md). For general information about VoxBo, see [**voxbo**(7)](/voxbo/7.md).