INSTALL
author Forrest Hoffman <forrest@climatemodeling.org>
Wed, 26 Sep 2007 17:50:53 -0400
changeset 0 5fda18b64dcb
permissions -rw-r--r--
Initial commit of the Fortran-90 version of the Fractal Realizer.
     1 The Fractal Realizer
     2 May 25, 2007
     3 
     4 The Fractal Realizer has been rewritten in Fortran-90.  There are
     5 no longer any pieces of code in C.  The visualization feature (using
     6 DrawPixmap) has been eliminated, since maps can be viewed as XPM files
     7 after running the model.  The new code has been compiled and tested
     8 with gfortran under Linux on an Athlon-64 box.  Example scripts and
     9 data are available in directories below examples/.  The code is in
    10 the src/ directory.  The previous README file is still included here
    11 as README.previous.
    12 
    13 Installation
    14 ------------
    15 If you are using gfortran under Linux, simply do the following to build
    16 and install the Fractal Realizer.  Download the code and examples:
    17 
    18 	$ wget http://www.geobabble.org/~hnw/frdist.90
    19 
    20 Then extract the code and examples:
    21 
    22 	$ tar xvzf frdist90.tar.gz
    23 
    24 Next, build the code:
    25 
    26 	$ cd frdist90/src
    27 	$ make
    28 
    29 This will produce the binary program called realizer.  To install the
    30 Fractal Realizer in /usr/local/bin:
    31 
    32 	$ sudo make install
    33 
    34 Execution
    35 ---------
    36 
    37 The Fractal Realizer has many options, and some of these are mutually
    38 exclusive. Simply running the executable begins a cascade of questions
    39 from the model which query the user to set up the options for the
    40 simulation run. Responses to the questions direct the subsequent
    41 questions, changing the way that the option tree is traversed. This
    42 verbose interaction mode is a good way to become familiar with the wide
    43 array of Fractal Realizer options. After all questions are answered,
    44 the simulation begins.
    45 
    46 Because answering all of the input questions for each run would be
    47 tedious, the Fractal Realizer writes a script file, inpout.scr, containing
    48 the input answers from the last run. Thus, the last simulation can be
    49 repeated by issuing the command:
    50 
    51 	$ realizer < input.scr
    52 
    53 To change a few input settings, it is not necessary to wade through all
    54 of the input questions again. Instead, simply edit the input.scr script
    55 file directly, and then re-run the simulation using the modified script
    56 file. Mnemonic comments within the script file aid in such editing
    57 process.
    58 
    59 A number of demonstration .scr script files are included in the in the
    60 examples/ directory, and running these "canned" examples is a good way to
    61 test the installation, as well as to see the capabilities of the Fractal
    62 Realizer. Final landscapes and tie maps can be output in several formats,
    63 including XPM and GRASS.
    64 
    65 The FR program uses a heap sort to sort the entire map to find the
    66 highest probability sites, so execution time will increase rapidly as
    67 the size of the map is increased. Execution time also increases with
    68 increasing numbers of categories in the map. Because of the midpoint
    69 displacement algorithm for generating (pseudo)fractals, the maps must
    70 be square, with sides of (2**n)+1. However, the use of constraint masks
    71 will permit oddly-shaped and smaller synthetic maps to be generated
    72 while still preserving both p and the fractal dimension of each category.
    73 
    74 The Fractal Realizer has proven useful and stimulating.  Be sure
    75 to read and cite our paper in Conservation Ecology available at
    76 http://www.ecologyandsociety.org/vol6/iss1/art2/
    77 
    78 Bill and Forrest
    79 -------------------------------------------------------------------------------
    80 William W. Hargrove
    81 Eastern Forest Environmental Threat Assessment Center
    82 USDA Forest Service
    83 Southern Research Station
    84 200 WT Weaver Boulevard
    85 Asheville, NC  28804-3454
    86 -------------------------------------------------------------------------------
    87 Forrest Hoffman                       mailto:forrest@climatemodeling.org
    88 Oak Ridge National Laboratory         mailto:forrest@computer.org
    89 Climate & Carbon Research Institute   http://www.climatemodeling.org/~forrest
    90 Computer Science & Mathematics Div.   (865) 576-7680 voice
    91 Building 5600, Room C221, MS 6016     (865) 576-5491 fax
    92 P.O. Box 2008                         Deliveries: Bethel Valley Road
    93 Oak Ridge TN 37831-6016               35� 55' 23" N   84� 19' 20" W
    94 -------------------------------------------------------------------------------