Aw0a: /* BROWSER */

2010-08-04T14:08:43Z

BROWSER

← Older revision		Revision as of 14:08, 4 August 2010
Line 59:		Line 59:
	:[[Image:Browser01.png]]		:[[Image:Browser01.png]]

	We can ask to reset the value for any variable in any set of ~~consitent~~ units or reset any flag in		We can ask to reset the value for any variable in any set of consistent units or reset any flag in
	the model instance. The small lock symbol for this window indicates that one has to release it		the model instance. The small lock symbol for this window indicates that one has to release it
	before ASCEND will allow you to continue - either by hitting OK or cancel.		before ASCEND will allow you to continue - either by hitting OK or cancel.

Jpye at 01:35, 3 August 2010

2010-08-03T01:35:20Z

Show changes

Jpye at 01:32, 3 August 2010

2010-08-03T01:32:20Z

← Older revision		Revision as of 01:32, 3 August 2010
Line 3:		Line 3:


	* ~~<a href="~~#SCRIPT~~" title="">~~ SCRIPT~~</a>~~: for running scripts		* [[#SCRIPT\|SCRIPT]]: for running scripts
	* ~~<a href="~~#LIBRARY~~" title="">~~LIBRARY~~</a>~~: for loading, compiling and displaying model code		* [[#LIBRARY\|LIBRARY]]: for loading, compiling and displaying model code
	* ~~<a href="~~#BROWSER~~" title="">~~ BROWSER~~</a>~~: for browsing the model, resetting values and flags, finding what variables are fixed		* [[#BROWSER\|BROWSER]]: for browsing the model, resetting values and flags, finding what variables are fixed
	* ~~<a href="~~#SOLVER~~" title="">~~ SOLVER~~</a>~~: for solving and for debugging when the model will not converge		* [[#SOLVER\|SOLVER]]: for solving and for debugging when the model will not converge
	* ~~<a href="~~#PROBE~~" title="">~~ PROBE~~</a>~~: for displaying the values of different arbitrarily defined collections of variables		* [[#PROBE\|PROBE]]: for displaying the values of different arbitrarily defined collections of variables
	* ~~<a href="~~#UNITS~~" title="">~~ UNITS~~</a>~~: for selecting the units in which to display variable values (UNITS)		* [[#UNITS\|UNITS]]: for selecting the units in which to display variable values (UNITS)
	* ~~<a href="~~#DISPLAY~~" title="">~~ DISPLAY~~</a>~~: a display service for several of these tool sets		* [[#DISPLAY\|DISPLAY]]: a display service for several of these tool sets

	Each set includes from 10 to 40 different tools to aid in running ASCEND models. Along with		Each set includes from 10 to 40 different tools to aid in running ASCEND models. Along with
	examples for the windows for these tool sets, we also show examples of auxiliary windows that		examples for the windows for these tool sets, we also show examples of auxiliary windows that
	support individual tools. And finally we also show the following screenshots.		support individual tools. And finally we also show the following screenshots.


	* <a href="#Whole_Screen_Shot" title=""> Whole Screen Shot</a>: showing several windows open at the same time		* <a href="#Whole_Screen_Shot" title=""> Whole Screen Shot</a>: showing several windows open at the same time

UploadBot: Restored page from Google Cache, uploaded by John Pye

2010-05-13T13:46:21Z

Restored page from Google Cache, uploaded by John Pye

New page

We show screenshots here for the Tcl/Tk interface, which is the original interface for ASCEND (there now is a newer, but less stable [[PyGTK_Screenshots|Python/PyGTK]] interface under more active development).
Seven tool sets exist, and each has its own display window

* <a href="#SCRIPT" title=""> SCRIPT</a>: for running scripts
* <a href="#LIBRARY" title="">LIBRARY</a>: for loading, compiling and displaying model code
* <a href="#BROWSER" title=""> BROWSER</a>: for browsing the model, resetting values and flags, finding what variables are fixed
* <a href="#SOLVER" title=""> SOLVER</a>: for solving and for debugging when the model will not converge
* <a href="#PROBE" title=""> PROBE</a>: for displaying the values of different arbitrarily defined collections of variables
* <a href="#UNITS" title=""> UNITS</a>: for selecting the units in which to display variable values (UNITS)
* <a href="#DISPLAY" title=""> DISPLAY</a>: a display service for several of these tool sets

Each set includes from 10 to 40 different tools to aid in running ASCEND models. Along with
examples for the windows for these tool sets, we also show examples of auxiliary windows that
support individual tools. And finally we also show the following screenshots.

* <a href="#Whole_Screen_Shot" title=""> Whole Screen Shot</a>: showing several windows open at the same time
* <a href="#PLOTTING" title=""> Plotting</a>: typical plotting using this interface

== SCRIPT ==

ASCEND supports the use of scripts written in Tcl to "run" a model automatically. ASCEND can
capture a script by tracking a session the user carries out manually. Executions of a script is by
highlighting the lines one wishes to execute, as shown here.

<pre> [[Image:Script01.png]]
</pre>

== LIBRARY ==

The Library toolset has over 30 tools, which are for loading or unloading text files containing
ascend model code, for compiling one or more of the models, for displaying the code or the
part/whole structure for the models loaded, for discovering all variable types whose value could be
expressed in a particular set of units (e.g., all variables that could be expressed in the units
ft/s), etc.

<pre> [[Image:Library01.png]]
</pre>

== DISPLAY ==

While in the LIBRARY window, we can ask to DISPLAY the code for one of the loaded models.

<pre> [[Image:DisplayFSCode01.png]]
</pre>

or to DISPLAY the hierarchical "refinement" structure of the loaded models. Note, for example, that
test_controller is a refinement of controller (which means it has all the attributes of a controller
and then some).

<pre> [[Image:ModelHierarchy01.png]]
</pre>

== BROWSER ==

After compiling an instance tc of the test_controller model, we can examine its contents within the
BROWSER. Here we are looking inside tc, where we find a part called fs (of type flowsheet), to peer
inside one of its parts fl1 (of type flash). We can select any variable or flag and reset its
value. From within the BROWSER, we can also run METHODS that can give values to different sets
variables and flags.

<pre> [[Image:Browser01.png]]

</pre>

We can ask to reset the value for any variable in any set of consitent units or reset any flag in
the model instance. The small lock symbol for this window indicates that one has to release it
before ASCEND will allow you to continue - either by hitting OK or cancel.

<pre> [[Image:SetVariableValue01.png]]
</pre>

We can also ask to see all the variables within a given part of the model, or within the whole
model, which we have fixed.

<pre> [[Image:FindByType01.png]]
</pre>

ASCEND allows one to "merge" compatible parts, and we can ask for a list of the different names
(aliases) that result for a part. Here we see that the input called "feed" for the flash fl1 is
also the output called "out" for the reactor r1. Listing aliases gives a nice way to check if a
model is "wired" up as desired.

<pre> [[Image:ListAliases01.png]]
</pre>

== SOLVER ==

After preparing the model for solving by picking which variables we wish to be fixed and providing
values for them, we can export the entire compiled instance from the BROWSER tool set to the SOLVER
tool set. If we have selected either the wrong number of variables to fix (too few or too many) or
based on an analysis of the equations a set that leaves a subset of equations with too few variables
among them, either of two following windows will pop up asking us to select one of the variables on
the list to be fixed or released, as appropriate. These windows will keep reappearing until the
model is square or we cancel the analysis.

<pre> [[Image:EligibleList01.png]]
</pre>

or

<pre> [[Image:OverspecifiedWarning01.png]]
</pre>

After "squaring the model," the solver window appears, and in it we can choose [[Solvers|which solver to use]]
and solve.

<pre> [[Image:Solver01.png]]

</pre>

If all goes well, we will see a window telling us that the model converged, here to three parts in
10 to the eleventh.

<pre> [[Image:SolverStatus01.png]]
</pre>

We can ask numerous questions about the attempt to solve, such as if the model is behaving as it it
is singular, either numerically or structurally, or if some of the variables in it are hitting their
bounds, or if some of the variables are badly scaled. Additionally, we can ask to see the incidence
matrix for the problem, which for small problems is extremely valuable.

<pre> [[Image:IncidenceMatrix01.png]]
</pre>

This matrix is "hot" in that one can select an incidence in it as see to which equation and variable
it belongs. The QRSlv solver solves by partitioning the variables into blocks of equations that
must be solved simultaneously, and one can explore each such block - asking what are the equation
residuals and/or the variable values at this time, for example. Either or both sets may be sent to
the probe, where they can be displayed as a collected set at any time in the future. These tools
are extremely useful while debugging a model.

Each solver in ASCEND has its own set of parameters that the user can set. All are defaulted to
what we have found to be good values. Here we show some of the parameters for our QRSlv solver.

<pre> [[Image:QRSlvParameters01.png]]
</pre>

== PROBE ==

The PROBE is a tool set for managing the display of many different collected sets of variables. One
can ask for all the variables belonging to a part of the model to be sent to the PROBE to be
displayed collectively, or one can send all the fixed variables to the PROBE. One can put pointers
to the models themselves into the PROBE so each can be quickly selected for observation in the
BROWSER. Here we show the collected set of variables from the entire model, tc.

<pre> [[Image:Probe01.png]]
</pre>

== Whole Screen Shot ==

When using this interface, one is likely to have several of the windows open at the same time and to
move among them quickly. Yes, this looks cluttered when several are open, as shown here, but one
does quickly decide where to place the windows and when to hide them. ASCEND can remember placement
and font selections for each window.

<pre> [[Image:WholeScreen02.png]]

</pre>

== Plotting ==

ASCEND uses xgraph for plotting. A tool exists in the BROWSER that allows one to select any part of
a model that is a type that can be plotted and plot it. We show here two sample plots that one
generates when solving a distillation column. The first shows the temperature profile and the
second the relative volatilities for a methanol/water column simulation.

<pre> [[Image:PlotColumnTProfile01.png]]
</pre>
<pre> [[Image:PlotColumnVolatilities01.png]]
</pre>

== UNITS ==

As noted earlier, ASCEND really does know about dimensionality (length/time) and [[units of measurement]] in which that
dimensionality may be expressed (ft/s, m/hr). The UNITS tool allows one to select among using SI, cgs, or 'british' units or to set up whatever unit combinations one wishes for displaying variable values.

<pre> [[Image:Units01.png]]
</pre>

ASCEND has conversions for virtually everything, as seen in part here.

<pre> [[Image:DisplayAllUnitConversions01.png]]
</pre>

[[Category:Documentation]]

TclTk screenshots - Revision history

Aw0a: /* BROWSER */

Jpye at 01:35, 3 August 2010

Jpye at 01:32, 3 August 2010

UploadBot: Restored page from Google Cache, uploaded by John Pye