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 1055 by gezelter, Tue Sep 26 21:55:29 2006 UTC vs.
Revision 1390 by gezelter, Wed Nov 25 20:02:06 2009 UTC

# Line 1 | Line 1
1 < OOPSE
1 > OpenMD
2  
3 < OOPSE is an open-source Object-Oriented Parallel Simulation Engine.
4 < It is primarily used to perform molecular dynamics simulations on
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) or Sutton-Chen (SC) potentials.
3 > OpenMD is an open source molecular dynamics engine which is capable of
4 > efficiently simulating liquids, proteins, nanoparticles, interfaces,
5 > and other complex systems using atom types with orientational degrees
6 > of freedom (e.g. "sticky" atoms, point dipoles, and coarse-grained
7 > assemblies). Proteins, zeolites, lipids, transition metals (bulk, flat
8 > interfaces, and nanoparticles) have all been simulated using force
9 > fields included with the code. OpenMD works on parallel computers
10 > using the Message Passing Interface (MPI), and comes with a number of
11 > analysis and utility programs that are easy to use and modify. An
12 > OpenMD simulation is specified using a very simple meta-data language
13 > that is easy to learn.
14  
15 < Simulations are started in OOPSE using a single Molecular Dynamics (.md)
16 < file.   These files must start with the <OOPSE> tag and must
15 > Simulations are started in OpenMD using a single Molecular Dynamics (.md)
16 > file.   These files must start with the <OpenMD> tag and must
17   have two sections:
18  
19    1) a C-based <MetaData> section, and
# Line 19 | Line 24 | available in the "samples" directory.
24   available in the "doc" directory.  Sample simulations are
25   available in the "samples" directory.
26  
27 < What you need to compile and use OOPSE:
27 > What you need to compile and use OpenMD:
28  
29 < 1) Good C, C++ and Fortran95 compilers.  We've built and tested OOPSE
29 > 1) Good C, C++ and Fortran95 compilers.  We've built and tested OpenMD
30      on the following architecture & compiler combinations:
31  
32      Architecture                CC     CXX     F90     Notes
33      -------------------------   ----   -----   -----   ----------------------
34 <    ix86-pc-linux-gnu           icc    icpc    ifort   (Intel versions 7-9)
35 <    i386-apple-darwin8.7.1      icc    icpc    ifort   (Intel version 9.1)
36 <    powerpc-apple-darwin8.7.0   gcc    g++     xlf95   (GNU v.4 / IBM XL v. 8.1)
37 <    x86_64-unknown-linux-gnu    gcc    g++     pathf95 (GNU v.4 / Pathscale 2.5)
38 <    sparc-sun-solaris2.10       cc     CC      f95     (Sun ONE Studio 10)
39 <    
35 <    We've also successfully compiled OOPSE with the Portland Group c, c++,
36 <    and Fortran95 compilers on the  x86_64-unknown-linux-gnu architecture.
37 <  
38 <    OOPSE uses features of the Fortran 95 language. The fortran
34 >    ix86-pc-linux-gnu           icc    icpc    ifort    (Intel v. 10)
35 >    i686-apple-darwin10.0.0     gcc    g++     gfortran (GNU v.4.3)
36 >    i686-apple-darwin10.0.0     icc    icpc    ifort    (Intel v. 11)
37 >    x86_64-unknown-linux-gnu    gcc    g++     pathf95  (Pathscale 3.2)
38 >
39 >    OpenMD 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
42 <    compilers can be used to compile OOPSE.
42 >    compilers do support these features.
43  
44 <    Fortran compilers that are known to fail on OOPSE: g77, Gfortran,
45 <    Older Portland Group compilers (pgf77, pgf90).
44 >    Compilers that are known to fail on OpenMD: g77, older versions of
45 >    gfortran, older Portland Group compilers (pgf77, pgf90).
46  
47 <    Fortran compilers that are known to work on OOPSE: Intel's ifort,
48 <    Pathscale's pathf95, IBM's xlf95, Portland's pgf95 (version 6 or
47 >    Compilers that are known to work on OpenMD: Intel's ifort,
48 >    Pathscale's pathf95, IBM's xlf95, Portland-F¢s pgf95 (version 6 or-A
49      higher), Sun's f95. There may be others that work also.
50  
51   2) GNU make (also known as gmake).  Regular make won't work.  
# Line 56 | Line 56 | What you need to compile and use OOPSE:
56   3) Perl.  Compilation dependencies in Fortran95 are somewhat
57      complicated, so the build process uses a perl script called
58      filepp to do this job.  You need perl for filepp, so you
59 <    need perl to build OOPSE.
59 >    need perl to build OpenMD.
60  
61 < 4) MPI is optional for the single processor version of OOPSE,
62 <    but is required if you want OOPSE to run in parallel.
61 > 4) MPI-2 is optional for the single processor version of OpenMD, but
62 >    is required if you want OpenMD to run in parallel. We like
63 >    OpenMPI. Other implementations of MPI-2 might work, but we haven-F¢t-A
64 >    tried.   You can get Open MPI here: http://www.open-mpi.org/
65  
64    We like Open MPI.  Other implementations might work, but we
65    haven't tried.  You can get Open MPI here: http://www.open-mpi.org/
66
66   INSTRUCTIONS
67  
68   1) Get, build, and test the required pieces above.
69 < 2) ./configure  (or ./configure --with-mpi=/usr/local/openmpi)
69 > 2) ./configure  
70   3) make
71   4) make install
72  

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines