Installing a New Model

Before attempting to install a new model, be sure that you have created you own Pisces work directory. In the steps below, we assume that you have a UNIX shell whose current working directory is your Pisces work directory. For example,
% cd $HOME/pisces/work

We will illustrate the procedure of installing a new model by using a concrete example. Suppose that you are interested in studying the level sets of the planar variety defined by the zero set of the function
x^3 - xy + alpha + beta y

To install this function into Pisces:

Create a template file
Copy a preexisting model file or download and save Pisces' model template file.
For example: save the template file as template_def.c
Edit the template file
This step involves typing in the equation for the function whose level sets are of interest, and completing a series of "administrative tasks" such as naming your variables and parameters, and giving default interval ranges for each variable and parameter.
For example:
Add your model to the Pisces model menu
Edit the file model_config.c to add a line of the form
DEFINE_MODEL( Template, "My First Model", "2D");
The first entry is the name of the model that you indicated in the MODEL_NAME macro of the template file. The second entry is a string that will appear on the Pisces menu of installed models. The third string determines a model "subclass." Subclasses are not yet implemented.
Add the name of your template file to the Makefile
Edit the file Makefile and add the line
SRCS= model_config.c template_def.c
after the initial set of comment lines.
Compile and link your code with the standard Pisces libraries
This only requires that you type make pisces, and then subsequently invoke the executable ./pisces whenever you want to use the model that you installed.

Next: Installing a New Derived Model
Previous: Advanced Users Guide
[Pisces] The Pisces Home Page
Comments to:
Last modified: Wed Nov 22 11:30:41 1995
Copyright © 1995 by The Geometry Center, all rights reserved.