SCEPTIC3D: Specialized Coordinate Electrostatic Particle and Thermals In Cell 3D This package contains: 1) the SCEPTIC3D code (main folder) 2) a library of graphic functions (accis) 3) matlab postprocessing tools (Matlabtools) Optional functionality available in separate archives: 1) a subfolder required for HDF5 output (hdf5-1.8.4) Building SCEPTIC3D on a linux system _______________________________________________________________________ `make sceptic3D` builds the serial version with ASCII output. Note that this requires the development versions of the Xt and X11 libraries. `make sceptic3Dmpi` builds the parallel version with ASCII output. Note that this also requires an MPI implementation (tested with MPICH2). `make sceptic3Dhdf` builds the serial version with HDF output. Note that this also requires the folder hdf5-1.8.4 to be in the sceptic3Dprod directory. `make sceptic3Dmpihdf` builds the parallel version with HDF output. Running SCEPTIC3D _______________________________________________________________________ `./sceptic3D` gives a usage message listing the available flags. Example: `mpirun -n 8 ./sceptic3Dmpi -l1 -t0.1 -v0.5 -x20 -s1000 -nr100 -nt30 -np30 --bz1.25 -f -g --sp` This example runs the mpi version of SCEPTIC3D with L_De=1, T_i=0.1, v_d=0.5, r_b=20, nsteps=1000, n_r=100, n_theta=30, n_psi=30, B_z=1.25, without graphical output, and using the parallel Poisson solver. A detailed explanation of the normalizations is given in the references listed in the header of the file sceptic3D.F. Reading SCEPTIC3D .dat files using Matlab _____________________________________________________________________ The folder Matlabtools contains several Matlab routines that read and process the SCEPTIC3D ASCII output file. See the file README.pdf in that folder for details. ACCIS _____ The subdirectory accis contains a graphics library used by SCEPTIC3D (copyright Ian Hutchinson). It will compile automatically, but both codes depend on having the X11 libraries in the usual places. A guide for the accis routines is in accis/accissum.tex. In general, when the graphics plotting completes, and the program pauses, left click the mouse in the graphics window to continue.