Changes between Version 1 and Version 2 of AthenaDocsSMROutput


Ignore:
Timestamp:
05/30/10 15:18:03 (4 years ago)
Author:
jmstone
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • AthenaDocsSMROutput

    v1 v2  
    22 
    33'''[wiki:WikiStart Wiki]/[wiki:AthenaDocs Documentation]/[wiki:AthenaDocsSMR UserGuide to SMR]/Output''' 
     4 
     5With SMR, most aspects of data output is similar to the single grid version (see the [wiki:AthenaDocsUG User Guide] 
     6for more on outputs in Athena).  For example, all the same output file formats can be used, with each 
     7output type specified through a separate {{{<output>}}} block in the input file. 
     8 
     9However, there are some important differences in outputs with SMR, as noted below: 
     10 
     11== Output directories == 
     12 
     13With SMR, output files at different levels of refinement are written to different directories.  All output associated with 
     14the root (level=0) Domain is written to the current directory (or the directory specified by the {{{-d}}} command line 
     15option).  However, for levels>0, a new subdirectory with name {{{levN}}}, where {{{N}}} is the level number, is created 
     16at run time, and all output associated with Domains at each level is written into the corresponding subdirectories. 
     17 
     18== Output filenames == 
     19 
     20For output from the root (level=0) Domain, the filenames are unchanged from the single grid version.  Thus, output from 
     21the level=0 Domain follows the normal convention 
     22{{{ 
     23basename-id#.dumpid.outid.type 
     24}}} 
     25 
     26For output from all levels>0, the filenames have the level (and possibly the Domain) number included.  
     27For the first (domain number zero) Domain at each level, the filenames become 
     28{{{ 
     29basename-id#-lev#.dumpid.outid.type 
     30}}}  
     31If there is more than one Domain at any given level, the filenames also include the Domain number: 
     32{{{ 
     33basename-id#-lev#-dom#.dumpid.outid.type 
     34}}} 
     35Recall from above that the files from levels>0 will be output to separate directories named by level number. 
     36 
     37With MPI, the directories created by each processor (and named {{{idN}}}, where {{{N}}} is the rank of the 
     38process) takes precedence.  Thus, with SMR and MPI, the {{{idN}}} directories will be created in the current 
     39directory, and each of these will contain {{{levM}}} directories for all the {{{M}}} levels in the 
     40calculation.  Note that these directories are created by all processes, even if that process does not have data 
     41(and therefore will not create output files) on a particular level and/or Domain. 
     42 
     43== History Files == 
     44 
     45With SMR, each Domain outputs a separate history file.  The root Domain writes the file in the current directory, 
     46while all Domains with level>0 write the file in the {{{levN}}} directory.  With MPI, the file is always written in 
     47the {{{levN}}} directory associated with parent (rank=0) process ''for that Domain''. 
     48 
     49The history file for the root Domain contains data which is volume averaged over the whole computational domain. 
     50For all other Domains, the corresponding history files contained data averaged over the volume of that Domain.  This 
     51is useful for keeping track of how much mass, momentum, and energy enters or leaves a refined region of the grid. 
     52However, these quantities in general are not conserved on refined regions. 
     53 
     54== Slicing with SMR == 
     55 
     56When output files are created using the slice operator (see [wiki:AthenaDocsUGSlices Specifying Slices for Outputs]), 
     57then no output will be generated by Domains (or Grids on a given Domain) that do not intersect the volume of the 
     58slice.