This software is licensed for general copying, distribution and modification according to the GNU General Public License.
The software is most easily run on a Unix-like computer (such as Sun, or Linux, or Mac OS X), as we now describe (though a method to run it on a Windows machine is described in the README file). You will need to have "cc" and "wget" installed. ("cc" or "gcc" is the C compiler; on Linux/Unix it should come pre-loaded, but for Mac you might need to install the Xcode package. "wget" is a simple program for downloading web files, available from e.g. here; for Mac see here and here; or you can forget wget and just use your usual web browser to download the files directly instead.)
To run the software, first download and save the zip file deciphermcmc.zip.
Then, unzip that zip file (thereby creating a new directory "deciphermcmc"), by typing:
unzip deciphermcmc.zipThen, on Unix systems, move into that directory and compile the programs, by typing:
cd deciphermcmcThen download relevant texts, such as War and Peace and Oliver Twist, by typing e.g.:
cc -lm simplify.c -o simplify
wget http://www.gutenberg.org/files/2600/2600.txt -O warnpc12.txt(or by downloading them directly using your web browser, and saving them as "warnpc12.txt" and "olivertwist.txt" respectively).
wget http://www.gutenberg.org/files/730/730.txt -O olivertwist.txt
Then simplify them, by typing e.g.:
./simplify < warnpc12.txt > warorigYou can then run the program, to use MCMC algorithms to repeatedly attempt to decrypt Oliver Twist (using War and Peace as the reference text), by typing:
./simplify < olivertwist.txt > oliverorig
./deciphermcmcTo learn how to modify the MCMC parameters, change the testing configuration, use different text samples, run the program on Microsoft Windows machines, and more, see the README file.
You may contact us with questions.
-- Jian Chen and Jeffrey S. Rosenthal