Up to Pisces Online Documentation

Permutation Panel

(For Controlling XYZ Graphics Output Order of Variables)

Overview

The Pisces Model Panel lists the Domain, Parameters, and Range variables and has a Permute button to pop-up a Permute Panel.

The "old" permute panel has radio buttons to toggle the variables between the domain and parameters lists. However, the variables always stay in the same order with respect to each other and there is no mechanism to map a specific variable to a specific (x,y,z) coordinate.

The "new" Permute Panel is called the "XYZ Output Coordinates" Panel and currently will support output for 2 and 3 Dimensions. Instead of radio buttons, a menulabel interface is implemented. The settings from this panel affect the permutation which is reflected in the model panel.

How it works

The xyzpanel uses pull-down menus to select the output dimension and to select the variable to be mapped to one of (x,y,z). The xyxpanel uses text entry widgtes to change the current value of a selected variable.

Behind the scenes, the algorithm uses a global matrix implemented in the tcl script. This matrix _P(_row,_col) has two dimensions: _row and _col

_row = {list of domain and parameter variables}
_col = {const, x, y, z}
_P = 1 or 0 only

When the panel is launched the matrix _P is updated to reflect the current permutation. Consider the following matrix

   const    x  y  z
  
   i  1     0  0  0
   j  0     0  1  0
   k  0     1  0  0
   l  0     0  0  1

  _P(i,const) = 1 means that variable "i" is a constant
  _P(j,y)     = 1 means that variable "j" is mapped to the "y" coordinate
  _P(k,x)     = 1 means that variable "k" is mapped to the "x coordinate
  _P(l,z)     = 1 means that variable "l" is mapped to the "z" coordinate

note that in a given row only one of the elements can be 1 and all other 0
also that in a given col only one of the elements can be 1 and all other 0

The pull-down menus are used to set and unset the matrix _P. Each menu contains a list of all the _row elements. There are at most 3 menulabels corresponding to the x y z mappings. There is no menulabel for const since this is the default setting when a variable is not mapped to x,y,z.

The current state of the matrix _P is reflected by the menu labels which show the selected variables for each of (x,y,z).

Controlling the XYZ Panel From Pisces

In order to use the XYZ panel, do the following:

start up pisces
select a Model
select "Settings" from the main menu and select "Model"
press the "Permute" button in the Model (function) panel
the XYZ panel pops-up
select the Dimension by clicking on the menulabel and selecting 2 or 3
select the variable for each output coordinate
if required, set the current Value using the text entry widget associated with each variable
press the "Update" button
the new permutation is applied to the Model panel.

Known Bugs

The XYZ panel currently works for 2 or 3 dimensions. The logic should be generalized for higher dimensions.

Bug Reports

software@geom.umn.edu

Implemented By

Nicolas Vera

Acknowlegdements

Thanks to Mark Philips for his help with the Tcl/Tk work.

The Pisces Home Page

The Geometry Center Home Page

Comments to: pisces@geom.umn.edu
Created on June 7, 1995 by Nicolas Vera
Converted to html on July 28, 1995 by Erik Streed
Last Modified: July 28, 1995
Copyright © 1995 by The Geometry Center, all rights reserved.