ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/group/trunk/OOPSE-1.0/README
Revision: 1419
Committed: Tue Jul 27 18:14:16 2004 UTC (19 years, 11 months ago) by gezelter
File size: 2461 byte(s)
Log Message:
BASS eradication project (part 3)

File Contents

# User Rev Content
1 gezelter 1334 OOPSE
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).
9    
10 gezelter 1419 Simulations are started in OOPSE using two files:
11 gezelter 1334
12 gezelter 1419 1) a C-based meta-data (.md) file, and
13    
14     2) a modified XYZ format for initial coordinate and velocity information.
15    
16     Detailed descriptions of the structures of these two files are
17     available in the "doc" directory. Sample simulations are
18     available in the "samples" directory.
19    
20 gezelter 1334 What you need to compile and use OOPSE:
21    
22     1) Good C, C++ and Fortran95 compilers. We've built and tested OOPSE
23 gezelter 1365 on the following architecture & compiler combinations:
24 gezelter 1334
25 gezelter 1365 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)
31    
32     We've successfully compiled OOPSE with gcc and g++, as well as
33     pgcc and pgCC in linux environments. However, you will need to
34     use a Fortran *95* compler for the fortran side of OOPSE, and
35     pgf90 does not implement the required portions of the f95
36     language. Fortran77 and Fortran90 (i.e. g77 and pgf90) are *not*
37     sufficient to compile the fortran portions of OOPSE.
38 gezelter 1334
39 gezelter 1365 2) The Scalable Parallel Random Number Generators Library (SPRNG). You
40 gezelter 1366 can obtain SPRNG here: http://sprng.cs.fsu.edu/
41 gezelter 1365 SPRNG is a *requirement* for compiling OOPSE.
42 gezelter 1334
43 gezelter 1365 3) MPI. We like MPICH. Other implementations might work, but we
44     haven't tried. You can get MPICH here:
45     http://www-unix.mcs.anl.gov/mpi/mpich/
46     MPI is only required if you want a parallel version of OOPSE.
47 gezelter 1334
48 gezelter 1365 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    
53 gezelter 1334 INSTRUCTIONS
54    
55     1) Get, build, and test the required pieces above.
56     2) ./configure
57     3) make
58     4) make install
59    
60     That's it. Documentation will be forthcoming after the paper is
61     published.
62