summaryrefslogtreecommitdiff
path: root/README
blob: 956ae9564df1f9fd55bd871b10fd99bd0ff3523f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
LPIC++ 1.3 SOURCE CODE DISTRIBUTION
===================================

  LPIC++ is a one-dimensional relativistic electromagnetic
  Particle-In-Cell (PIC) code for simulating the interaction 
  of laser light with plasma.
  You will find the complete documentation in pdf format in 
  directory 'lpic-*/doc/' after unpacking  LPIC++.
  LPIC++ is written in C++ and is supposed to run on any 
  Unix platform like Linux, Solaris, SunOS, AIX, etc. 
  It has been tested and used extensively under AIX.


DEPENDENCIES
============

  The parallelized version of LPIC++ requires one of the 
  following packages. If you want to run lpic as a single process
  only, you can ignore this section.

  - PVM (Parallel Virtual Machine), "a software system that 
    enables a collection of heterogeneous computers to be used 
    as a coherent and flexible concurrent computational resource". 
    Homepage:        http://www.csm.ornl.gov/pvm/pvm_home.html
    Download source: http://www.netlib.org/pvm3/index.html
    PVM's source code needs slight modifications in order to
    compile on Mac OS X. A modified package is available from
    http://hpc.sourceforge.net

  - LAM/MPI, an open-source implementation of the Message Passing
    Interface specification (www.mpi-forum.org).
    Homepage and Source: http://www.lam-mpi.org
    LAM/MPI is also available as binary Debian, rpm, Fink and 
    Apple Mac OS X packages. 

  LPIC++ was used from 1994 to 1997 under AIX with pvm3.2.6 and 
  pvm3.3.11.


INSTALL
=======

  1) Unpack the archive:

     Copy 'lpic-*.tar.gz' to the directory where you would like 
     to install LPIC++, change to this directory and type

       'gunzip lpic-*.tar.gz'
       'tar -xvf lpic-*.tar'

     Change to directory 'lpic-*'. 
     Installation is then done in three GNU steps:

  2) ./configure

     run "./configure --help" for options
     typical configurations:
       ./configure                                           
       ./configure --enable-pvm                         
       ./configure --enable-pvm \
                   --with-pvm-include=/usr/local/include \
                   --with-pvm-lib=/usr/local/lib

  3) make

  4) (sudo) make install-exec

  Installation has been tested so far on 
  - Mac OS X 10.3 and 10.4
  - Cygwin
  - Red Hat Linux 8.0 3.2-7


DISTRIBUTION
============

  Change to the pic directory and type "make dist".

     
USAGE AND DOCUMENTATION
=======================

  Read 'mpq225.pdf' in directory lpic-*/doc.


FEEDBACK
========

  Please send any feedback to kemp@physics.unr.edu or pic@lichters.net