Previous Up Next

4.7  plot (l)imits

4.7.1   Using plot limits which adapt automatically for each new plot

Adaptive plot limits can be set using option 1 of the l)imits menu (press 'l' from the main menu, then '1'). Different settings can be applied to coordinate axes and non-coordinate axes. Note that changing plot limits interactively and pressing 's' in interactive mode will change this option back to using fixed limits.

4.7.2   Using adaptive plot limits for the colour bar but not for the coordinates

Adaptive plot limits can be set individually for coordinate axes and non-coordinate axes (e.g. the colour bar) via the ``use adaptive/fixed limits'' option in the l)imits submenu. See §??.

4.7.3   Setting plot limits manually

Plot limits can be set manually using option 2) of the l)imits menu (or simply ``l2'' from the main menu). Alternatively you can edit the `splash.limits' file created by a S)ave from the main menu prior to invoking splash (this file simply contains the minimum and maximum limits for each column on consecutive lines).

4.7.4   Making plot limits relative to a particular particle

Particle tracking limits (i.e., where a chosen particle is always at the centre of the plot and limits are set relative to that position) can be set via the ``make xy limits relative to particle'' option in the l)imits menu. Alternatively particle tracking limits can be set interactively by pressing 't' in interactive mode with the cursor over the particle you wish to track. Note that this option only works if particle identities are preserved between timesteps. Also note that, with particle tracking limits set, the radius calculated via the ``calculate extra quantities'' option in the d)ata submenu is calculated relative to the tracked particle.

Centreing on a sink particle can also be achieved using the SPLASH_CENTRE_ON_SINK environment variable.

4.7.5   Plotting in a comoving reference frame

A co-moving reference frame can be set using the ``make xy limits relative to particle'' option in the l)imits menu. Coordinate limits are then centred on the selected particle for all timesteps, with offsets as input by the user. This effectively gives the `Lagrangian' perspective. See §?? for more details. Centreing on a sink particle can also be achieved using the SPLASH_CENTRE_ON_SINK environment variable.

4.7.6   Setting the origin to correspond to a particular particle

See §??.

4.7.7   Tracking a particle

See §??.

4.7.8   Setting the origin to the position of the $n$th sink particle

This can be achieved using the ``make xy limits relative to particle'' option in the l)imits menu. For example, to track the first sink particle we would proceed as follows:

Please enter your selection now (y axis or option):l3
------------------ limits options ---------------------
To track particle 4923, enter 4923
To track the 43rd particle of type 3, enter 3:43

Enter particle to track: (default="0"): 3:1

where 3:1 indicates the first particle of type 3. The origin is set to the position of this particle and limits are relative to its position. See §?? for more details.

4.7.9   Plotting radial plots around sink particles

First, set the origin to the location of the sink, as described above. Then simply change to spherical coordinates using the ``change coordinate systems'' option in the o) menu. Alternatively, compute the radius using the ``calculate extra quantities'' option in the d)ata menu.

4.7.10   Automatically adapting plot limits to match aspect ratio of output device

An option to automatically adjust the plot limits to match the aspect ratio of the output device is given in the l)imits menu, and is also prompted for whenever the paper size is changed (via the ``change paper size'' option in the p)age menu, see §??).

4.7.11   Plotting with log axes.

Log axes can be set either interactively (by pressing 'l' with the cursor over the desired axis) or manually via the ``apply log or inverse transformations to columns'' option in the l)imits menu. To use logarithmic axes labels as well, see §??.

4.7.12   Plotting the square root, inverse or square of a quantity

Columns can be logged, inverted, sqrt-ed, squared or any combination of the above via the ``apply log or inverse transformations to columns'' option in the l)imits menu. If you have any additional transformations you would find useful please let me know, as it is straightforward to add more.

4.7.13   Resetting limits for all columns

Limits for all columns can be reset to their minimum and maximum values from the current dump file via the ``reset limits for all columns'' option in the l)imits menu. See §?? for details of resetting plot limits for a particular plot in interactive mode.

4.7.14   Restoring all plot limits to their minimum and maximum values in the current dump file

See §??.

4.7.15   Using a subset of data restricted by parameter range

As of version 1.11.0, it is possible to use only a subset of the particles in both particle plots and rendered plots, according to restrictions on any or all of the data columns (for example, using only particles with $ρ> 10$, in the 3D box $x,y,z ∈[-0.1, 0.1]$). Whilst this has always been possible by selecting, colouring and/or hiding particles in interactive mode (see §??), the difference here is that the selection is based, for each timestep, strictly on the parameter range, rather than being a selection based on particle identity. This means that the parameter range is also saved to the splash.limits (i.e., by pressing `S' from the main menu) and is shown when splash launches via lines such as:

>> current range restrictions set: 

 (  1.693E-01 < x <  1.820E-01 )
 (  2.205E-01 < y <  2.265E-01 )
 (  7.580E-06 < density <  2.989E-05 )

>> only particles within this range will be plotted 
   and/or used in interpolation routines

or more usually:

>> no current parameter range restrictions set 

Parameter range restrictions can be set either manually via the l)imits menu (option 7) or interactively by selecting a region in the plot and pressing `x', `y' or `r' to restrict using the $x$, $y$ or both $x$ and $y$ limits of the selected area respectively (pressing `R' instead removes all currently set restrictions). Another way of setting manual range restrictions is simply to edit the splash.limits file directly (this simply contains the min and max limits for each column, followed optionally by a third and fourth column specifying, respectively, the min and max of the range restriction).

4.7.16   Plotting only particles with $ρ> 10$, $u > 20$ and $-0.25 < x < 0.25$

Plotting a subset of the particles restricted by a parameter can be achieved by setting a parameter range restriction (which does not change between timesteps -- see §??), or alternatively by an interactive selection based on particle identity (see §??).

SPLASH: A visualisation tool for SPH data ©2004–2014Daniel Price.
Previous Up Next