home *** CD-ROM | disk | FTP | other *** search
/ Photo CD Demo 1 / Demo.bin / cellsim / v2_5 / installt < prev    next >
Text File  |  1990-02-26  |  5KB  |  94 lines
  1.               Installation notes
  2.              Cellsim version 2.5
  3.                 February 1990
  4.  
  5.  
  6. ***************************
  7. INSTALLING CELLSIM ON A SUN
  8. ***************************
  9. To compile Cellsim:
  10.       Go to the "src" directory, and edit the file "Makefile".  At the
  11.       top of the file, you will see four directory-definitions, which
  12.       tell Cellsim where to look for files when it can't find them in the
  13.       current directory.
  14.       Change these four definitions to point to the proper directories
  15.       where Cellsim is located, or else follow the instructions in the
  16.       makefile to disable these defaults.  Be sure to use the full
  17.       pathname for any directories you put there.
  18.  
  19.       If you are running SunOS 4.0 or later, then you can simply type "make"
  20.       from within the "src" directory.  However, if you are running SunOS 3.5,
  21.       you must edit the "Makefile" once more.  Comment out the first
  22.       definition of "OPT", and uncomment the second definition (there are
  23.       comments in the Makefile to help you with this).  This is necessary
  24.       because the "-Bstatic" option is needed under 4.0, but the 3.5 C compiler
  25.       does not recognize that option.
  26.  
  27.       Then, simply type "make".  This will compile cellsim into an
  28.       executable file called either "cell.sun3" or "cell.sun4", depending
  29.       on which architecture you are compiling on.  You may move this executable
  30.       wherever you like (e.g. /usr/local/bin, or your own personal
  31.       bin directory).
  32.  
  33. Example rules and user-written rules: 
  34.       Go to the "Rule_src" directory.  Edit the file "Makefile", and
  35.       change the definition of "MDIR" on line 2 to contain the full
  36.       pathname of the "Rule_mdir" directory.  This is necessary to compile
  37.       your own rules, so the Makefile will know where to link in the
  38.       necessary files and find the necessary include file "nborhood.h".
  39.       You may also want to change the definitions of TABLE_DIR and FCN_DIR
  40.       to point to the location where you want lookup-table rules and
  41.       computed-fcn rules to go.
  42.       Once you've done that, type "make_demos" from within the "Rule_src"
  43.       directory.  That will compile the computed-function rules (".o" files),
  44.       and move them into the "Rules" directory.
  45.  
  46.  
  47. ******************************************
  48. INSTALLING THE CONNECTION MACHINE SOFTWARE
  49. ******************************************
  50.  
  51.   If you won't be using a Connection Machine, you might as well delete
  52. the CM software, which is in the file "CM.tar", to save disk space, and
  53. stop reading now.
  54.  
  55.   Otherwise, if you do have access to a CM, you should put that file
  56. "CM.tar" on the CM front-end (CMFE) that you will be using to attach
  57. to the CM (e.g. use FTP to send the tarfile to the CMFE).  Once there,
  58. in the directory which you want to install the software under, type
  59. "tar xvf CM.tar".  That will extract everything from the tarfile, and
  60. put it under a directory "Cellsim2.5.CM2".  You can remove the tarfile
  61. once you've extracted its contents.
  62.  
  63.   Once you've extracted the files, you should go to the "Cellsim2.5.CM2"
  64. directory.  Edit the "Makefile" -- there are several definitions you
  65. need to supply:
  66.   FULL_CMATTACH : the full pathname of the "cmattach" command
  67.   FULL_CM_CELL_DIR : the full pathname of the directory this Makefile is in
  68.   CM_IMAGE_DIR : pathname of a directory containing images on the CMFE,
  69.          if there is one
  70.   CM_FCN_DIR : pathname of directory on CMFE containing Paris-rule ".o" files
  71.   CM_TABLE_DIR : pathname of directory containing lookup-tables
  72.   CMFB_EXISTS : if you will be using a CM Frame-Buffer (CMFB) to display
  73.         your images, set this to 1, otherwise set it to 0
  74.  
  75. Once you've edited those definitions in the Makefile, you should just be
  76. able to type "make" to compile the "cm_cell" executable.  "cm_cell" is
  77. the program that attaches to the CM, and which Cellsim calls up to interact
  78. with the CM.  (See the "CM.doc" file in the "doc" directory for information
  79. on using the CM with Cellsim).
  80.  
  81.  
  82.   One other thing you should do is go to the "Rule_src" directory under
  83. the "Cellsim2.5.CM2" directory.  There, you will find another Makefile.
  84. You should change the definition of CM_MDIR on line 2 to point to the
  85. full pathname of the Cellsim2.5.CM2/Rule_mdir directory.  Users who want
  86. to write their own C/Paris update-rules will copy this Makefile, and
  87. it must point to the Rule_mdir where the include-file and shell-scripts
  88. necessary to compile C/Paris update-rules reside.  You can also edit
  89. the definitions of TABLE_DIR and FCN_DIR to point to the directories
  90. where you want to put lookup-table rules and computed-function rules.
  91.  
  92.   Again, type "make_demos" to generate the sample rules as you did for
  93. the Sun-based rules.
  94.