readme.install

pic 模拟程序！面向对象

Binaries of XOOPIC are available for FTP.  If you don't plan to
modify XOOPIC, check on ftp://langmuir.eecs.berkeley.edu in
/pub/codes/xoopic/xoopic.binaries for a binary.  If you get
a binary you can ignore all the instructions below and use 
the instructions which come with the binary.

XOOPIC has been compiled successfully on the following UNIX systems running
X11R5 or better:

OS		Machine 	compiler	library
-------------------------------------------------------------------------
HP-UX A.09.05	HP 712/80	g++2.7.2	libg++2.7.1
DEC UNIX 3.2	DEC 200/4/233	g++2.7.2	libg++2.7.1
DEC UNIX 3.2	DEC 200/4/233	CXX5.1		vendor supplied
				using DEC CXX 5.1 is not recommended for XOOPIC
DEC UNIX 4.0C	PWS 600AU	g++2.8.0	libg++2.8.0
DEC UNIX 4.0C	PWS 600AU	egcs-1.0.1	egcs libraries
DEC UNIX 4.0C	PWS 600AU	CXX6.0		vendor supplied.
DEC UNIX 4.0D	PWS 600AU	CXX6.0		vendor supplied.
DEC UNIX 4.0D	DEC 8400	CXX6.0		vendor supplied.
SunOS 4.1.x	Sparc 2		g++2.7.2	libg++2.7.1
Solaris 2.5	UltraSPARC	g++2.7.2	
Solaris 2.6	UltraSPARC	Sun CC 4.2	vendor supplied
AIX 3.2		IBM 590		g++2.7.2	libg++2.7.1
AIX 3.2		IBM 590		xlC 1.00 --  had to modify the code,
					and turn off optimization on some
					files.  Furthermore, the compiled
					code was 1/2 as fast as g++.
Solaris 2.4	Sparc 10	Sun c++4.0.1	
				(required a few simple changes)

Linux		PPro		g++2.7.2, g++2.8.0
Linux/Alpha	21164		g++2.7.2, g++2.8.0
FreeBSD		K6		g++2.7.2

****************************************************************************
If possible ENLIST THE AID OF YOUR SYSTEM ADMINISTRATOR FOR COMPILING XOOPIC.

WARNING:  g++ 2.6.1, g++ 2.6.2, and g++ 2.6.3 are BROKEN and WILL NOT 
compile XOOPIC (on most systems).  I don't know about previous versions.

ALSO: g++2.7.2 on Windows NT 4.0 does NOT work.
****************************************************************************

To compile and install XOOPIC, you need the following public domain
software packages which we do not maintain:


* g++			(/pub/GNU/gcc-2.7.2.tar.gz at gatekeeper.dec.com)
* libg++		(/pub/GNU/libg++-2.7.?.tar.gz at gatekeeper.dec.com)

OR DEC CXX instead of g++ and libg++

* libtcl7.4.a (or later)	
* libtk4.0.a  (or later)		
* libXpm.a		
* libXGrafix2.50 (or later)   (http://ptsg.eecs.berkeley.edu)

*************************************************
*** NOTE: Requirement for the XGrafix version ***
*************************************************
Update on Aug. 16, 2005 by H.C. KIM

 To make this version of xoopic work properly, the recent version
of XGrafix (later than Mar. 29, 2005) needs to be installed.
 Otherwise, you may see "core dumped" when restoring from a dump file.
*************************************************

Once you have a c++ compiler, libtcl.a libtk.a libXpm.a, you are ready to
begin:

0)  Get the sources:  ftp ptsg.eecs.berkeley.edu by anonymous FTP and get
    /pub/codes/xoopic-??.tar.gz   or
    /pub/codes/xoopic-??.tar.Z

    Alternately, you may use www:
    http://ptsg.eecs.berkeley.edu

    You may already have these and can omit this step.

1)  Unpack the sources:
    >uncompress xoopic.tar.Z   (Or:  >gunzip xoopic.tar.gz)
    >tar xf xoopic.tar

     You should get a directory named oopic with these files:
	README Makefile physics/ advisor/ xg/ xgrafix/ input/ g++-fixes/ doc/
	configure
	physics/ contains the basic physical models for XOOPIC
	advisor/ contains the input file reader and input sanity checking
	xgrafix/ contains the graphics library used by XOOPIC
	input/ contains sample input files for XOOPIC
	g++-fixes/ contains any fixes you may need to make to g++ to get
		   it to work
	doc/ contains documentation.
	bench/ benchmarks of XOOPIC
	+ other misc. files..

2)  Compile and install XGrafix.
	(XGrafix has its own instructions)
	
3)  Run ./configure

     Once you have a c++ compiler, libXGC250.a, libXpm.a, libtcl*.a, libtk*.a,
     you are ready to start compiling xoopic.  

     To begin, run "configure", which will try to find all the libraries
     and headers needed, and which will accept parameters indicating
     configuration options or library locations.

     In the directory where you have: 
	README Makefile physics/ advisor/ xg/ xgrafix/ input/
     
     ./configure

     Pay attention to the messages configure gives.  If it fails to 
     automatically find something such as libXpm.a, it will prompt
     you to tell it where to find that file.

     configure --help 
     will give you a list of configure options.

     As an example, this command will cause XOOPIC to use the compiler
     'cxx' instead of the default 'g++':

     ./configure --with-CXX=cxx

     If HDF5 library is not installed in your systems,
     you need to give an option of '--disable-hdf5':

     ./configure --disable-hdf5

     Depending on how idiosyncratic your system installation is, you
     might have to give a very complex configure comand such as:

     ./configure --with-CXX=cxx --with-tclsh=/home/tcl/bin 
	--x-includes=/usr/X11/include --x-libraries=/sww/X11/lib
	--with-xpm=/usr/local/Xpm/lib --with-XGRAFIX-lib=/usr/local/tmp

     However, that should only be necessary if your system administrator
     likes to install things in non-standard locations.

     Configure, when successful, should convert Makefile.in in each of
     . advisor/ physics/ and xg/ and convert them to a Makefile.

4)   Run make

     make

     This should go into each of physics/ advisor/, and xg/,
     and create the binary xg/xoopic for you.

     If the compile fails, complaining of missing include files
     or libraries, try editing */Makefile to add the appropriate
     includes or libraries.

     If the link fails with missing symbols, it is likely that 
     the version of tcl/tk that XOOPIC is trying to use is a
     mismatch to the XGrafix library.  XGrafix must be configured
     to use either version 7.4/4.0 of the tcl/tk libraries,
     or configured to use version 7.5/4.1 or higher.  If 
     XGrafix was configured for the wrong tcl/tk libraries,
     then XOOPIC won't link!

     Possible problems:  the compile fails, giving errors involving
     cstring.h.  This is a g++2.7.0 problem.  
     A fix for this is in g++-fixes.

	b) upon starting XOOPIC, xgrafix reports that it can't find 
	a tcl/tk initialization file.

	Solution:  Figure out where the file xgrafix is looking for is,
	and fix xgrafix to find it.  These are some in particular:
	init.tcl 	in the tcl lib directory, (usually /usr/local/lib/tcl)
	init.tk 	in the tk lib directory, (usually /usr/local/lib/tk)
	xgsetup.tcl	in your xgrafix directory

	If the problem is with finding init.tcl, and init.tk, then probably
	these libraries are misinstalled.  If xgsetup.tcl is not found,
	you probably didn't set XGTCL correctly when building xgrafix.
	Double check this and recompile if necessary.

To run,

     xoopic -i input/dring.inp

	or whatever input file is appropriate for you.




Bugs:  email bugreports to [e-mail]