next up previous contents
Next: Example Up: The Graphics Program PLAUT04. Previous: Changing the background picture   Contents

Setting up the resource file

The PLAUT04 resource file sets default values for almost all controls of PLAUT04. PLAUT04 allows us to write our own resources files and put them in the same directory as the AUTO data files. PLAUT04 first looks for the resource file in the current directory. If it cannot find a resource file there, then it will try to use the one installed in the AUTO root directory. If both these searches fail, then the internal default values will be used.

In order to write a usable resource file, one should follow the following rules:

  1. Comment lines start with ``#''. Comments may take as many lines as desired.
  2. Between the ``variable name'' and the default value, we must use ``='' to tell the system that the left side is the ``variable name'', and the right side is its corresponding default value.
  3. If a ``variable'' has aggregate values, a comma ``,'' must be used between two values.
  4. The line type is set using 4-digit hexadecimals, starting with ``0x''. Its values can range from 0 (invisible) to ``0xffff'' (solid). The system default is ``0xffff'' for stable solutions, and ``0x3333'' for unstable ones. The line pattern is determined by the number of $ 1$s and 0s when the hexadecimal is converted to a $ 16$-bit binary. A ``$ 1$'' indicates that the drawing occurs, and ``0'' that it does not, on a pixel by pixel basis. For example, the pattern ``0xAAAA'', in binary is $ 0000100010001000$, and PLAUT04 interprets this as drawing 3 bits off, 1 bit on, 3 bits off, 1 bit on, 3 bits off, 1 bit on and finally 4 bits off. The pattern is read backward because the low order bits are used first.
  5. Some variables can only be set to ``Yes'' or ``No''. They cannot be assigned other values.
  6. No ``variable name'' should be modified.

It is strongly recommended that the default resource file is used as a template when writing a custom resource file.

Below is a copy of the default resource file.

#version 0.0

# Line colors are represented by RGB values from 0 to 1.0.
# DEFAULT color is also used when animationLabel == 0, i.e.,
# when showing all solutions and animating the solution change.
# Point Type    RED  GREEN  BLUE PATTERN
DEFAULT       = 1.0,  1.0,  1.0, 0xffff
BP            = 1.0,  0.0,  0.0, 0xffff
LP ALG        = 0.0,  1.0,  0.0, 0xffff
HB            = 0.0,  0.0,  1.0, 0xffff
UZ4           = 1.0,  1.0,  0.0, 0xffff
UZ-4          = 0.5,  0.5,  0.0, 0xffff
LP DIF        = 0.0,  0.0,  0.5, 0xffff
BP DIF        = 0.0,  0.5,  0.5, 0xffff
PD            = 1.0,  0.0,  1.0, 0xffff
TR            = 0.0,  1.0,  1.0, 0xffff
EP            = 0.3,  0.0,  0.3, 0xffff
MX            = 0.6,  0.0,  0.6, 0xffff
OTHERS        = 1.0,  1.0,  1.0, 0xffff

# Initialize the line pattern for showing stability
UNSTABLE LINE PATTERN = 0xffff 
STABLE LINE PATTERN   = 0xffff

# Initialize the default options:
Draw Reference Plane  = No
Orbit Animation       = No
Satellite Animation   = No 
Draw Primaries        = No 
Draw Libration Points = No 
Normalize Data        = Yes 
Draw Background       = No

# Initialize the default coordinate axes:
#  0 --- None,
#  1 --- at origin
#  2 --- at left and behind
#  3 --- at left and ahead
Coordinate Type = 3

# Draw Scale on the Aexs
Draw Scale = Yes 

#  Initialize the default graph type:
#  0 --- Solution (fort.8)
#  1 --- Bifurcation (fort.7)
Graph Type    = 0

# Initialize the default graph style:
#  0 --- LINES,
#  1 --- TUBES,
#  2 --- SURFACE
Graph Style  =  0

# Set the window width and height:
Window Width        = 1000
Window Height       = 1000 

# Set X, Y, Z axes for the solution diagram:
# 0 is Time for X,Y,Z.
X Axis Solution             = 1
Y Axis Solution             = 2
Z Axis Solution             = 3

# Set X, Y, Z axes for the bifurcation diagram:
X Axis Bifurcation          = 4
Y Axis Bifurcation          = 5
Z Axis Bifurcation          = 6

#Labeled solutions:
Labels              = 0

# Set coloring method:
# -5 --- STABILITY
# -4 --- POINT
# -3 --- BRANCH
# -2 --- TYPE
# -1 --- LABEL
# Otherwise, according to the data in the ith column of the solution file.
# It can only be set to an integer value.
Coloring Method           = -2
Number of Period Animated = 1

# Line Width Scaler adjusts the thickness of curves:
Line Width Scaler         = 1.0

# The AniLine Thickness Scaler sets the thickness of animated solution curves:
AniLine Thickness Scaler  = 3.0

# Background color:
Background Color  = 0.0,  0.0,   0.0

# Background transparency:
Background Transparency = 0.0 

# Disk transparency
# IF you turn Disk From File to "Yes", you should change the transparency there.
Disk Transparency = 0.7 

# Read Disk From File
Disk From File = No 

# Axes color:
X Axis Color    = 1.0,  0.0,   0.0
Y Axis Color    = 0.0,  1.0,   0.0
Z Axis Color    = 0.0,  0.0,   1.0

# Color of the satellite, large primary, and small primary in animation:
satellite Color             = 1.0,  0.0,   0.0
large primary Color         = 0.0,  1.0,   0.0
large primary tail Color    = 0.0,  1.0,   1.0
small primary Color         = 0.0,  0.0,   1.0
small primary tail Color    = 0.5,  0.5,   0.0

# Stable solution color:
Stable Solution Color = 0.0, 0.0, 1.0

# Stable solution color:
Unstable Solution Color = 1.0, 0.0, 0.0

# Set the radius of the satellite, large primary, and small primary:
# The normal size is 1.0.
# For smaller radius, use 0.xxx
# For bigger radius, use  X.XXX
Satellite Radius        = 1.0
Large Primary Radius    = 1.0
Small Primary Radius    = 1.0
Libration Point Size    = 1.0

# Set the maximum and minimum satellite animation speed:
Sat Max Animation Speed = 100
Sat Min Animation Speed = 0

# Set the maximum and minimum orbit-change animation speed:
Orbit Max Animation Speed = 100
Orbit Min Animation Speed = 0

# Set the active AUTO parameter indices:
parameter ID = 10

# Choose 3D or 2D graph:
3D  = Yes


next up previous contents
Next: Example Up: The Graphics Program PLAUT04. Previous: Changing the background picture   Contents
Gabriel Lord 2007-11-19