Setting Up a User Defined Colormap

DsTool has a default colormap which it will use if the user does not provide one. To provide a colormap, the user must define it in a file named ``rgb_color.txt''. DsTool will check for this file first in the directory specified by the UNIX environmental variable MY_DSTOOL. If this fails, DsTool tries in the DSTOOL directory, and finally in the current working directory. If the file is not found in any of these places, the default colormap will be used. An example colormap looks like:

        6        
        
        255   0   0  
        0 255   0   
        0   0 255  
        238 130 238  
        255 165   0  
        190 190 190

The first line gives the number of entries. This number must be correct. The next lines give the colors of the colormap, by specifying for each color an RGB triple. That is, each line consists of three integers between 0 and 255, which give the red, green, and blue components of the color. The file must not have any extraneous information such as comments, though it can have extra white space. It is recommended that you use a colormap with at least six entries in it. This will ensure that all bifurcation phenomena that DsTool can detect will use colors different from the system colors. A colormap with less than four entries will not load, and DsTool will use the default colormap.