| 1 |
README file for nauty 2.9 |
| 2 |
|
| 3 |
Brendan McKay, [email protected] |
| 4 |
Adolfo Piperno, [email protected] |
| 5 |
|
| 6 |
------------------------------------------------------------ |
| 7 |
|
| 8 |
The most recent distribution of nauty and Traces can be found at |
| 9 |
http://cs.anu.edu.au/~bdm/nauty and http://pallini.di.uniroma1.it . |
| 10 |
|
| 11 |
The manual nug28.pdf is available at that site and is also included |
| 12 |
in the distribution package. |
| 13 |
|
| 14 |
Note that nauty and Traces are copyright but free to use for most |
| 15 |
purposes. The details are in the file COPYRIGHT. |
| 16 |
|
| 17 |
------------------------------------------------------------ |
| 18 |
|
| 19 |
INSTALLATION. |
| 20 |
|
| 21 |
See the manual for more information. |
| 22 |
|
| 23 |
If you have a working shell, and "make", you can run |
| 24 |
./configure |
| 25 |
followed by |
| 26 |
make |
| 27 |
to compile nauty and Traces for your system. |
| 28 |
|
| 29 |
If that succeeds without problem, you will have the |
| 30 |
program dreadnaut ready to run. |
| 31 |
|
| 32 |
There are some options that can be specified at the ./configure |
| 33 |
step; see the manual. |
| 34 |
|
| 35 |
If you don't have a shell or make, manually edit the files nauty.h, |
| 36 |
naututil.h and gtools.h as distributed. The parts between the lines |
| 37 |
======= near the start are the main things to look at. After this |
| 38 |
manual editing, you can use makefile.basic as a guide to compilation. |
| 39 |
|
| 40 |
Programs which use an older version of nauty need to be |
| 41 |
recompiled (** not just relinked **). Make sure they define |
| 42 |
the options structure using one of |
| 43 |
DEFAULTOPTIONS_GRAPH |
| 44 |
DEFAULTOPTIONS_SPARSEGRAPH |
| 45 |
DEFAULTOPTIONS_DIGRAPH |
| 46 |
DEFAULTOPTIONS_SPARSEDIGRAPH |
| 47 |
DEFAULTOPTIONS_TRACES |
| 48 |
|
| 49 |
------------------------------------------------------------ |
| 50 |
|
| 51 |
TESTING. |
| 52 |
|
| 53 |
After compiling nauty successfully, it is recommended that you run |
| 54 |
the included test programs. The simplest way is |
| 55 |
make checks |
| 56 |
|
| 57 |
------------------------------------------------------------ |
| 58 |
|
| 59 |
MAILING LIST. |
| 60 |
|
| 61 |
There is a mailing list for announcements and discussion about |
| 62 |
nauty and related topics. You can subscribe at |
| 63 |
http://mailman.anu.edu.au/mailman/listinfo/nauty |
| 64 |
|
| 65 |
------------------------------------------------------------ |
| 66 |
|
| 67 |
OTHER FILES IN THE PACKAGE. |
| 68 |
|
| 69 |
Also in the package (documentation at the start of each source file). |
| 70 |
|
| 71 |
sumlines.c - This is a program designed to digest the outputs from |
| 72 |
multiple runs of a program (such as a computation split into multiple |
| 73 |
parts). Lines matching given patterns can be counted and checked, |
| 74 |
and numbers appearing in them can be accumulated. Instructions appear |
| 75 |
in the source file. See the option GMP near the head of the program |
| 76 |
before trying to compile. |
| 77 |
|
| 78 |
sorttemplates.c - Some carefully tuned generic quicksort procedures. |
| 79 |
|
| 80 |
------------------------------------------------------------ |
| 81 |
|
| 82 |
Windows. |
| 83 |
|
| 84 |
For running nauty in Windows, Cygwin is recommended. |
| 85 |
|
| 86 |
If configure gives an error message similar to this: |
| 87 |
can not guess host type: you must specify one |
| 88 |
then try |
| 89 |
./configure --build=unknown |
| 90 |
|
| 91 |
------------------------------------------------------------ |
| 92 |
|
| 93 |
Making 32-bit executables on 64-bit Linux systems. |
| 94 |
|
| 95 |
(In bash or sh:) |
| 96 |
./configure CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 |
| 97 |
make clean; make |
| 98 |
|
| 99 |
This requires 32-bit libraries to be available. On Ubuntu |
| 100 |
they are called ia32-libs and libc6-dev-i386. |
| 101 |
|
| 102 |
------------------------------------------------------------ |
| 103 |
|
| 104 |
RECENT CHANGES. |
| 105 |
|
| 106 |
See the file changes24-28.txt for a list. |
| 107 |
See the file README_24 for a list of older changes. |