README

                        PLUTO version 4.4-patch1
                     ------------------------
                 Copyright (C) 2002-2021 Andrea Mignone 

PLUTO is Godunov-type code for astrophysical fluid dynamics supporting several
modules and algorithms. This is the v 4.3 (June 2018) version of the code
(http://plutocode.ph.unito.it).

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.


Main Developer
==============
     
  Andrea Mignone (mignone@to.infn.it), 
 (Dipartimento di Fisica, Turin University)
 (INAF Osservatorio Astronomico di Torino)


Contributors
============
    
  B. Vaidya 
  C. Zanni
  P. Tzeferacos 
  G. Muscianisi
  G. Bodo, T. Matsakos, O. Tesileanu,  

System requirements
=================== 

 - C compiler (gcc works fine),
 - Python (v. 2.0 or higher)

 Optionals

 - MPI (for parallel runs)
 - Chombo lib (for AMR)
 - libpng to produce on-the-fly graphics.
 

Basic Installation and Usage
============================

There's no configure.sh; once you've unpacked the distribution,  

1) define the shell variable PLUTO_DIR as the 
   main PLUTO directory, e.g., 
   if you are using tcsh:

   > setenv PLUTO_DIR "/home/user/PLUTO"

   if you're using bash:

   > export PLUTO_DIR="/Users/ovidiu/PLUTO"


2) select a working dir anywhere on your hard disk;
   at the command prompt, just type 

   > python $PLUTO_DIR/setup.py 

   configure your problem and select makefile;

3) edit your init.c and pluto.ini to assign 
   initial conditions and problem specific information;

4) compile with

   > make 

   or (gmake);

4) run with 

   > ./pluto

See the documentation in Doc/ for more information.
Have fun!