ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/OpenMD/branches/development/README
(Generate patch)

Comparing trunk/README (file contents):
Revision 2 by gezelter, Fri Sep 24 04:16:43 2004 UTC vs.
Revision 956 by gezelter, Tue May 16 02:06:37 2006 UTC

# Line 5 | Line 5 | packages.  This includes atoms with orientational degr
5   "strange" atom types that are not normally handled by other simulation
6   packages.  This includes atoms with orientational degrees of freedom
7   (point dipoles, sticky atoms), as well as transition metals under the
8 < Embedded Atom Method (EAM).
8 > Embedded Atom Method (EAM) or Sutton-Chen (SC) potentials.
9  
10   Simulations are started in OOPSE using two files:
11  
# Line 24 | Line 24 | What you need to compile and use OOPSE:
24  
25      Architecture                CC     CXX     F90    Notes
26      -------------------------   ----   -----   -----  ----------------------
27 <    ix86-pc-linux-gnu           icc    icpc    ifort  (Intel versions 7 & 8)
28 <    powerpc-apple-darwin7.4.0   xlc    xlc++   xlf    (IBM XL v. 6.0/8.1)
29 <    mips-sgi-irix6.5            cc     CC      f90    (MIPSpro 7.4)
30 <    sparc-sun-solaris2.8        cc     CC      f95    (Forte Developer 7)
27 >    ix86-pc-linux-gnu           icc    icpc    ifort  (Intel versions 7-9)
28 >    i386-apple-darwin8.6.1      icc    icpc    ifort  (Intel version 9.1)
29 >    powerpc-apple-darwin8.6.0   gcc    g++     xlf95  (GNU v.4 / IBM XL v. 8.1)
30 >    x86_64-unknown-linux-gnu    pgcc   pgCC    pgf95  (Portland Group v. 6.0)
31 >    sparc-sun-solaris2.10       cc     CC      f95    (Sun ONE Studio 10)
32      
33 <    We've successfully compiled OOPSE with gcc and g++, as well as
34 <    pgcc and pgCC in linux environments.  However, you will need to
35 <    use a Fortran *95* compler for the fortran side of OOPSE, and
36 <    pgf90 does not implement the required portions of the f95
37 <    language.  Fortran77 and Fortran90 (i.e. g77 and pgf90) are *not*
38 <    sufficient to compile the fortran portions of OOPSE.
33 >    We've successfully compiled OOPSE with the Pathscale c, c++, and
34 >    Fortran95 compilers on the  x86_64-unknown-linux-gnu architecture,
35 >    but a bug in the exception handling on these compilers causes
36 >    OOPSE to abort (rather than providing a useful error message) when
37 >    an error is found in the meta-data file.
38 >  
39 >    OOPSE uses features of the Fortran 95 language. The fortran
40 >    portions of our code will not compile if your compiler does not
41 >    support these particular features. Some (but not all) Fortran 90
42 >    compilers do support these features. None of the Fortran 77
43 >    compilers can be used to compile OOPSE.
44  
45 < 2) The Scalable Parallel Random Number Generators Library (SPRNG). You
46 <    can obtain SPRNG here:  http://sprng.cs.fsu.edu/
41 <    SPRNG is a *requirement* for compiling OOPSE.
45 >    Compilers that are known to fail on OOPSE: g77, Gfortran, Older
46 >    Portland Group compilers (pgf77, pgf90).
47  
48 < 3) MPI.  We like MPICH.  Other implementations might work, but we
48 >    Compilers that are known to work on OOPSE: Intel's ifort,
49 >    Pathscale's pathf95, IBM's xlf95, Portland's pgf95 (version 6 or
50 >    higher), Sun's f95. There may be others that work also.
51 >
52 > 2) GNU make (also known as gmake).  Regular make won't work.  
53 >    Really.  We've tried.  Don't bother with regular make.  
54 >    Seriously.  You need GNU make.  Did we mention that you
55 >    need GNU make?
56 >
57 > 3) Perl.  Compilation dependencies in Fortran95 are somewhat
58 >    complicated, so the build process uses a perl script called
59 >    filepp to do this job.  You need perl for filepp, so you
60 >    need perl to build OOPSE.
61 >
62 > 4) MPI is optional for the single processor version of OOPSE,
63 >    but is required if you want OOPSE to run in parallel.
64 >
65 >    We like MPICH-1.2.*.  Other implementations might work, but we
66      haven't tried.  You can get MPICH here:
67      http://www-unix.mcs.anl.gov/mpi/mpich/
46    MPI is only required if you want a parallel version of OOPSE.
68  
48 4) Assorted unix utilities (lexx, yacc, make) or their GNU
49    equivalents.  The Gnu version of make is pretty much a requirement on
50    SGI machines.  
51        
52
69   INSTRUCTIONS
70  
71   1) Get, build, and test the required pieces above.
72 < 2) ./configure
72 > 2) ./configure  (or ./configure --with-mpi=/usr/local/mpich)
73   3) make
74   4) make install
75  
76 < That's it.  Documentation will be forthcoming after the paper is
61 < published.
62 <
76 > That's it.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines