
	$Id:$

	R^2mark-1.0
				YAMAUCHI Hitoshi 
				<yamauchi@mpi-sb.mpg.de>
		Copyright (C) 2000 YAMAUCHI Hitoshi 2000-06-29

This is a benchmark suite for comparing C++ and Java environment and
also for your Java environment is suited for a practical program.  For
example, I think this benchmark is also useful for Java GC researcher.

R^2mark is stands for Radiosity and Ray-tracing benchMARK for C++ and
Java. The authors called this program (M\pi)^2, that is Massively
Parallel Image system for Multi-Pass Image synthesis methods. However,
if we use this name, many people may misunderstand with MPI2 (Message
Passing Interface standard version 2). So, we change the benchmark
name as R^2mark. Therefore, program name is still mpi2.

Mpi2 can render images by multi-pass rendering method. Multi-pass
rendering method is the combination of radiosity method and ray
tracing method and it can synthesize photo-realistic images.


Quick Start:

    0. please install mpich-1.1.2 or later. (and use make program as
       GNU make is recommended.)  
	      mpich is in http://www-unix.mcs.anl.gov/mpi/mpich/.

    1. get a source tarball and expand it.
	   tar zxvf R2mark-{version-number}.tar.gz

    2. cd R2mark-{version-number}
	
    3. make
	This `make' runs configure and make recursively with next order.
		1. build C++ version of mpi2.
		2. build mpiJava-1.2.
		3. build Java version of mpi2.

	Some Sun corrupted `test -L' of sh build-in. Then, Please 

		setenv TEST /bin/test
	
	and `make r2mark'.
    
    4. Run the benchmark
       cd benchscript;
	You can see the `parallel' and `serial' directories.
	`parallel' contains parallel version of mpi2 and `serial'
	contains serial version of mpi2. I recommend you may try
	to the serial one first.
	
		1. cd serial;
		   ./run_benchmarks.sh
		
		2. cd parallel
		   ./run_benchmarks.sh

    5. Analyze the log files.
	You will find 

		log.r2mparallel.*
		log.r2mserial.*

	files. This files recorded elapsed time of simulation.
	And sorry for I did not offer useful analysis tools now. 
	You can see the result as typing

		grep elapsed log.r2m* | grep radiosity
		grep elapsed log.r2m* | grep ray-trac

	like this.

	I will offer some useful tools for this benchmark at next
	release. 

Additional information

    I prepared some additional information on my web pages,
    
	http://www.mpi-sb.mpg.de/~hitoshi/research/r2mark/index.shtml.

    Some simulation results are also shown in these pages.

    If you want to use these program for your research, I may offer
    additional information. Please contact to me. Thank you.

