Wizard Manual
Wizard Manual
Wizard Manual
product ecology
consultants
SimaPro 7
Wizard Manual
Introduction into
programming of Wizards in SimaPro 7
March 2006
Colophon
1 Introduction
1.1 Introduction to wizards
Since 1998, PRé Consultants has developed an alternative way of presenting the LCA
results using wizards. Wizards present themselves as a series of questions to the user.
Wizards are usually focused on a specific product. In practice this means Wizards are
used for groups of users that have to deal with a similar topic or problem. There are
three main applications for wizards:
1. LCA by non-LCA experts. Wizards can be used to develop an easy user interface for
people with no, or limited knowledge of LCA methodology. The questions can focus
on the functional unit and some basic assumptions. By answering the questions, the
user can perform its own LCA, without actually having to understand all the details of
LCA methodology, or how SimaPro works (see Figure 1).
2. Publishing an LCA. Wizards can be used to show the results of your LCA study to
interested parties. Wizards can replace a static LCA report, and give the audience an
interactive view of your LCA. The presentation of the results is transparent and you
can even allow users to perform their own sensitivity analysis and make comparisons
from several alternatives. The Guided Tour you see when you start the demo provides
an example of such a use of wizards. Although the user only sees the questions and
the results of the LCA, underneath the wizard the full SimaPro database and all the
intermediate results are available for further inspection; the results are thus
completely transparent.
3. Wizard for LCA. Wizards can be used to create a wizard for LCA modeling that is
repetitive. Wizards can help to decrease the difficulties in life cycle modeling.
Especially with multiple users working a large LCA project, wizards can guarantee
that the same methodology for life cycle modeling is followed by all SimaPro users.
An example of a wizard to decrease the difficulties in LCA modeling is the LCA wizard
in the standard database of SimaPro.
Figure 1 The LCA expert can develop an interface between the non-expert user and the tool.
The expert is responsible for developing the interface and the database in such a
way that the results are methodologically correct. The user is responsible for
submitting correct data on the product composition and the life cycle.
LCA experts who have a thorough understanding of SimaPro can develop wizards. The LCA
expert can assume the responsibility that the Wizard results in a methodologically correct
LCA, while the user can take the responsibility that the product and life cycle are
properly defined. Any user of a SimaPro {Developer, right!?} or Multi-user version can
program wizards.
1
SimaPro 7 Wizard Manual
Wizards are built using several building blocks, called nodes. Chapter 2 starts with an
overview these building blocks, followed by a more detailed explanation of their use and
function. In wizards, variables are used to store the information created by the wizard.
Section 2.2 gives an overview of the all variables available for wizard writing, and in
section 2.3 the relation between variables and nodes is explained. Section 2.4,
Programming wizards, gives an introduction in wizard programming: linking nodes in a
smart way. Chapter 3 shows a variety of wizard examples and gives the possibility to
practice wizard making on your own.
Before wizards writing is explained in chapters 2 & 3, section 1.3 provides information
important to know before you start writing wizards.
We advise you to take a look at the LCA wizard in the SimaPro standard database, to see
some of the explanations in this manual ‘live’ in SimaPro.
Wizard are usually combined with a specific datasheet, so often you can only start
programming the wizards if you have at least a rough version of the data and impact
assessment methods ready.
2
SimaPro 7 Wizard Manual
Wizard
Wizard
A B C
You can either store a wizard in a library or in a project. Libraries cannot refer to other
libraries; therefore a wizard in a library can only call data from within that same library.
Therefore, in cases where your wizard will use data from several libraries, you need to
place the wizard in a project. A wizard stored in a normal project can use data from
within the project and from all libraries available (see also Figure 2 A and B).
In case you make a wizard for demonstration purposes (i.e. a wizard that does not
produce or edit any data), it is possible to let wizards jump from within a project to a
wizard in another project or library (Figure 2 C).
The items created by a wizard in a library are stored in the project that was open before
the user started executing the wizard, and/or in projects opened while running the
wizard.
After presenting the first version of the wizard, there will probably be a reason to
provide updates. Sending a new version of the libraries and the wizards to the users can
do this. Users who want to maintain the data generated with the previous version can
import this data from their old database into their new database.
3
SimaPro 7 Wizard Manual
Overview of
wizards in all
libraries and in
the current
opened project
4
SimaPro 7 Wizard Manual
Figure 4 SimaPro users can find available wizards in the LCA Explorer index, under ‘Wizards’
Figure 5 Partial view of window creating a new wizard. Under ‘Options’ there is the
possibility to make the wizard ‘Executable’. Only executable wizards are visible in
the LCA Explorer index, under ‘Wizards’.
Only for executable wizards is the text field under ‘Comment’ visible to the user. In non-
executable wizards, you can use this field to make notes useful to yourself as the wizard
designer, such as a description of the content of the wizard.
5
SimaPro 7 Wizard Manual
Message node
Displays a text message to the user.
The choose node is the most abstract data entry node, since wizards allow for any kind of
choices.
Calculate node
Calculates the results of one or more processes or product stages
with an impact assessment method.
6
SimaPro 7 Wizard Manual
Operations node
This is one of the most complex and advanced nodes. Here you can
create new processes and product stages. It allows you to include
arithmetic operations within the wizard. For example, you ask the
user for the height and width, and you let the operation node
calculate the surface.
Result nodes
These nodes display results to the user.
In the next sections, the nodes are explained in more detail. Some ‘fields’ appear in
several nodes, therefore we will explain these first in Figure 6, using the window of an
‘Enter values node’ as an example.
7
SimaPro 7 Wizard Manual
In the description field you define the name of the node. The wizard user will not see it,
but you will need it to be able to find which node does what.
The text field can contain flat text and string (%s) or value parameters (%d). Use the
String parameter button to link this parameter to a string or value variable (see section
2.3.2).
Figure 7 Window of a message node. The text in the white field under ‘Text’ is displayed to
the user of a wizard
8
SimaPro 7 Wizard Manual
The variable field displays the variable. The text (string) typed by the
user is assigned to this variable. You can use the ‘Select’ button to
select one of the existing variables or create a new one. The variable of
an enter name node is always a text variable (see section 2.3)
Figure 8 Window of an Enter name node. The text in the red lines is displayed to the wizard
user.
9
SimaPro 7 Wizard Manual
The label is a short text that appears The value variable to which the input is
just before the area in which the user assigned. Double click in this field to
can type the value. This helps to select an existing variable or create a
identify what data should be entered. new one.
Figure 9 Window of en Enter values node. The areas within the red blocks are visible for the
wizard user
You can specify up to six fields in one ‘enter values’ node where the user can enter data.
The quantities of these fields do not need to be the same in one node.
10
SimaPro 7 Wizard Manual
Example: Suppose you would like to let the user select the most appropriate transport
process. List in this node the most relevant data on truck and rail transport. The user can
select from this list and add the transport amount in an ‘enter values’ node.
Use the ‘Add’ button to select the relevant processes or product stages, from which you
would like to let the user make a choice. If you choose to select a ‘category’, the wizard
will show all processes or product stages in this category; otherwise, you can select
individual processes or product stages.
If the wizard you are building is stored in a library, you will only be able to select
processes that are in this library. If your wizard is built in a project, you can select any
process or product stage in this project and in all libraries that are linked to your
project. This limitation is needed to avoid cross-references between libraries (see also
section 1.3.2 Where to place a wizard).
You cannot specify an amount or unit in this ‘select process/product stage’ node, as the
unit of the process or product stage will be used. You collect information on the amount
via an enter values or from an operations node.
11
SimaPro 7 Wizard Manual
Under ‘Choices’ you can type one line to describe each choice.
The choose node will only generate a number of alternative branches, without specifying
what each branch will do. To define what will happen when a choice is made, close the
Choose wizard node editor. You will see that a number of dummy branches have been
created in the Wizard overview screen.
Double click on these branches and choose the next node that is to be executed when the
user makes a choice. For each choice you have to define at least one node. If you do not
fill in the choices, you will not be able to run the wizard, and an error will appear.
Suppose you want to end a choice and branch immediately to another wizard (see section
2.4.2 Wizard structure). In that case, you can add an operation node. This operation node
can be left empty and will not perform any task.
Due to a programming limitation you cannot change the first type of node belonging to a
choice. The workaround is simple: define a new choice and link this choice to the node
you want to have executed and delete the old choice. However, if you delete a choice,
all the following nodes of that branch will be deleted as well. Nodes cannot be moved or
copied! To make the wizard development flexible, you can use call wizard after a choice
(see sections 2.1.8 and 2.4.2).
12
SimaPro 7 Wizard Manual
In this node you specify which wizard is to be started. With the ‘Select’ button, you can
choose to call a wizard in the current project or libraries. A wizard can also call itself!
See section ‘2.4.2 Wizard structure’ to learn how you can use this node to design a
looping wizard structure.
The calculation node is defined by selecting one or more process or product stage, or
process or product stage references, and by selecting an impact assessment method and
the result variable that is to be assigned to the result. If you only select one process or
product stage variable, the calculation will run in analyze mode, if you select multiple
items, it will automatically switch to compare mode.
13
SimaPro 7 Wizard Manual
2.1.10Operations node
The operations node can be considered the core of the wizard. The operations node
allows you to perform arithmetic operations with variables, and to store the results of
these operations in other variables. You can also create new process stages and processes
(with some limitations). This node is by far the most complex and comprehensive node.
You need to understand the concept of variables before you attempt to define operations
(see sections 2.2 and 2.3).
The operations node runs in the background: the user will not directly see this node.
The core of the Operations node is a table, in which you specify the wizard operations in
the following way:
Type of ‘thing’
14
SimaPro 7 Wizard Manual
Figure 15 illustrates the meaning of this cryptic explanation. Under ‘Destination’ you
specify a variable where the wizard stores the result of the action of that line. Under
source 1 you specify the ‘thing’ that is the subject of the action, and under ‘Operation’
you specify ‘something that the wizard will do with that thing.’
The source type always accompanies the sources. This is the type of variable that is used
as a source.
You should use ‘Assign’ when you want your destination (‘it’) to become source 1
(‘thing’). Assign is used to give product stages and processes their name, quantity and
value. ‘Link’ is used to attach variables (like process references etc.). For example, a
product stage life cycle links to a product stage assembly.
There are a few other fields in operations that become available depending on the
operation you enter. These fields are ‘Unit’ and ‘Id’.
Unit
If the destination variable is the result of the calculation of two source variables, the
result will be expressed in the standard unit. If you want to express the result in a
different unit, double click this field to open the Select a unit dialog Product stage (see
Unit field (Select a value) ). You must check if the result can be expressed in the unit you
select. An error message is displayed if a unit is selected for a different quantity from
that of the result of the calculation.
Id
If the destination variable is a Product stage or Process and the source type is numeric
(Value, Integer or Real), the Id determines to which part of the Product stage or process
the data in the source variable are assigned. The source variable can contain a numeric
value and a unit.
15
SimaPro 7 Wizard Manual
Figure 16 Example of an operation to create a thermos jug assembly with links to processes in
the database. In this example Id>0 is used to link values to processes in the assembly
With other destination variable types (Product stage-ref, Pc-ref and Value), the data in
the source variable are always assigned to the Value and Unit properties of the
destination variable. In other words, although the Id field is disabled, it is automatically
given a value of 0.
The Insert button is used to add a new destination variable. Clicking this button, or
double-clicking the space beneath an entry, will open the Select a variable dialog.
See section ‘3.1 Examples and Practice’ for examples of how to use the operation node.
16
SimaPro 7 Wizard Manual
You define the graph node by specifying which result variable must be presented, and
how this must be done. How refers both the definition of options available to the user,
and the way the graph is displayed initially.
You can specify which levels of aggregation should be available to the user. For example,
you may want to prevent the user from using weighting. You can also specify the initial
level of aggregation. For example, you can specify characterization as the initial level.
The user will see that the characterization level is shown first. If you have permitted the
user, he or she may choose to use one of the other aggregation levels.
Under relative mode you specify how results can be displayed in a table presentation of
the graph. The following options are available:
• Non refers to displaying a normal table.
• Horizontal refers to a table that shows the relative contribution to an LCIA result
over multiple columns.
• Vertical refers to a table that shows the relative contribution as percentages per
column.
• All refers to a table that shows the relative contribution in percentages over the
whole matrix. This means only one cell in all rows and columns gets a 100% score; the
rest are relative to this one cell.
17
SimaPro 7 Wizard Manual
You define the Show LCI results node by specifying which result variable must be
presented, and how this must be done. How refers both the definition of options
available to the user, and the way the table is displayed initially.
You can specify which levels of aggregation should be available to the user in the LCI
table. For example, you may want to avoid that the user uses weighting. You can also
specify the initial level of aggregation. For example, you can specify characterization as
the initial level. The user will see that the characterization level is shown first. If you
have permitted the user, he or she may choose to use another aggregation level.
18
SimaPro 7 Wizard Manual
In the tree node you specify what results must be presented, and how this must be done.
How refers both the definition of options available to the user, and the way the tree is
displayed initially.
If you choose ‘tree with values’ under ‘Mode’, you can specify what type of value is to be
displayed. Depending on your selection you can specify a specific substance, results
calculated with a certain impact assessment method, or a material. If you specified the
mini bar chart must display the results of an impact assessment method, you can specify
the level of aggregation under ‘Value’.
2.2 Variables
While the user goes through the wizards, he enters data. This data is stored in variables.
In addition, the wizard nodes themselves can create new information that needs to be
stored in variables.
All data collected or generated by the wizard can be stored in variables. There are 7
types of variables, each with different characteristics. These are explained in the
following sections.
The variables are stored in the same library or project in which your wizards are stored.
During the development of the wizards check carefully and document which variable is
used for exactly which purpose. A debugging window is available to see the contents of
the variables while testing a wizard.
19
SimaPro 7 Wizard Manual
The first step is always to start by making a link or assigning a process or product stage.
The second step is to link or assign an amount with unit. You cannot start with the
amount first, as you will not get the right results!
To start with the relation between variables and nodes, from bottom to top of Figure 21:
• Results from a calculate node are stored in a results variable
• The values a wizard user enters in an enter values node are stored in a numeric
variable
• The process or product stage a wizard user selects in a select process/product stage
node are stored in either a process reference variable or a product stage reference
variable
• Processes or product stages created by the wizard in an operation node are stored in
a process variable or a product stage variable
• Product stage
• Process
• Product stage reference
• Process reference
• Text
• Numeric
• Results
Figure 21 Relation between variables and nodes. Nodes are presented as a graph, variables in
text.
In Figure 22 you see the relation between variables and analyze/ show results nodes.
Process (reference) and product stage (reference) variables are the input for calculation
nodes and show tree nodes. The results of a calculation node are stored in a results
variable, and this variable is the input for a show chart/table node or a show LCA results
node.
20
SimaPro 7 Wizard Manual
• Product stage
• Process
• Product stage reference
• Process reference
• Text
• Numeric
• Results
Figure 22 Relation between variables and nodes. Nodes are presented as a graph, variables in
text.
Variables have different kinds of possible relationships as well (see Figure 23):
• Values stored in numeric variables can be linked to process (reference) variables and
product stage (reference) variables [- - - -]. Using this option you can attach an
amount to a process or product stage.
• Text in a text variable can be linked to process variables and product stage variables
[____]. Using this, you can give process and product stages a name, or use the text
typed in by the user to name processes or product stages created in the wizard.
• Process reference variables can be linked to process variables and product stage
variables [_ _ _]. This means you can link processes stored in the database to create
new processes or product stages in the wizard. For example, you can link a certain
amount (numeric variable) to electricity or transport in the database (process
reference variable) and link this to a new production process (process variable).
• Product stage reference variables can be linked to product stage variables […]. This
means you can link product stages stored in the database to new product stages
created in the wizard. For example you can use assemblies stored in the database as
subassemblies of a new assembly created in the wizard.
• Product stage
• Process
• Product stage reference
• Process reference
• Text
• Numeric
• Results
Figure 23 Relation between variables
21
SimaPro 7 Wizard Manual
The text (string) and numeric (value) parameters are always referred to by %s (strings)
and %d or (for values). They cannot have specific names.
%s Places the text contained in a text variable in the text field where you
have typed the text-code.
%d Places the value and unit contained in a numeric variable in the text field
where you have typed the text-code.
The string parameter allows the wizard writer to add variable texts to any node with a
text field. During the execution of the wizard, SimaPro will replace the string parameter
code by text that has been assigned to a String variable.
Figure 24 Example of the use of string parameters in the text field of a node
For example: You can ask the user in the enter name node to give a name of a product.
This name is assigned to a text variable. Now that the name is known, you can let this
name appear in any text in the following nodes. For example, you can make a text field
like: How many screws are in %s?
When the wizard is run it will not display %s but the value the user has assigned to the
string variable that belongs to %s.
Apart for the text variables there are also numeric variables. These are used to display
numbers. For example, you have asked about the number of legs of the table in an enter
value node. If the user has replied 4, this can be stored in a value variable. Later in the
wizard you can ask the question: are all %d legs painted? When the wizard is executed
the user will see that %d is replaced by the number 4.
If you want to include a variable, you simply type % s of %d within the text. You can
repeat this as many times as you want within one node. Do not use any other characters;
just use %s and %d as often as needed.
When you use %s or %d in the text, you have to click the sting variable button, which is
available on each node with a text field. A window will appear that lists the string and
value variables that are relevant for this node (see Figure 24). In this window you can
select the variables whose content should be displayed in the text. Use the insert button
to create or link to a variable. You will be shown a new box with an overview of all the
variables currently available. Select one, or create a new one and close that window. The
variable will now appear in the list. If you need more than one variable, as you have used
22
SimaPro 7 Wizard Manual
the %d or %s sign more than once in this node, repeat this operation. The order in which
the string or value parameters are listed determines which variable is linked to which
parameters.
Use the arrow buttons to place the variables in the correct order.
Displays a list of
wizards that refer
to this wizard.
Figure 25 Window of the wizard section with an explanation of the buttons on the right side of
the screen
23
SimaPro 7 Wizard Manual
Name and
comment are
visible for wizard
users in case of
executable
wizards
Buttons to add
nodes to the
wizard
Figure 26 shows a part of the window you will see when clicking the ‘New’ button to
create a new wizard. Here you can give a name to the wizard, and write the purpose of
this wizard under ‘comment’. The content of the comment field is visible for wizard
users in the case of executable wizards. This is similar to the comment field of processes.
For non-executable wizards, you can use the comment field for your own documentation.
The buttons on the right side of the screen can be used to add nodes.
2.4.1 Debugging
The debug tools help you to trace what is happening while you test run the wizard. The
debugging windows are automatically opened if you use the test run button. Three
windows open, which show data while you test run the wizard.
For example, if you run the guided tour wizard, step 5 calls another wizard. This wizard
creates a number of objects. By clicking the next button to go to step 6, you will see a
number of steps from the Create Objects sub wizard.
When an error occurs SimaPro will generate a message stating in which node, from which
sub wizard, the error occurred.
24
SimaPro 7 Wizard Manual
To jump from one wizard to another, you use the call wizard node. See for example
Figure 27. The wizard is started on the left side. A call wizard node activates wizard A.
Once all nodes from wizard A are done, the wizard jumps back to the horizontal branch
and follows the nodes in that first branch.
A wizard can have similar parts. You can make a copy of a wizard, and use call wizard to
connect all ‘sub wizards’. For example you design a wizard in which the wizard user can
model two different production processes, in order to make a comparison in the end. In
the wizard, you first want to collect data from one production process, and later collect
data from the alternative production process. The nodes required to enter the data will
be similar for both production processes, however the guidance text might be slightly
different. In that case you can model a wizard for the first production process, and make
a copy of that wizard in which you make some changes to create the wizard for the
alternative production process. This situation is shown in Figure 27.
Start
A A*
Figure 27 Schematic overview of the structure of a wizard with similar branches (A and A*)
Start
You can also use the call wizard node to repeat a part of the wizard. For example you
may want to enable the wizard user to add as many materials to a new assembly as he or
she would like to do. For this part of your wizard, you program a branch of the wizard in
which the user can select a material process and enter the amount of material in the
assembly. In an operation node you link the process with the appropriate amount to the
assembly. Then you can ask the user in a choose node whether he or she would like to
add more materials to the assembly. If the user wants to add more materials, a call
wizard follows, in which the wizard will call itself and the wizard will start all over. If the
user chooses not to do so, the wizard ends. If this branch wizard is used in another
wizard, it will jump back to the next node after the call ‘add material’ wizard node. This
situation is shown schematically in Figure 28.
25
SimaPro 7 Wizard Manual
The combination of choose- and call wizard nodes can also be used to create a flexible
wizard structure. Suppose you model an assembly in a wizard and before analyzing, you
want to give the user the option whether a life cycle with or without a waste scenario
should be modeled as well.
Figure 29 gives you some options to model a flexible structure in which the user can
choose what will be modeled. In this example the user models an assembly and has the
option to model a life cycle and a waste scenario. On the left side, the user chooses
directly after modeling the assembly what he or she will do. Depending on the choice,
the wizard will call other sub wizards. A choose node is always the end of the ‘main’
wizard, therefore the ‘analyze’ wizard has to be called in the three branches of the
choose node.
To prevent ending of the ‘main branch’ by a choose node, a structure such as that shown
in Figure 29 on the right side can be modeled. Before choose, a call scrip is introduced.
LC WS LC
LC WS
Figure 29 Flexible wizard structures in which the user has options to choose what wizard route
should be followed. Example where the wizard user models an assembly (Ass.) and
can choose to model a life cycle (LC) and a waste scenario (WS).
26
SimaPro 7 Wizard Manual
Wizard design
Changing a wizard that is already built is a hard task. Therefore before programming a
wizard, it is useful to start with a ‘goal and scope’ of the wizard you are making. In this
goal and scope you can deal with the following aspects:
• What is the purpose of the wizard (demonstration, easy analysis of new products,
etc.)?
• What is the audience and level of information input (see also section 1.3.1)
• Which parameters are flexible for the user
• What does the wizard create
• What are the possible routes through the wizard
• What results are presented in the wizard
It is helpful if you perform an LCA of the wizard topic first, to know the crucial aspects of
the life cycle.
If you make a wizard for a client, you can discuss the goal and scope with your client
before you start building it. This has proven to be useful, since the client will get an idea
of the result of the wizard at the beginning of the project, and can help in designing a
wizard that fulfils the expectations.
After designing the wizard on paper, build the technical node structure first. Check
whether the wizard is working and gives the expected results. Add messages and text
later on. If you have similar branches in your wizard, build one first and copy when
finished.
Processes are stored while running the wizard; product stages are stored after ending the
wizard. Thus, if the wizard user cancels the wizard while running, product stages are not
saved!
27
SimaPro 7 Wizard Manual
28
SimaPro 7 Wizard Manual
The next step in the wizard is to create an assembly with the name given by the wizard
user. We add an operation node. Under destination we put the variable for the product
stage. By doing this, a product stage is created by the wizard. We double click under
Source 1 to select the text variable with the name of the assembly. Under operation, we
select assign, to give the assembly the name stored in ‘AssemblyName’.
Figure 32 Operations node to create an assembly product stage with the name given by the
wizard user (stored in variable AssemblyName)
The wizard should continue by asking the user how many assemblies are needed in the
life cycle. Then a life cycle should be created that contains the right amount of
assemblies.
We will link the number of assemblies needed in the life cycle directly to the product
stage variable ‘Assembly_PS’, as this variable can contain an amount beside other types
of information. This will be done in an enter values node (see Figure 35)
29
SimaPro 7 Wizard Manual
Figure 33 Example of an enter values node where the user can enter the amount of assemblies
needed in a life cycle
Suppose the wizard user has named the assembly ‘table’. In that case the ‘enter name
node’ of
Figure 33 will appear to the wizard user as shown in
Figure 34.
Now that we know the amount of assemblies needed in the life cycle, we can create the
life cycle and link the assembly to the life cycle. This can be done in an operations node.
First we create the name of the life cycle by putting the text ‘Life cycle_” before the
name of the assembly. This life cycle name is stored in the text variable LifeCycleName.
In the second line of Figure 35 we assign that name to the life cycle product stage. By
doing so, the wizard will create this product stage. In the third line we link the assembly
30
SimaPro 7 Wizard Manual
to the life cycle. Since the amount is stored in the variable ‘Assembly_PS’ as well, the
wizard will link the appropriate amount of assemblies.
Consider the example of a wooden plank. To perform a life cycle assessment, SimaPro
needs input on the weight of the wood. Suppose the user has access to the measures of
the wood, like length, thickness and width. We ask the user to enter these values and
store them in three variables: ‘WoodLength’, ‘WoodWidth’ and ‘WoodThick’. The wizard
can use these values to calculate the weight of the plank based on the density of wood
(assume 600 kg/m3).
See Figure 36 to see how such an operation is programmed. Each line can only contain
one calculation step. Since we need several calculation steps, we need several lines in
the operation. The results of each step are stored in a temporary numeric variable
‘TempValue’. The first step is to multiply the length with the width. The second step is
to multiply the result of the first line with the thickness of the wood, which results in the
calculated volume of the wood. The last step is to multiply the volume with the density.
Please note that the unit of the calculated result under density must be given as well.
Wizards can use the unit conversions and the factors between units of the same quantity.
This means you can use different units of the same quantity in an operation node, since
the wizard ‘knows’ that 1000 grams equal 1 kilogram.
31
SimaPro 7 Wizard Manual
Figure 36 Operation to calculate the weight of a material based on its density and measures
(length, width and thickness)
Assignment A
Imagine the wizard user is a packaging designer who designs glass bottles for beer, who wants to know a little
bit about the environmental impact of the glass container.
In the wizard, you will start asking the wizard user to enter the weight of the bottle and the steel cap. Then you
create an assembly with the name ‘bottle’ and link processes from libraries in your database with the
appropriate amounts
Tip: Start with an operations node to link the library processes to variables. Processes must be linked to
variables before amounts are linked!
For assignment A, you can make a wizard that looks like the wizard displayed in Figure
37. This wizard has three nodes, that are shown in Figure 38 to Figure 40.
32
SimaPro 7 Wizard Manual
Figure 38 Step 1 to model a bottle wizard: attach processes from the database to variables
33
SimaPro 7 Wizard Manual
Figure 39 Step 2 to model a bottle wizard: ask to enter the weight of the materials
create assembly
product stage with
the name ‘Bottle’
Bottle is a text
(string) typed in
by the wizard
programmer
Figure 40 Step 3 to model a bottle wizard: operation to create product stage and link
materials
34
SimaPro 7 Wizard Manual
Assignment B
In the next step of the wizard, you want to show the designer the environmental impact of the bottle. Therefore
you make an analysis with the impact assessment method Eco-indicator 99 (H/A).
Before ending the wizard, you delete the bottle assembly, to prevent errors. An assembly with the same name
(bottle) should not be stored twice in the SimaPro database.
To make assignment B, the wizard is expanded with three more nodes. These are shown
in
Figure 41 Step 4 to model a bottle wizard: Calculate the results of an analysis with Eco-
indicator 99 and store the results in a variable
35
SimaPro 7 Wizard Manual
Figure 42 Step 5 to model a bottle wizard: show the calculated results stored in variable
‘BottleEI99’ in a chart to the wizard user
Figure 43 Step 6 to model a bottle wizard: delete the product stage created by the wizard
36
SimaPro 7 Wizard Manual
Figure 44 Windows of the bottle wizard as they are presented to the wizard user
37
SimaPro 7 Wizard Manual
4 Product Systems
The answers of a wizard can be saved in a ‘product system’ in the category ‘Wizard’ in
the SimaPro explorer. A product system presents on one page all of the answers a wizard
user gave while running the wizard. The user can ‘run’ a product system and make
changes to the values entered in the wizard. These changes can be saved in the project
he or she is working in, without having to run the wizard again. This can be a powerful
feature for wizard users if they want to make small changes in a model created during
previous running of a wizard.
Product systems can be created at the end of an executable wizard that is run using
‘tools’ in the menu bar. At the end of the wizard the user sees a window in which he or
she can specify the name of the product system in which to save the answers from the
wizard (Figure 45).
Figure 45 Window at the end of a wizard in which the wizard user can save the answers from
the wizard in a product system
Product systems are stored under ‘Product systems’ in the wizard section of the explorer
of SimaPro. Users can use the product system using the ‘run’ button. An example of a
product system is shown in Figure 46. The user can change the data in the white field. By
clicking on the show tree button, the user will see the tree of the modeled life cycle
above the button. To decrease the length of a product system, the user has the option to
hide the information text (see Figure 47).
38
SimaPro 7 Wizard Manual
Figure 46 Window of a product system saved after running the LCA wizard
Figure 47 Window of a product system saved after running the LCA wizard, with text hidden
39
PRé Consultants bv
Plotterweg 12
3821 BB Amersfoort
the Netherlands
phone + 31 33 4555022
fax + 31 33 4555024
e-mail [email protected]
web site www.pre.nl