Debian Codegraph @

README

raw
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.