Batchsettings

SoNIA Batch Settings

The batch settings file ( or string) provides a way to include multiple properties objects in order to configure most of SoNIAs parameters from the command line. The settings/properties objects that are not specified will be left at their defaults.

The property names and values are case sensitive and not very well standardized yet (June 07) so usually the best way to create a batch file is to load your data into sonia using the gui, work with it until you find the settings that give you stable results, and then paste the poperty definitions from the log window into a text file. Make sure you include the "SettingsClass=.." line for each entry, this is how the property builder recognizes the key:value pairs. Lines must be terminated with the new lines ("\n")

for example

SettingsClass=sonia.settings.BrowsingSettings
render offset=0
num interpolated frames=10
render duration=2.5
frame delay=30
SettingsClass=sonia.settings.ApplySettings
min epsilon=.1
LAYOUT_REPAINT_N=0
cool factor=0.25
ALG_PROP_KEYS=springConst,min epsilon,optimum dist,cool factor,comp connect value,max passes
max passes=500.0
optimum dist=20.0
Algorithm_Name=Multiple component Kamada-Kawai layout
RECENTER_TRANSFORM=recenter after layout
STARTING_COORDS=from previous slice
RESCALE_LAYOUT=none
springConst=1.0
TRANSFORM_ISOLATE_EXCLUDE=false
ISOLATE_POSITION=ignore isolates
comp connect value=15
STOP_ON_ERROR=false
APPLY_REMAINING=false
SettingsClass=sonia.settings.MovieSettings
OUTPUT_PATH=/myDir/myMovieName.mov
FILE_TYPE=mov
FORMAT_PARAMS=CODEC
CODEC=Animation

If you include the text above in text file and provide the filename as an argument to batch setings, it should generate a movie with those settings

java -jar soniaXYZ.jar file:myInputFile.son batchsettings:myBatchSettings.txt runbatch:

Note that you can also included the batch params as one long quoted argument:

java -jar soniaXYZ.jar file:myInputFile.son batchsettings:"SettingsClass=sonia.settings.BrowsingSettings
render offset=0
num interpolated frames=10
render duration=2.5
frame delay=30
SettingsClass=sonia.settings.ApplySettings
min epsilon=.1
LAYOUT_REPAINT_N=0
<snip>
"

This is useful if you are launching sonia from inside anothe program and don't want to write out the batch file. (this is how it is done when launching from rSoNIA). The rule is that if the argument to batchsettings: points to a valid file, it will read the contents of that file, otherwise it will try to parse the argument directly.