Your company here — click to reach over 10,000 unique daily visitors

nauty-pickg - Man Page

select graphs according to a variety of properties


[pickg|countg] [-fp#:#q -V -X] [--keys] [-constraints -v] [ifile [ofile]]


countg : Count graphs according to their properties.

pickg : Select graphs according to their properties.

ifile, ofile : Input and output files.

'-' and missing names imply stdin and stdout.

Miscellaneous switches:

-p# -p#:#

Specify range of input lines (first is 1) May fail if input is incremental.


With -p, assume input lines of fixed length (only used with a file in graph6/digraph6 format)


Negate all constraints (but not -p)


Reverse selection (but -p still observed)


List properties of every input matching constraints.


Put a blank line whenever the first parameter changes, if there are at least two parameters.


Write output as lines of numbers separated by spaces, with 0/1 for boolean and both endpoints of ranges given separately even if they are the same, and the count at the end of the line. Also, no total is written.


The same as -1 but counts are not written.


Suppress informative output.


Numerical constraints (shown here with following #) can take a single integer value, or a range like #:#, #:, or :#.  Each can also be preceded by '~', which negates it.   (For example, -~D2:4 will match any maximum degree which is _not_ 2, 3, or 4.) Constraints are applied to all input graphs, and only those which match all constraints are counted or selected.


number of vertices           -e#  number of edges

-ee# number of non-edges (including loops for digraphs)


number of loops              -C   strongly connected

-LL# number of 2-cycles           -cc# number of components


minimum (out-)degree         -D#  maximum (out-)degree


vertices of min (out-)degree -M#  vertices of max (out-)degree


minimum (in-)degree          -U#  maximum (in-)degree


vertices of min (in-)degree  -S#  vertices of max (in-)degree


regular                      -b   bipartite


radius                       -Z#  diameter


girth (0=acyclic)            -Y#  total number of cycles


maximum independent set      -k#  maximum clique


number of triangles          -K#  number of maximal cliques

-TT# number independent 3-sets    -P#

number of 5-cycles


smallest possible first side of a bipartition (0 if nonbipartite)


number of induced cycles     -W#  number of 4-cycles


Eulerian (all degrees are even, connectivity not required)


group size  -o# orbits  -F# fixed points  -t vertex-transitive


connectivity (2 means 2 or more).

-kk# #-tree, otherwise 0. The complete graph K_n is tabulated as

an n-tree, but matches either n-1 or n,


min common nbrs of adjacent vertices;     -ii# maximum


min common nbrs of non-adjacent vertices; -jj# maximum


number of sources            -xx#  number of sinks

-WW# number of diamonds


chromatic number (limited to WORDSIZE colours)

-NN# chromatic index (limited to max degree WORDSIZE-1)

-AA# class (chromatic index - maximum degree + 1)


connectivity                 -GG# edge connectivity

Sort keys:

Counts are made for all graphs passing the constraints.


are given separately for each combination of values occurring for the properties listed as sort keys.  A sort key is introduced by '--' and uses one of the letters known as constraints.  These can be combined:  --n --e  --r  is the same as --ne --r and --ner. The order of sort keys is significant. A comma can be used as a separator.

The sort key ':' has a special purpose: the values of sort keys following ':' are given as ranges rather than creating a separate line for each value. For example --e:zZ will give the ranges of radius and diameter that occur for each number of edges. The output format matches the input, except that sparse6 is used to output an incremental graph whose predecessor is not output.

Some sort keys have boolean variants with parameters:


#-colourable (i.e. chromatic number <= #)


#-edge colourable


#-connected (i.e. connectivity >= #)

--GG# #-edge connected


April 2024 nauty 2.8.8 Nauty Manual