Unix/Linux Client for sending spin glass jobs to the server

Download Command Line Client

• NAME
• SYNOPSIS
• DESCRIPTION
• FORMAT INPUTDATA
• OPTIONS
• EXAMPLE
• AUTHOR
• BUGS
• COPYRIGHT

NAME

sendsg.pl - send spin glass meta jobs to the spin glass server system.

SYNOPSIS

sendsg [OPTIONS] -m email@adress -n your_metajobname FILE ...

DESCRIPTION

With this client you can send spin glass samples to the spin glass server for the computation of exact ground states. In contrast to the mail-based server system that we have offered until now, you are not forced any more to send your jobs one after the other. Instead, you can now bundle your jobs to so called 'meta jobs'. A meta job contains a number of single files. Within a meta job, each single instance/sample has to be contained in a single file. Each file contains a spin-glass sample in a particular format.

sendsg awaits at least 3 parameters. First of all, you state the email-address to which the results should be sent back. You can skip the -m option if you place a file named .sendsgrc in your home directory containing a line with your email address, followed by an empty line:

   $email="your@address";

Secondly, you specify the name of the meta job. Finally, you specify which job files belong to the meta job. In the easiest case you simply state the name of the directory in which the job files are stored - followed by a slash and an asterisk, e.g. /home/yourname/foo/*

FORMAT INPUTDATA

The server input format is the same as for the old email-based server. The first line contains the type specification. The second determines the length scale of the lattice. The third line contains a user-defined job name. if you want to name the jobs-files like the filename, you can simply skip the name: command in line 3.

The subsequent lines contain the couplings in the format spin_i spin_j coupling(spin_i,spin_j). We count the spins from 1 to N^2 or N^3, depending on the type. The spins are labeled linearly row after row within one layer, and layer after layer, as you can see here:

        |     |     |
      -(1)---(2)---(3)--
        |     |     |
      -(4)---(5)---(6)--
        |     |     |
      -(7)---(8)---(9)--
        |     |     |

A legal input looks like this:

        type: gauss
        size: 3
        name: 3x3 system as a test for this nice service
        
        1 2 -1.089460678023
        2 3 0.526296171959
        3 1 1.492510060258
        4 5 0.542925533731
        5 6 0.440804946137
        6 4 -0.555618772831
        7 8 0.400843564493
        8 9 0.005781770273
        9 7 -0.283108779696
        1 4 -1.428048251086
        2 5 0.063139021975
        3 6 1.529559080159
        4 7 -1.669458764103
        5 8 0.193231695455
        6 9 1.291781128584
        7 1 0.604670335948
        8 2 0.890948261885
        9 3 -0.822280541834

OPTIONS

-h

show summary of options

-t [long|short]

configure how much detail you want to see in the server output (Default: long) short reports the ground state characteristics only

-m [email]

email address the results will be sent to

-v

verbose mode

-n [meta job name]

set the name of the meta job. e.g. foobar

FILE ...

list of files with spin glass input data

EXAMPLE

sendsg -v -m foo@bar.com -n gauss100 ~/gauss100/*

AUTHOR

Written by Marc Egger.

BUGS

Report bugs to <spinglass-adm@informatik.uni-koeln.de>. For further information, visit www.informatik.uni-koeln.de/spinglass.

COPYRIGHT

Copyright (C) 2007 by Institut fuer Informatik, Koeln.