|
| 1 | +Introduction |
| 2 | +============ |
| 3 | +DDS is a double-dummy solver of bridge hands. It is provided as a Windows DLL and as C++ source code suitable for a number of operating systems. It supports single-threading and multi-threading for improved performance. |
| 4 | + |
| 5 | +DDS offers a wide range of functions, including par-score calculations. |
| 6 | + |
| 7 | +Please refer to the [home page](http://privat.bahnhof.se/wb758135) for details. |
| 8 | + |
| 9 | +The current version is DDS 2.8.0 released in November 2014 and licensed under the Apache 2.0 license in the LICENSE FILE. |
| 10 | + |
| 11 | +Release notes are in the ChangeLog file. |
| 12 | + |
| 13 | +(c) Bo Haglund 2006-2014, (c) Bo Haglund / Soren Hein 2014. |
| 14 | + |
| 15 | + |
| 16 | +Credits |
| 17 | +======= |
| 18 | +Many people have generously contributed ideas, code and time to make DDS a great program. While leaving out many people, we thank the following here. |
| 19 | + |
| 20 | +The code in Par.cpp for calculating par scores and contracts is based on Matthew Kidd's perl code for ACBLmerge. He has kindly given permission to include a C++ adaptation in DDS. |
| 21 | + |
| 22 | +Alex Martelli cleaned up and ported code to Linux and to Mac OS X in 2006. The code grew a bit outdated over time, and in 2014 Matthew Kidd contributed updates. |
| 23 | + |
| 24 | +Brian Dickens found bugs in v2.7 and encouraged us to look at GitHub. He also set up the entire historical archive and supervised our first baby steps on GitHub. |
| 25 | + |
| 26 | +Foppe Hemminga maintains DDS on ArchLinux. |
| 27 | + |
| 28 | +Soren Hein made a number of contributions before becoming a co-author starting in v2.8 in 2014. |
| 29 | + |
| 30 | + |
| 31 | +Overview |
| 32 | +======== |
| 33 | + |
| 34 | +The distribution consists of the following directories. |
| 35 | + |
| 36 | +* **src**, the source code for the library. |
| 37 | +* **include**, where the public interface of the library is specified. |
| 38 | +* **lib**, the place where the library file is "installed" for test purposes. |
| 39 | +* **doc**, where the library interface is documented and the algorithms behind DDS are explained at a high level. |
| 40 | +* hands, a repository for input files to the test programs. |
| 41 | +* **test**, a test program. |
| 42 | +* **examples**, some minimal programs showing how to interface in practice with a number of library functions. |
| 43 | + |
| 44 | +There is a parallel distribution, **ddd**, consisting of an old driver program for DDS contributed under the GPL (not under the Apache license) by Flip Cronje and updated by us to support the multi-threaded library file. |
| 45 | + |
| 46 | + |
| 47 | +Supported systems |
| 48 | +================= |
| 49 | +The DLLs work out of the box on Windows systems. There is a single-threaded version for old Windows versions, and there is a multi-threaded version that works on all modern Windows systems. This is the one you should use if in doubt. |
| 50 | + |
| 51 | +The Windows versions use the Windows multi-threading. The code compiles on windows (see INSTALL) with at least: |
| 52 | + |
| 53 | +* Visual C++ 2010 Express editions or later. |
| 54 | +* The TDM-GCC/Mingw port of g++. |
| 55 | +* g++ on Cygwin. |
| 56 | + |
| 57 | +We have also compiled the code and/or had help from other contributors on the following systems. |
| 58 | + |
| 59 | +* Linux Ubuntu with g++ and with OpenMP multi-threading. |
| 60 | +* Mac OS 10.9 with g++ and with OpenMP multi-threading. Also with clang without multi-threading. |
| 61 | + |
| 62 | +Here the libraries are .a files, not DLLs. We might also make .so libraries in the future. |
| 63 | + |
| 64 | +Note that Apple stopped using g++ in Xcode a while back, DDS does compile using the clang compiler, but since DDS does not support pthreads multi-threading, DDS becomes single-threaded. To get OpenMP multi-threading you need to use the Homebrew installer and do a "brew reinstall gcc --without-multilib". The "without-multilib" is important because you won't get OpenMP otherwise, and that's the whole point. Thanks for Matthew Kidd for these instructions. |
| 65 | + |
| 66 | + |
| 67 | +Usage |
| 68 | +===== |
| 69 | + |
| 70 | +DDS tries to figure out the available number of cores and the available memory. Based on this, DDS calculates a reasonable number of threads to use. The user can override this by calling the SetMaxThreads() function. In principle SetMaxThreads() can be called multiple times, but there is overhead associated with this, so only call it at the beginning of your program unless you really want to change the number of threads dynamically. |
| 71 | + |
| 72 | +DDS on Windows calls SetMaxThreads() itself when it is attached to a process, so you don't have to. On Unix-like systems we use an equivalent mechanism, but we have had a report that this does not always happen in the right order of things, so you may want to call SetMaxThreads() explicitly. |
| 73 | + |
| 74 | + |
| 75 | +Bugs |
| 76 | +==== |
| 77 | +Version 2.8.0 has no known bugs. |
| 78 | + |
| 79 | +Please report bugs to bo.haglund@bahnhof.se and soren.hein@gmail.com. |
| 80 | + |
0 commit comments