DDS(6)								   Games Manual 							    DDS(6)

NAME

       dds - double dummy solver frontend

SYNOPSIS

       dds file [ options ]

DESCRIPTION

       This program is a command line interface for Bo Haglund's Double Dummy Solver (DDS).

       It has four useful stand-alone options:

       1.     Option -playdd, to play any deal double dummy.

       2.     Option  -giblib.	For any deal, to get maximum trick values for all possible contracts and leaders (these are the 20 trick values as
	      for giblib).

       3.     Option -tricks. For specified deal, to get maximum trick values for all possible contracts and leaders (these are the 20 trick  val-
	      ues as for giblib).

       4.     Option -gen. This is to generate deals, without or with up to 20 possible trick values.

OPTIONS

       file path for 'giblib' input file

       Optional arguments [options] are one or more of:

       -v     verbose where applicable

       -target=d
	      -1-13  (default  -1).   Number of tricks to be won by the side to play, -1 means that the program shall find the maximum number. For
	      equivalent cards only the highest is returned.

       -sol=d solution 1/2/3 (default 3).  How many card solutions SolveBoard returns:

	      target=1-13, solutions=1:  Returns only one of the cards. Its returned score is the same as target when target or higher tricks  can
	      be won. Otherwise, score -1 is returned if target cannot be reached, or score 0 if no tricks can be won.

	      target=-1, solutions=1:  Returns only one of the optimum cards and its score.

	      target=0, solutions=1:  Returns only one of the cards legal to play with score set to 0.

	      target=1-13,  solutions=2:   Return  all	cards  meeting	target. Their returned scores are the same as target when target or higher
	      tricks can be won.  Otherwise, only one card is returned with score -1 if target cannot be reached, or score 0 for all  cards  legal
	      to play if no tricks can be won.

	      target=-1, solutions=2:  Return all optimum cards with their scores.

	      target=0, solutions=2:  Return all cards legal to play with scores set to 0.

	      target irrelevant, solutions=3:  Return all cards that can be legally played with their scores in descending  order.

       -mode=d
	      0/1 (default 1).	DLL mode of operation. This mode does not affect the DLL if there are multiple choices for cards to play. If there
	      is just one card to play, or multiple cards that are all equivalent, this mode determines  whether or not the  DLL  will	search	to
	      find the score.

	      mode=0:	Do not search to find the score if the hand to play has only one card, including its equivalents, to play. Score is set to
	      -2 for this card, indicating that there are no alternative cards. This mode is very fast.

	      mode=1:  Always search to find the score. Even when the hand to play has only one card,  with possible equivalents, to play.

       -trumps=t
	      s/h/d/c/n, this overrides the file (default=n)

       -leader=l
	      w/n/e/s, this overrides the file (default=w) but used only when no cards have been played

       -deal=d
	      1/2/... deal number in giblib file.  Only one of -deal or -name should be specified.

       -name=str
	      deal with 'name=str' in giblib file.  Only one of -deal or -name should be specified.

       -playdd
	      play deal choosing between DDS alternatives

       -timeall
	      time all deals in file for sol=1/2/3, print stats

       -timeg=xcn
	       x - hex digit, total tricks by n-s
	       c - contract s/h/d/c/n
	       n - number of deals

	      time the first n deals in the giblib file, having total tricks x at contract c, for  target=-1  sol=1  mode=1  and  for  the  speci-
	      fied/default leader, each deal is validated.

       -giblib=d1-d2[-all]
	      validate	all  deals  from  d1 to d2 in giblib file for target=-1 sol=1 mode=1.  1. if -all is given, this is done for all of the 20
	      trick values even if some of them are '-'.  2. if -all is not given, this is done only for those trick values which are not '-'.

       -tricks
	      like -giblib, but for single deal specified by -name=str -deal=d or option

       Generate deals:

       -gen=n (required) n=number of deals to generate.  output is written to a file (see below)

       -genseed=s
	      (default 0) seed for random generator

       -gencards=c
	      (default=52) number of cards generated per deal, must be multiple of 4

       -gentricks=t
	      0,1,...,20 (default 1), number of tricks values to set randomly

       Generate output is written to a file:
	      gen-genseed-ndeal-gencards-gentricks.txt

NOTES

       The program was named ddd by its author. As there is already some other ddd package in Debian (the gdb frontend) it was renamed to dds, the
       name of the library used.

SEE ALSO

       dealer(6), deal(6).

																	    DDS(6)