Changes between Version 17 and Version 18 of AccretionDiskTutorial


Ignore:
Timestamp:
08/28/12 13:34:33 (12 years ago)
Author:
idilernia
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • AccretionDiskTutorial

    v17 v18  
    11= Setting up an accretion disk simulation in Astrobear 2.0 =
    22
    3 === Modules and Files ===
     3This tutorial is designed to teach you the essential knowledge needed to set up a Disk module in AstroBEAR 2.0
     4[[BR]]
     5
     6== Modules and Files ==
    47
    58These directions assume that you are able to compile a problem, in case you have never compiled AstroBEAR check the page [https://clover.pas.rochester.edu/trac/astrobear/wiki/BuildingAstroBear How to Build AstroBEAR 2.0] [[BR]]
     
    1518'''Warning: ''' It is good practice to delete ''profile.data'' from the problem folder before executing AstroBEAR for the first time, failure to do so will likely result in execution errors.
    1619
    17 === Getting familiar with the module ===
     20== Getting familiar with the module ==
    1821
    1922After checking that the disk module compiles and runs without any issues, you can examine the chombo files created by the first run of this module.[[BR]][[BR]]
     
    3033- PointGravity: a point mass located at the center of the disk
    3134
     35'''Note''': Numerical values reported by Visit are in computational units, ''scales.data'' contains the scales values needed to translate computational units to physical units.
    3236
    33 === Initial Conditions ===
     37== Initial Conditions ==
    3438
    3539Now you can proceed to examine ''problem.data'' contained in the '''BasicDisk''' folder.
    36 The default problem.data file contains an array of field that can be changed depending on the user's needs, let's analyze some of them
     40The default problem.data file contains a list of initial conditions that can be changed depending on the user's needs, let's analyze some of them
    3741
    3842|| ddensity=1d0       || disk density ||
     
    4347|| height=5e9         ||disk height||
    4448|| mass=.6d-1         ||central particle mass||
     49
     50'''Note:''' for this specific module, problem.data no scaling operation is required from the user
    4551
    4652Sometimes it can be useful to change the size of the physical boundaries of the simulation, this can be done by modifying the section below contained in ''global.data''
     
    5460}}}
    5561
    56 === Scales ===
     62== Scales ==
    5763
    58 Scales are parameters that can actively affect the outcome of a simulation. [[BR]]
     64AstroBEAR makes use of scales to adapt physical values to a numerical simulation, scales can affect the behavior of a model [[BR]]
    5965Physics.data contains a section dedicated to the setting of scales:
    6066
     
    6874}}}
    6975
    70 It is good practice to adapt the scales to the specific needs of a simulation, let's see an example:[[BR]]
    71 In the code listed in the Initial Conditions section we set the disk radius to be 2e10cm, with that, we set our length scale parameter (lScale) to be .5e10cm[[BR]]
    72 this will result in R,,disk,,/lScale = 4.
     76In the values listed above the disk radius is set to 2e10cm, with that, we set our length scale parameter (lScale) to be .5e10cm[[BR]]
     77the resulting ratio R,,disk,,/lScale is 4.[[BR]]
     78For convenience purposes, a rule of thumb is to keep the R,,disk,,/lScale within about one order of magnitude from the value above:[[BR]]
     79for example, if we had 2e15 as R,,disk,, a good lScale would be .5e15 or 1e15.
    7380
    74 '''Warning:''' Always make sure to check ''physics.data'' for the entries
     81'''Warning:''' Always make sure to check ''physics.data'' for
    7582{{{
    7683MinTemp         =       1e-3,      ! minimum allowed temperature for the system, without cooling, this should be zero.
     
    8087
    8188
    82 === Softening ===
     89== Softening ==
    8390
    8491Softening is a numerical trick commonly used in simulations to prevent divergences when a value comes close to another and the force of gravity goes to infinity.[[BR]]
     
    104111'''Warning: ''' It is good practice to keep the soft_radius between .1 and .3. Failure to do so may result in undesired outcomes.
    105112
    106 === Fixed grid to AMR ===
     113== AMR ==
    107114
    108115The resolution of the simulation can be changed by modifying the following fields contained in [https://clover.pas.rochester.edu/trac/astrobear/wiki/GlobalDataExplained global.data]:
     
    148155[[BR]]
    149156
    150 === Mach Number ===
     157== Mach Number ==
    151158
    152159When setting up a new simulation it is good practice to check that the Mach values are below a certain threshold, in most of computational simulation this value is ~60. [[BR]] Values above this threshold may create difficulties in evolving a model and therefore create computational errors.
     
    156163[[Image(mach.png, 500px)]]
    157164
    158 === Other parameters  ===
     165== Other parameters  ==
    159166
    160167Now that you have acquired the essential knowledge to set up a disk module, you should be capable to change other aspects of a simulation such as:[[BR]]