2012-01-23T19:22:16Z

Cmcooney: Editing Co-Products of a process

Editing Co-Products of a process

Co-Products

2012-01-23T17:36:29Z

Cmcooney:

Co-Products

2012-01-23T17:31:38Z

Cmcooney:

Co-Products

2012-01-23T16:04:46Z

Cmcooney:

Co-Products are resources which are secondary products created alongside the main output which can be accounted for in the production of that resource. CoProducts can be added to a stationary process from the stationary process editor either by selecting a resource which is not in an input group and right clicking the "Set As Co-Product" option.

=Allocation=
==Calculations==
===Parameters===
*<math>Out_{value} = Out_a * Out_{cost} \,</math> = Value associated with the main output amount, after the losses. <math>Out_{cost}</math> = {energy value, market value, mass, volume}
*<math>Copr_{value} = Copr_a*Copr_{cost} \,</math> = Value associated with the co-product output amount. <math>Copr{cost}</math> = {energy value, market value, mass, volume}
*<math>ee \,</math> = Energy and Emissions associated to that co product ( in Joules and Grams per unit of Output for the current process )
*<math>inputs \,</math> = Energy and Emissions for all the inputs of the current process ( in Joules and Grams per unit of Output for the current process )
===Calculations===
For each allocation method it will be the same idea :
*We convert the amount given for the co product into a quantity of energy, mass, market value or volume depending on the allocation method chosen.
*We grab the amount after losses of the main output
*We calculate the allocation ratio which will be :
<center><math> r = 1 - \frac{Out_{value}}{Out_{value} + Copr_{value}} \,</math></center>
*We calculate the energy and emissions associated to that co product :
<center><math>ee = r \cdot inputs\,</math></center>

Note : <math>Out_{value} \,</math> and <math>Copr_{value} \,</math> are in the same unit, they can be both in Joules, Grams, Cubic Meter or Dollar depending of the allocation method chosen.

=Displacement=
==Calculations==
===Parameters===
*<math>MixEE_{mpm} \,</math> = conventional [[Materials_Calculations#Mix|material mix]] energy and emissions, which are the necessary energy and emissions associated to the production of that material for the specified purpose for this specific mix.
*<math>S_{mpm} \,</math> = the share of the conventional material purpose mix displaced.
*<math>ee \,</math> = Energy and Emissions associated to that co product ( in Joules and Grams per unit of Output for the current process )

===Calculations===
*For each conventional material mix defined in the displacement ratios we grab the mix energy and emissions. We also grab at the same time the conventional material share.
*We add to the co product energy and emissions the amount displaced, by each conventional material displaced :
<center><math> ee = ee + MixEE_{mpm} \cdot S_{mpm} \,</math></center>

===XML Example===

This example is extracted from the process [[600|Dry Mill Ethanol Production (US Industry Average)]]. It shows a coproduct which is calculated as a displacement. But if the user wants to change the method and calculate it with the allocation method, the different options which will be shown to the user are also defined.

<source lang="xml">
<coproduct ref="116" method="displacement" amount="[dgs_params!A3];0;True;pounds">
<allocation value="energy" >
<option>energy</option>
<option>market</option>
<option>mass</option>
</allocation>
<conventional_products >
<product ref="75" purpose="stationary" mix="0" ratio="[composite_displacement_ratios!B3];0;True;percentage"/>
<product ref="117" purpose="stationary" mix="0" ratio="[composite_displacement_ratios!C3];0;True;percentage"/>
<product ref="91" purpose="stationary" mix="0" ratio="[composite_displacement_ratios!D3];0;True;percentage"/>
</conventional_products>
</coproduct>
</source>

=Common Calculations=
==Parameters==
*<math>S_{copr}\,</math> = share of the coproduct
*<math>ee \,</math> = Energy and Emissions associated to that co product ( in Joules and Grams per unit of Output for the current process )
==Calculations==
At the end of the calculation process for one of this co products we are doing a last operation which is multiplying the <math>ee \,</math> by a share.
This share can be used to define many co products and assign them shares. So the last operation will be :
<math>ee = ee * S_{copr} \,</math>

=Co-Product Editor in GUI=

[[File:Co-productEditor.png|thumb|right|500px|Co-Product Editor]]

Co-Product editor can be used to add and/or edit Co-Products for the process.
The editor can be accessed either through Data Editor page or by right clicking on a process in the Well to Pump Setup page and selecting Edit Process Parameters.

Only the existing co-products are shown in the co-product editor. To add a new Co-product, click "Add a Co-Product" in the window. New Co-product is shown in the window as shown in the picture.

Select the Co-product material from the dropdown list which will enable other fields like the amount, share and check boxes to select the available type of treatments for the co-product.

Selecting the "Default Treatment Method" will make use of that treatment method for the calculations in the application.

If "Allocation" treatment method is checked, the allocation type can be selected for the co-product. The available allocation type are given depending upon the characteristics of the co-product material selected.

if "Displacement" treatment method is checked, the Displacement material, Purpose, Mix and Displacement ratio can be selected in the same order. Few of the options can be unavailable depending upon the characteristics of the co-product displacement material selected.
Any number of displacement materials can be added along with the specific fields for that displacement material.

Co-Products

2012-01-23T14:55:54Z

Cmcooney: Created page with "=Allocation= ==Calculations== ===Parameters=== *<math>Out_{value} = Out_a * Out_{cost} \,</math> = Value associated with the main output amount, after the losses. <math>Out_{cost…"

=Allocation=
==Calculations==
===Parameters===
*<math>Out_{value} = Out_a * Out_{cost} \,</math> = Value associated with the main output amount, after the losses. <math>Out_{cost}</math> = {energy value, market value, mass, volume}
*<math>Copr_{value} = Copr_a*Copr_{cost} \,</math> = Value associated with the co-product output amount. <math>Copr{cost}</math> = {energy value, market value, mass, volume}
*<math>ee \,</math> = Energy and Emissions associated to that co product ( in Joules and Grams per unit of Output for the current process )
*<math>inputs \,</math> = Energy and Emissions for all the inputs of the current process ( in Joules and Grams per unit of Output for the current process )
===Calculations===
For each allocation method it will be the same idea :
*We convert the amount given for the co product into a quantity of energy, mass, market value or volume depending on the allocation method chosen.
*We grab the amount after losses of the main output
*We calculate the allocation ratio which will be :
<center><math> r = 1 - \frac{Out_{value}}{Out_{value} + Copr_{value}} \,</math></center>
*We calculate the energy and emissions associated to that co product :
<center><math>ee = r \cdot inputs\,</math></center>

Note : <math>Out_{value} \,</math> and <math>Copr_{value} \,</math> are in the same unit, they can be both in Joules, Grams, Cubic Meter or Dollar depending of the allocation method chosen.

=Displacement=
==Calculations==
===Parameters===
*<math>MixEE_{mpm} \,</math> = conventional [[Materials_Calculations#Mix|material mix]] energy and emissions, which are the necessary energy and emissions associated to the production of that material for the specified purpose for this specific mix.
*<math>S_{mpm} \,</math> = the share of the conventional material purpose mix displaced.
*<math>ee \,</math> = Energy and Emissions associated to that co product ( in Joules and Grams per unit of Output for the current process )

===Calculations===
*For each conventional material mix defined in the displacement ratios we grab the mix energy and emissions. We also grab at the same time the conventional material share.
*We add to the co product energy and emissions the amount displaced, by each conventional material displaced :
<center><math> ee = ee + MixEE_{mpm} \cdot S_{mpm} \,</math></center>

===XML Example===

This example is extracted from the process [[600|Dry Mill Ethanol Production (US Industry Average)]]. It shows a coproduct which is calculated as a displacement. But if the user wants to change the method and calculate it with the allocation method, the different options which will be shown to the user are also defined.

<source lang="xml">
<coproduct ref="116" method="displacement" amount="[dgs_params!A3];0;True;pounds">
<allocation value="energy" >
<option>energy</option>
<option>market</option>
<option>mass</option>
</allocation>
<conventional_products >
<product ref="75" purpose="stationary" mix="0" ratio="[composite_displacement_ratios!B3];0;True;percentage"/>
<product ref="117" purpose="stationary" mix="0" ratio="[composite_displacement_ratios!C3];0;True;percentage"/>
<product ref="91" purpose="stationary" mix="0" ratio="[composite_displacement_ratios!D3];0;True;percentage"/>
</conventional_products>
</coproduct>
</source>

=Common Calculations=
==Parameters==
*<math>S_{copr}\,</math> = share of the coproduct
*<math>ee \,</math> = Energy and Emissions associated to that co product ( in Joules and Grams per unit of Output for the current process )
==Calculations==
At the end of the calculation process for one of this co products we are doing a last operation which is multiplying the <math>ee \,</math> by a share.
This share can be used to define many co products and assign them shares. So the last operation will be :
<math>ee = ee * S_{copr} \,</math>

=Co-Product Editor in GUI=

[[File:Co-productEditor.png|thumb|right|500px|Co-Product Editor]]

Co-Product editor can be used to add and/or edit Co-Products for the process.
The editor can be accessed either through Data Editor page or by right clicking on a process in the Well to Pump Setup page and selecting Edit Process Parameters.

Only the existing co-products are shown in the co-product editor. To add a new Co-product, click "Add a Co-Product" in the window. New Co-product is shown in the window as shown in the picture.

Select the Co-product material from the dropdown list which will enable other fields like the amount, share and check boxes to select the available type of treatments for the co-product.

Selecting the "Default Treatment Method" will make use of that treatment method for the calculations in the application.

If "Allocation" treatment method is checked, the allocation type can be selected for the co-product. The available allocation type are given depending upon the characteristics of the co-product material selected.

if "Displacement" treatment method is checked, the Displacement material, Purpose, Mix and Displacement ratio can be selected in the same order. Few of the options can be unavailable depending upon the characteristics of the co-product displacement material selected.
Any number of displacement materials can be added along with the specific fields for that displacement material.

Create and Edit Transportation Modes

2012-01-20T18:08:25Z

Cmcooney: /* Rail */

==Quick mode editor==
[[File:ModeParameters.png|thumb|left|300px|Mode Parameters Form]]

'''Usage:''' The mode parameters form allow the user to see more details about this transportation processes. To open it, right click on a step and click "Edit Mode Parameters" in the transportation editor, or click the name of a step in the well to pump setup.
This allow to change which fuels are used by the step and define if the material is going to and back from destination. Some steps might only go to the destination, but some steps like the barges and the trucks, have to go back to origin to be loaded again, therefore those processes have the Back Haul option checked.

The energy intensities are usually calculated for each mode, however it is possible to override them using a user value. If this is wanted, just change the EI corresponding the desired process fuel, but read the note below, this is a global step parameter.

The link "Edit Technologies" is forwarding to the [[emissions factors editor]], and will allow the user to see/change the emission factors for the technologies used for that mode. The technologies might be a gasoline engine or a NG turbine.

'''Warning''' There are some global are local parameters in that control. 
Local :
*Distance
*Share
*Fuel Share
*Back haul
*To Dest

Global :
*EIs values
*Fuel Shares ratios

Changing any of the local parameters will affect only the current step, hover changing an energy intensity, will change that energy intensity for any of the same steps, transporting the same material. In the example shown on the left, if the EI To or From are changed for NG, all the Pipeline transporting the same material, powered by a NG compressor will be affected.

If the fuel shares ratios are changed, this will also apply to all the pipelines. If a different fuel share is needed especially for that step, the user should create a new fuel share combinaison, and select it from the combo box instead of adjusting the global shares.

==Full Modes Editor==
[[file:full_mode_editor_tanker.png|thumb|300px|right|Ocean Tanker/Barge full editor]]
The full mode editor allows to modify payloads, energy intensities and fuel shares. It is quite different for each mode because each mode has it's own parameters.

This control is spitted in three main regions, two of them are common to all modes, the last one displays mode specific parameters. The general parameters includes name, picture, mode type and notes. The mode type selection will define what should be displayed in the mode specific parameters.

The fuel shares part is also the same for any of the modes, it defines a list of usual fuel shares used by the modes. Then we don't have to define the fuel shares for all the steps in the transportation processes, but instead we just have a reference to one of those fuel shares list. It's possible to create as many lists as needed.

===Ocean Tanker / Barge===

The ocean tanker and barge mode editor are the same, the only thing which differentiate those two steps, besides the data, is a small change in the energy intensity calculations.

For this mode the average speed, load factor to an from can be changed as well as the baseline fuel used for energy calculations and the payload for each material transported. The average speed is usually used for tanker or barges which are boiling off some material, we use the speed of the mode, and the distance of the step to calculate the time necessary for the journey, then calculate the losses using the loss rate, this is described in more details in the losses section. To change the payload for a specific material, select which you want to change in the drop down and change the value of the payload. To add a new transported material click on the "+" button on the right, to remove a transported material, select it and click "-" button. No changes will be done to the data until you click the "Save" button on the bottom left. This button is not shown here for space reasons.

The fuel shares can be changed too. For ocean tanker usually we only use bunker fuel, but if some more fuels are necessary, click the "+" button on the right side of the last fuel of a fuel share Source. If a new fuel share Source is necessary, click the "+" button on the right side of the last fuel share Source. To remove fuels, or to remove fuel share Source, use the "-" buttons.

===Truck===
[[file:full_mode_editor_truck.png|thumb|200px|right|Truck full editor]]
For trucks the fuel shares and general parameters are the sames. The mode specific parameters contains the fuel economy to and from, the baseline fuel, and the payload. The baseline fuel define what fuel is assumed to be used to achieve the fuel economy specified above. Then those parameters are used to calculate the amount of energy necessary for the truck assuming the defined payload for the transported material.
Once this energy is calculated, any fuel can be used as an assumption for the upstream. For example we could imagine that we want to simulate a truck running on compressed natural gas, as we have a lack of information concerning the MPG for this type of engine in a truck, we calculate the equivalent amount which would be used assuming that the NG engine has the same efficiency as the baseline fuel engine.

====Pipeline====
The pipeline specific parameters only contains the energy intensities. Instead of being automatically calculated like the EIs of ocean tanker, barge, and trucks, the pipelines define specific EI for a few fuels transported. We differentiate Energy Intensity for liquid, solid, natural gas, flare gas and hydrogen. This is an approximation from the data we know about energy intensities for pipelines. Solids are usually transported using water and this is why the EI for solids and liquid has the same value. Natural Gas and Flare Gas are the same materials, they just have different upstream as one is made for being cleaned and used, the flared gas is usually a lost byproduct.

===Rail===
[[file:full_mode_editor_rail.png|thumb|200px|right|Rail full editor]]
For trains a single EI is used whatever gets transported and for any payload. The average speed is used for materials which are boiling off over the transportation process. The time of transportation is calculated using speed and distance, and using the boil off rate, we can determine how much material gets lost.

===Connector===
Connectors are dummy steps which are not using any energy. They are used in transportation structures to symbolize a direct link between two places.

Create and Edit Transportation Modes

2012-01-20T18:07:12Z

Cmcooney: /* Full Modes Editor */

==Quick mode editor==
[[File:ModeParameters.png|thumb|left|300px|Mode Parameters Form]]

'''Usage:''' The mode parameters form allow the user to see more details about this transportation processes. To open it, right click on a step and click "Edit Mode Parameters" in the transportation editor, or click the name of a step in the well to pump setup.
This allow to change which fuels are used by the step and define if the material is going to and back from destination. Some steps might only go to the destination, but some steps like the barges and the trucks, have to go back to origin to be loaded again, therefore those processes have the Back Haul option checked.

The energy intensities are usually calculated for each mode, however it is possible to override them using a user value. If this is wanted, just change the EI corresponding the desired process fuel, but read the note below, this is a global step parameter.

The link "Edit Technologies" is forwarding to the [[emissions factors editor]], and will allow the user to see/change the emission factors for the technologies used for that mode. The technologies might be a gasoline engine or a NG turbine.

'''Warning''' There are some global are local parameters in that control. 
Local :
*Distance
*Share
*Fuel Share
*Back haul
*To Dest

Global :
*EIs values
*Fuel Shares ratios

Changing any of the local parameters will affect only the current step, hover changing an energy intensity, will change that energy intensity for any of the same steps, transporting the same material. In the example shown on the left, if the EI To or From are changed for NG, all the Pipeline transporting the same material, powered by a NG compressor will be affected.

If the fuel shares ratios are changed, this will also apply to all the pipelines. If a different fuel share is needed especially for that step, the user should create a new fuel share combinaison, and select it from the combo box instead of adjusting the global shares.

==Full Modes Editor==
[[file:full_mode_editor_tanker.png|thumb|300px|right|Ocean Tanker/Barge full editor]]
The full mode editor allows to modify payloads, energy intensities and fuel shares. It is quite different for each mode because each mode has it's own parameters.

This control is spitted in three main regions, two of them are common to all modes, the last one displays mode specific parameters. The general parameters includes name, picture, mode type and notes. The mode type selection will define what should be displayed in the mode specific parameters.

The fuel shares part is also the same for any of the modes, it defines a list of usual fuel shares used by the modes. Then we don't have to define the fuel shares for all the steps in the transportation processes, but instead we just have a reference to one of those fuel shares list. It's possible to create as many lists as needed.

===Ocean Tanker / Barge===

The ocean tanker and barge mode editor are the same, the only thing which differentiate those two steps, besides the data, is a small change in the energy intensity calculations.

For this mode the average speed, load factor to an from can be changed as well as the baseline fuel used for energy calculations and the payload for each material transported. The average speed is usually used for tanker or barges which are boiling off some material, we use the speed of the mode, and the distance of the step to calculate the time necessary for the journey, then calculate the losses using the loss rate, this is described in more details in the losses section. To change the payload for a specific material, select which you want to change in the drop down and change the value of the payload. To add a new transported material click on the "+" button on the right, to remove a transported material, select it and click "-" button. No changes will be done to the data until you click the "Save" button on the bottom left. This button is not shown here for space reasons.

The fuel shares can be changed too. For ocean tanker usually we only use bunker fuel, but if some more fuels are necessary, click the "+" button on the right side of the last fuel of a fuel share Source. If a new fuel share Source is necessary, click the "+" button on the right side of the last fuel share Source. To remove fuels, or to remove fuel share Source, use the "-" buttons.

===Truck===
[[file:full_mode_editor_truck.png|thumb|200px|right|Truck full editor]]
For trucks the fuel shares and general parameters are the sames. The mode specific parameters contains the fuel economy to and from, the baseline fuel, and the payload. The baseline fuel define what fuel is assumed to be used to achieve the fuel economy specified above. Then those parameters are used to calculate the amount of energy necessary for the truck assuming the defined payload for the transported material.
Once this energy is calculated, any fuel can be used as an assumption for the upstream. For example we could imagine that we want to simulate a truck running on compressed natural gas, as we have a lack of information concerning the MPG for this type of engine in a truck, we calculate the equivalent amount which would be used assuming that the NG engine has the same efficiency as the baseline fuel engine.

====Pipeline====
The pipeline specific parameters only contains the energy intensities. Instead of being automatically calculated like the EIs of ocean tanker, barge, and trucks, the pipelines define specific EI for a few fuels transported. We differentiate Energy Intensity for liquid, solid, natural gas, flare gas and hydrogen. This is an approximation from the data we know about energy intensities for pipelines. Solids are usually transported using water and this is why the EI for solids and liquid has the same value. Natural Gas and Flare Gas are the same materials, they just have different upstream as one is made for being cleaned and used, the flared gas is usually a lost byproduct.

===Rail===
[[file:full_mode_editor_rail.png|thumb|200px|left|Rail full editor]]
For trains a single EI is used whatever gets transported and for any payload. The average speed is used for materials which are boiling off over the transportation process. The time of transportation is calculated using speed and distance, and using the boil off rate, we can determine how much material gets lost.

===Connector===
Connectors are dummy steps which are not using any energy. They are used in transportation structures to symbolize a direct link between two places.

File:ModeParameters.png

2012-01-20T18:05:50Z

Cmcooney:

File:Full mode editor truck.png

2012-01-20T18:04:53Z

Cmcooney:

File:Full mode editor tanker.png

2012-01-20T18:04:04Z

Cmcooney:

Cmcooney: /* How it works */

Unit System

2012-01-18T02:32:08Z

Cmcooney: /* Setting Unit Preferences */

2012-01-17T17:08:14Z

Cmcooney: /* Preferences from textbox context menu */

Unit System

2012-01-17T17:07:17Z

Cmcooney: /* Preferences from textbox context menu */

==Unit System==

===How it works===

===Setting Unit Preferences===

====Preferences from General Settings====

====Preferences from textbox context menu====
[[File:ChangeUnitfromContext.png|thumb|right|400px|Change Unit preferences from the context menu]]
The preferred unit for a parameter can also be changed by right clicking on a textbox and going to "Change Unit". This will open a small window which allows changing what unit the value will be displayed in. If the value has multiple units associated with it, such as with the "Heating Value Liquid" in the picture below, then the preferred unit can be selected for each unit group. Note that changing the preferred units in this way will still change the unit of all other parameters of that unit group so in this case all "Heating Value Liquid" parameters will affected with the new unit selection.

Quick start guide

2012-01-17T17:04:54Z

Cmcooney: /* Data Editor */

=How to Install and Run GREET=

==Running GREET==

To run GREET simply run the GREET executable file from a file browser or a shortcut. Running the executable will open the program and allow loading GREET project files. To gain easier access right click the executable and go to send to and then select Desktop (create shortcut).

==Selecting Working Folder==

The processing and data files are separated to allow easily loading and saving multiple project files. After running GREET for the first time you will be asked to select the folder where these data files are stored.

[[File:SelectFoldersMsg.png|thumb|300px|left|Select folders message]]

[[File:SelectFolders.png|thumb|250px|none|Selecting project folders]]

After selecting OK on the message a window will open for selecting the location of the data folders. Navigate to where the "Pictures","Log", and "Data" folders are on your system and select the folder directly above these folders then select OK. The program will load the data files and display the graphical user interface (GUI).

==Copying/Moving Data Folders==

To copy the data folders to a new directory select copy on the directory containing the "Data", "Log", and "Pictures" folders and paste it to a new location. This allows customizing where on the computer the program/data is stored.

=Using the GUI=

The GUI separates the key points of setting parameters and viewing results into various controls accessible through the buttons at the top of the main GUI window.

[[File:StepsBarWithPictures.png|thumb|700px|center]]

This image shows the main navigation of the program. Each of the main views can be selected by clicking one of the large buttons on the step bar. In the toolbar the "File" dropdown exposes options for loading and saving GREET projects. The "Results" dropdown shows options for manually recalculating the results and monitoring values. From the "Preferences" dropdown the preferences window can be shown and the table editor can be opened. From the "About" dropdown database information can be viewed, the software can be updated, and the help pages can be opened.

==Preferences==

The main preference pages are the unit and calculation preferences accessible through their associated tabs within the preference window. The unit page, visible below, allows selecting desired units for various groups. Changing the value in the User defined column will cause values of that unit group to be displayed with the selected unit. If a group is made up of multiple units groups then the units can be changed within each group. An example of this is the first unit in the image below where Energy Intensity is composed of Energy over Distance over Mass.

[[File:PreferencesUnits.png|thumb|300px|left]]
[[File:PreferencesCalculations.png|thumb|310px|none]]

The calculations tab provides various options for controlling how the calculations are executed and displayed. The "Running Options" group of options allows changing calculation parameters such as the maximum iterations to run for calculating upstream values.

==Main views==

[[File:StepsBar.png|thumb|700px|center]]

This image shows the main views, mousing over a button will display the text as shown or displaying the images can be disabled from the preferences.

===Basic Parameter Setup===

This control allows modifying many of the simulation parameters within various tables such as which year to simulate. The tables have a title explaining more about what the table is used for and the cells display the various values. A light blue cell indicates that the value comes from a formula referencing other table values which can be viewed or modified by right clicking and selecting "Edit Formula". Each value stores a default number and an current number which can be swapped by selecting "Switch to default value" and "Switch to user value" from the right click menu. This allows making changes and easily returning to a default value. For most cells the value has an associated unit which can be modified from the right click menu by selecting "Change Unit" and then selecting the desired units.

[[File:BasicParameterSetup.png|thumb|none|500px|The Basic Parameter Setup Control]]

===Well to Pump Setup===

This allows viewing and modifying parameters specific to processes as well as pathways.
====Pathway Selection====
The tree selection in the top left allows selecting a pathway which are organized into light duty vehicle (LDV) fuels, feedstocks, and others. Fuels that make up a family of actual fuels are denoted by a lighter teal color such as Diesel and Gasoline which have multiple fuels under those names. Under each fuel are mixes which represent a particular blend of fuels. Under each mix is one or more pathways which output a fuel that goes into the mix and next to it is the share that the fuel contributes to the mix.

====Pathway Representation====
The large panel on the right with boxes is a graphical representation of the selected pathway. If the pathway has a fuel that feeds into it then the feed panel will be on the left denoted by a light orange background. After the calculations have been run this panel displays a summary of energy and emissions for the feed mix when the mouse is moved over it. Clicking the title link will display the feed pathway and the back button on the pathway selection control allows returning to the previous pathway.

To the right of the feed are the processes with Stationary Processes showing with a light blue background and Transportation Processes with a pink background. Double clicking a Stationary Process expands the process to display the process fuels consumed in the process and if a fuel has technologies associated with it then it can be expanded to view the technologies. Double clicking a transportation process expands the process to display a graphical representation of the locations and modes that represent the transporting of the material to the destination. Double upward arrows next to a process represent a loss (leakage or boil-off) which can be displayed by clicking the arrows. Various parameters can be set for each process and the titles in blue can be used to open a window with more parameters for that object.

====Property Display====
The bottom left control displays properties for the selected object in the pathway representation. The pathway summary can also be display by clicking the "Switch to pathway" button. The emissions section displays how much of each gas emission is released and is also broke down intro all included and partial upstream.

For ease of use the emissions are shown in the groups criteria pollutants, emission gases, from combustion, and greenhouse gases. The energy is broken down into upstream included and partial upstream as well as displaying energy per process fuel. In addition it is grouped into fossil, petroleum, natural gas, coal, non fossil, nuclear, and renewable fuels. If a loss is as is associated with the selected process then it will display in the losses section.

[[File:WellToPumpSetup.png|thumb|none|700px|The Well to Pump Setup control]]

===Well to Pump Results===
The well to pump results allow viewing and comparing the energy usage and emission results for each of the pathways in each of the mixes for a LDV fuel.

[[File:WellToPumpResultsTabular.png|thumb|none|700px|Well to pump results in table format]]

The tabular version of the results displays the energy usage and emissions for each pathway as well as the weighted average of the values based on the share of each pathway. The pathways that are displayed depends on what is selected on the left material selection control. If the resulting material is selected then each pathway within each mix is displayed on the right as well as the weighted results for the mix. The column header represents this by starting with either "PATH" for pathway results or "SRC" for the mix results. Selecting a single pathway will display the energy used and emissions for each process within the pathway each denoted by "PROC" in the result table. The results can be exported by right clicking and selecting "Copy to Clipboard" or "Save to XML File". Once copied the results can either be pasted into Excel or a text editor.

[[File:WellToPumpResultsGraphical.png|thumb|none|700px|Well to pump results in graphical format]]

The graphical format of the results allows seeing the pathways as they feed into a mix of the resulting LDV fuel. Each of the pathways display on the left of the graphic with their name and share amount as well as the emissions displayed on the left of the panel and the energy displayed on the right. The source box then shows the weighted mix results from combining the output of the pathways.

===Pump to Wheels Setup===

This control allows setting assumptions for vehicles to be used in the well to wheels simulation. The vehicles or sorted by the LDV fuel that they run on and can be selected from the list on the left. The parameters for that vehicle will display on the right.

[[File:PumpToWheelsSetup.png|thumb|none|700px|Vehicle Setup Control]]

A "normal" or "cs" vehicle displays parameters for a combustion engine vehicle as shown above. Many of the vehicles' parameters are based on a baseline vehicle in which case the "% of baseline" columns will be active and changes to values in emissions or miles per gallon will adjust the % of the baseline according for that parameter.

[[File:PumpToWheelsSetupCD.png|thumb|none|400px|CD parameters for hybrid electric vehicles]]

The "cd" control displays options for plug-in hybrid electric vehicles (PHEV). The primary attributes for PHEVs are the electric range, fuel consumption, electricity consumption, charging efficiency, and the source mix for electricity.

===Well to Wheels Results===

[[File:WellToWheelsResults.png|thumb|none|700px|Well to Wheels Results Control]]

===Data Editor===
[[File:DataEditorSelection.png|thumb|none|700px]]

The controls in the data editor allow direct access to the data stored within the model including the pathways, processes, resources, and more. Many of the controls are linked to from other places such as clicking the name of a process within the well to pump setup and the resulting process editor being opened in a new window.

For detailed information on any of the controls see the Full User Manual under Data Editor.

=Example study=
==Gasoline Production - Well to Wheels==
This part of the guide will run through carrying out a simulation for production of gasoline and combustion in a gasoline car.

First start with the "Basic Parameter Setup" and look through the simulation parameters for tables related to conventional gasoline as well as general parameters. This simulation will use the default simulation year of 2010 which is in the "single parameters" tab. Next look through the "Materials Calculated Parameters" tab for Conventional Gasoline which shows assumptions about the fuel. If you have different assumptions for the density or heating value they could be inputted here. Also note the "Other Options" section to the left of the tables as this option determines whether the lower heating value or upper healing value is used for calculations.

[[File:CalculatedFuelSpecifications.png|thumb|400px|none]]

The "Transportation Calculated Parameters" table can be used to set parameters for the modes of transportation for the fuel such as average speed and load factor of an ocean tanker carrying crude oil. Additional mode options can be accessed from the data editor under "Edit Modes".

[[File:TransportationModeOptions.png|thumb|600px|none]]

Moving to the well to pump setup control from the top navigation bar, the Gasoline mixes are found under the "Gasoline" group in the pathway selection. Navigating down to a mix under "Conventional Gasoline" it shows that there is currently one mix stored called "From Crude Oil Mix" and selecting it displays the pathway.

By hovering the mouse of the Feed box, which is tan colored, the energy and emission results for the feed mix pathways are displayed in a drop down summary of the pathways. Clicking the feed name redirects this control to the first feed pathway and selects displays the mix in the pathway selection. Doing this for this CG feed there are three pathways in the mix that feeds into the "From Crude Oil Mix", those being conventional crude oil at 90.6%, crude oil from oil sands at 4.7%, and crude oil from surface mining at 4.7%. The shares show how much weight each pathway has on the results for that mix.

Clicking the back button brings me back to the CG pathway where three processes are visible. The stationary processes, the light blue ones, can be expanded by double clicking in order to set parameters for the process fuels and their technologies.

[[File:WellToPumpSetupCG.png|thumb|700px|none]]

Expanding a transportation process, the pink colored processes, displays the transportation breakdown for the fuel. The starting locations where the conventional gasoline is being moved from are displayed at the far left followed by a series of transportation modes for representing how the resource will be moved. The distance can be set for the estimated distance that mode will travel, the share specifies how much of the total transported material will be moved using that mode, and clicking the mode name link will open a form for setting other parameters such as fuel shares and energy intensities.

[[File:CGTransportation.png|thumb|600px|none]]

At the bottom left the results for various objects can be displayed. Simply select a process, input under a process, or transportation step to view the emissions and energy used for that object. The "Switch to Pathway" button can be used to go back to the pathway results.

[[File:CGPathwayResults.png|thumb|200px|none]]

Moving to the "Well to Pump Results" page shows the cumulative emissions and energy used for the Crude oil mix to conventional gasoline pathway as well as the mix results for conventional gasoline (the same since there is only one pathway. The results can also be displayed and exported from the table view tab.

[[File:WellToPumpResultsCG.png|thumb|700px|none]]

The "Pump to Wheels Setup" page allows setting up parameters for the vehicle that will be consuming the LDV resource in the simulation. The gasoline car includes parameters for the fuel economy, emissions, and the LDV fuel mixes to use. This vehicle is considered a baseline vehicle, that being other vehicles base their assumptions as a percent of this vehicle's values, so the up/down and share controls are disabled.

[[File:PumpToWheelsSetupCG.png|thumb|700px|none]]

File:ChangeUnitfromContext.png

2012-01-17T17:03:27Z

Cmcooney: Changing preferred units from the context menu of a textbox

Changing preferred units from the context menu of a textbox

Unit System

2012-01-17T17:02:46Z

Cmcooney: Created page with "==Unit System== ===How it works=== ===Setting Unit Preferences=== ====Preferences from General Settings==== ====Preferences from textbox context menu==== The preferred unit f…"

==Unit System==

===How it works===

===Setting Unit Preferences===

====Preferences from General Settings====

====Preferences from textbox context menu====
The preferred unit for a parameter can also be changed by right clicking on a textbox and going to "Change Unit". This will open a small window which allows changing what unit the value will be displayed in. If the value has multiple units associated with it, such as with the "Heating Value Liquid" in the picture below, then the preferred unit can be selected for each unit group. Note that changing the preferred units in this way will still change the unit of all other parameters of that unit group so in this case all "Heating Value Liquid" parameters will affected with the new unit selection.

[[File:ChangeUnitfromContext.png|thumb|right|400px|Change Unit preferences from the context menu]]

Create a Pathway

2012-01-17T16:30:11Z

Cmcooney: /* Create a Pathway */

==Create a Pathway==

In order to create a pathway in GREET.net it is necessary to know:
* What Processes are involved in the pathway, they can be either stationary or transportation processes
* What Resources, Intermediate Materials, or Energies are involved in the pathway

Once this is known we are going to check first that the database contains the necessary information for the resources and intermediate materials. If some are missing they will be added using the Resource Editor. In a second time the processes will be created. When the processes are all defined in the database the pathway can be built by assembling processes together.

===Define Resources===
''See more details for [[Resources Editor]]''

In order to link all the processes together, resources and products for each of them needs to be entered in the database. Usually we define a name and some physical properties if they apply like heating values or carbon and sulfur ratios. Those resources will be used to define the Inputs of a process and their Products. A simple example could be a coal electric plant which uses '''Coal''' as an input and produces '''Electricity'''. '''Coal''' and '''Electricity''' needs to be defined in our resources database.

Note: as the product of a process can also be used as a resource for the next process or a fuel for a vehicle. We are using the term resource for any materials or source of energy. Therefore in GREET.net '''Coal''', '''Electricity''', '''Sun''' or '''Ammonia''' will all be in the Resources Database.

===Define Processes===
''See more details for [[Process Editors]]''

In GREET two major types of processes can be defined: Stationary Processes and Transportation Processes. The database contains most of the processes used in GREET 1.8d_0, so if the necessary processes for that pathway are already in the database, there is no need to create new ones.

If you do need to create new processes which are not already in the database, you will have to use the [[Process Editors]] and make your own. Once saved they will be available for pathway building.

===Build the Pathway using the Pathway Editor===
[[File:pathway_editor.png|300px|thumb|left|Drag and dropping processes]]
Adding a pathway can be accessed from the Data Editor form by clicking on the "Pathways" menu and then on "Add Pathway" this will open the pathway editor.

As shown on the left the pathway editor is an empty sheet on which the user can drag and drop processes. The list of processes, which are located in the left column, will be updated automatically according to the current inputs/outputs of the pathway, and the places where a process can be drop are shown by green boxes on the pathway. Therefore building a pathway using existing processes is really easy, it's a matter of drag and dropping processes.

[[File:feed_placement.png|300px|thumb|right|Drag and dropping a feed]]

On the right side of the pathway editor, the feeds selection tab is shown. The different feeds available are shown on the right side after the panel has been expanded. Then as for processes it's just a matter of drag and dropping. The feed is used at the beginning of a pathway to replace a material Mix. Let's think about that case: you have a process which has as an input Bituminous Coal, but this Bituminous Coal might come from different pathways. Instead of drawing those different pathways again and again, we are going to replace them with a Feed box, which is a Mix of the results from those pathways.

When an issue is detected after a process has been dropped a message appears at the top of the pathway editor. In the case of the screenshot on the right, we dropped a process which have inputs from previous, but in the current pathway there is nothing before that process. So to solve this conflict we can either drop a process before, which have for output Bituminous Coal in this example, or drop a "feed" which represent a material Source. In this case the material Source contains a single pathway to create bituminous coal, we are using this to feed out process.

Then to save the process, a name is required. The Hidden option will hide or not this pathway from the GUI, this option can be used for some legacy pathways that we still want to be in the database but not shown to not overwhelm the GUI. The ID is what will be used internally to refer to this pathway, therefore this number is automatically generated by the GUI. Notes can be used to give some indications about the pathway and are saved in the database.

==Internal Links==
* [[How_to|How to]]

Quick start guide

2011-12-06T18:31:23Z

Cmcooney: /* Gasoline Production - Well to Wheels */

=How to Install and Run GREET=

==Running GREET==

To run GREET simply run the GREET executable file from a file browser or a shortcut. Running the executable will open the program and allow loading GREET project files. To gain easier access right click the executable and go to send to and then select Desktop (create shortcut).

==Selecting Working Folder==

The processing and data files are separated to allow easily loading and saving multiple project files. After running GREET for the first time you will be asked to select the folder where these data files are stored.

[[File:SelectFoldersMsg.png|thumb|300px|left|Select folders message]]

[[File:SelectFolders.png|thumb|250px|none|Selecting project folders]]

After selecting OK on the message a window will open for selecting the location of the data folders. Navigate to where the "Pictures","Log", and "Data" folders are on your system and select the folder directly above these folders then select OK. The program will load the data files and display the graphical user interface (GUI).

==Copying/Moving Data Folders==

To copy the data folders to a new directory select copy on the directory containing the "Data", "Log", and "Pictures" folders and paste it to a new location. This allows customizing where on the computer the program/data is stored.

=Using the GUI=

The GUI separates the key points of setting parameters and viewing results into various controls accessible through the buttons at the top of the main GUI window.

[[File:StepsBarWithPictures.png|thumb|700px|center]]

This image shows the main navigation of the program. Each of the main views can be selected by clicking one of the large buttons on the step bar. In the toolbar the "File" dropdown exposes options for loading and saving GREET projects. The "Results" dropdown shows options for manually recalculating the results and monitoring values. From the "Preferences" dropdown the preferences window can be shown and the table editor can be opened. From the "About" dropdown database information can be viewed, the software can be updated, and the help pages can be opened.

==Preferences==

The main preference pages are the unit and calculation preferences accessible through their associated tabs within the preference window. The unit page, visible below, allows selecting desired units for various groups. Changing the value in the User defined column will cause values of that unit group to be displayed with the selected unit. If a group is made up of multiple units groups then the units can be changed within each group. An example of this is the first unit in the image below where Energy Intensity is composed of Energy over Distance over Mass.

[[File:PreferencesUnits.png|thumb|300px|left]]
[[File:PreferencesCalculations.png|thumb|310px|none]]

The calculations tab provides various options for controlling how the calculations are executed and displayed. The "Running Options" group of options allows changing calculation parameters such as the maximum iterations to run for calculating upstream values.

==Main views==

[[File:StepsBar.png|thumb|700px|center]]

This image shows the main views, mousing over a button will display the text as shown or displaying the images can be disabled from the preferences.

===Basic Parameter Setup===

This control allows modifying many of the simulation parameters within various tables such as which year to simulate. The tables have a title explaining more about what the table is used for and the cells display the various values. A light blue cell indicates that the value comes from a formula referencing other table values which can be viewed or modified by right clicking and selecting "Edit Formula". Each value stores a default number and an current number which can be swapped by selecting "Switch to default value" and "Switch to user value" from the right click menu. This allows making changes and easily returning to a default value. For most cells the value has an associated unit which can be modified from the right click menu by selecting "Change Unit" and then selecting the desired units.

[[File:BasicParameterSetup.png|thumb|none|500px|The Basic Parameter Setup Control]]

===Well to Pump Setup===

This allows viewing and modifying parameters specific to processes as well as pathways.
====Pathway Selection====
The tree selection in the top left allows selecting a pathway which are organized into light duty vehicle (LDV) fuels, feedstocks, and others. Fuels that make up a family of actual fuels are denoted by a lighter teal color such as Diesel and Gasoline which have multiple fuels under those names. Under each fuel are mixes which represent a particular blend of fuels. Under each mix is one or more pathways which output a fuel that goes into the mix and next to it is the share that the fuel contributes to the mix.

====Pathway Representation====
The large panel on the right with boxes is a graphical representation of the selected pathway. If the pathway has a fuel that feeds into it then the feed panel will be on the left denoted by a light orange background. After the calculations have been run this panel displays a summary of energy and emissions for the feed mix when the mouse is moved over it. Clicking the title link will display the feed pathway and the back button on the pathway selection control allows returning to the previous pathway.

To the right of the feed are the processes with Stationary Processes showing with a light blue background and Transportation Processes with a pink background. Double clicking a Stationary Process expands the process to display the process fuels consumed in the process and if a fuel has technologies associated with it then it can be expanded to view the technologies. Double clicking a transportation process expands the process to display a graphical representation of the locations and modes that represent the transporting of the material to the destination. Double upward arrows next to a process represent a loss (leakage or boil-off) which can be displayed by clicking the arrows. Various parameters can be set for each process and the titles in blue can be used to open a window with more parameters for that object.

====Property Display====
The bottom left control displays properties for the selected object in the pathway representation. The pathway summary can also be display by clicking the "Switch to pathway" button. The emissions section displays how much of each gas emission is released and is also broke down intro all included and partial upstream. The emissions are also displayed in the groups criteria pollutants, emission gases, from combustion, and greenhouse gases. The energy is also broke down into upstream included and partial upstream as well as displaying energy per process fuel. The energy is also grouped into fossil, petroleum, natural gas, coal, non fossil, nuclear, and renewable fuels. If a loss is as is associated with the selected process then it will display in the losses section.

[[File:WellToPumpSetup.png|thumb|none|700px|The Well to Pump Setup control]]

===Well to Pump Results===
The well to pump results allow viewing and comparing the energy usage and emission results for each of the pathways in each of the mixes for a LDV fuel.

[[File:WellToPumpResultsTabular.png|thumb|none|700px|Well to pump results in table format]]

The tabular version of the results displays the energy usage and emissions for each pathway as well as the weighted average of the values based on the share of each pathway. The pathways that are displayed depends on what is selected on the left material selection control. If the resulting material is selected then each pathway within each mix is displayed on the right as well as the weighted results for the mix. The column header represents this by starting with either "PATH" for pathway results or "SRC" for the mix results. Selecting a single pathway will display the energy used and emissions for each process within the pathway each denoted by "PROC" in the result table. The results can be exported by right clicking and selecting "Copy to Clipboard" or "Save to XML File". Once copied the results can either be pasted into Excel or a text editor.

[[File:WellToPumpResultsGraphical.png|thumb|none|700px|Well to pump results in graphical format]]

The graphical format of the results allows seeing the pathways as they feed into a mix of the resulting LDV fuel. Each of the pathways display on the left of the graphic with their name and share amount as well as the emissions displayed on the left of the panel and the energy displayed on the right. The source box then shows the weighted mix results from combining the output of the pathways.

===Pump to Wheels Setup===

This control allows setting assumptions for vehicles to be used in the well to wheels simulation. The vehicles or sorted by the LDV fuel that they run on and can be selected from the list on the left. The parameters for that vehicle will display on the right.

[[File:PumpToWheelsSetup.png|thumb|none|700px|Vehicle Setup Control]]

A "normal" or "cs" vehicle displays parameters for a combustion engine vehicle as shown above. Many of the vehicles' parameters are based on a baseline vehicle in which case the "% of baseline" columns will be active and changes to values in emissions or miles per gallon will adjust the % of the baseline according for that parameter.

[[File:PumpToWheelsSetupCD.png|thumb|none|400px|CD parameters for hybrid electric vehicles]]

The "cd" control displays options for plug-in hybrid electric vehicles (PHEV). The primary attributes for PHEVs are the electric range, fuel consumption, electricity consumption, charging efficiency, and the source mix for electricity.

===Well to Wheels Results===

[[File:WellToWheelsResults.png|thumb|none|700px|Well to Wheels Results Control]]

===Data Editor===
[[File:DataEditorSelection.png|thumb|none|700px]]

The controls in the data editor allow direct access to the data stored within the model including the pathways, processes, resources, and more. Many of the controls are linked to from other places such as clicking the name of a process within the well to pump setup and the resulting process editor being opened in a new window.

For detailed information on any of the controls see the Full User Manual under Data Editor

[https://wiki.inside.anl.gov/greet/Full_User_Manual#Data_Editors User Manual - Data Editors]

=Example study=
==Gasoline Production - Well to Wheels==
This part of the guide will run through carrying out a simulation for production of gasoline and combustion in a gasoline car.

First start with the "Basic Parameter Setup" and look through the simulation parameters for tables related to conventional gasoline as well as general parameters. This simulation will use the default simulation year of 2010 which is in the "single parameters" tab. Next look through the "Materials Calculated Parameters" tab for Conventional Gasoline which shows assumptions about the fuel. If you have different assumptions for the density or heating value they could be inputted here. Also note the "Other Options" section to the left of the tables as this option determines whether the lower heating value or upper healing value is used for calculations.

[[File:CalculatedFuelSpecifications.png|thumb|400px|none]]

The "Transportation Calculated Parameters" table can be used to set parameters for the modes of transportation for the fuel such as average speed and load factor of an ocean tanker carrying crude oil. Additional mode options can be accessed from the data editor under "Edit Modes".

[[File:TransportationModeOptions.png|thumb|600px|none]]

Moving to the well to pump setup control from the top navigation bar, the Gasoline mixes are found under the "Gasoline" group in the pathway selection. Navigating down to a mix under "Conventional Gasoline" it shows that there is currently one mix stored called "From Crude Oil Mix" and selecting it displays the pathway.

By hovering the mouse of the Feed box, which is tan colored, the energy and emission results for the feed mix pathways are displayed in a drop down summary of the pathways. Clicking the feed name redirects this control to the first feed pathway and selects displays the mix in the pathway selection. Doing this for this CG feed there are three pathways in the mix that feeds into the "From Crude Oil Mix", those being conventional crude oil at 90.6%, crude oil from oil sands at 4.7%, and crude oil from surface mining at 4.7%. The shares show how much weight each pathway has on the results for that mix.

Clicking the back button brings me back to the CG pathway where three processes are visible. The stationary processes, the light blue ones, can be expanded by double clicking in order to set parameters for the process fuels and their technologies.

[[File:WellToPumpSetupCG.png|thumb|700px|none]]

Expanding a transportation process, the pink colored processes, displays the transportation breakdown for the fuel. The starting locations where the conventional gasoline is being moved from are displayed at the far left followed by a series of transportation modes for representing how the resource will be moved. The distance can be set for the estimated distance that mode will travel, the share specifies how much of the total transported material will be moved using that mode, and clicking the mode name link will open a form for setting other parameters such as fuel shares and energy intensities.

[[File:CGTransportation.png|thumb|600px|none]]

At the bottom left the results for various objects can be displayed. Simply select a process, input under a process, or transportation step to view the emissions and energy used for that object. The "Switch to Pathway" button can be used to go back to the pathway results.

[[File:CGPathwayResults.png|thumb|200px|none]]

Moving to the "Well to Pump Results" page shows the cumulative emissions and energy used for the Crude oil mix to conventional gasoline pathway as well as the mix results for conventional gasoline (the same since there is only one pathway. The results can also be displayed and exported from the table view tab.

[[File:WellToPumpResultsCG.png|thumb|700px|none]]

The "Pump to Wheels Setup" page allows setting up parameters for the vehicle that will be consuming the LDV resource in the simulation. The gasoline car includes parameters for the fuel economy, emissions, and the LDV fuel mixes to use. This vehicle is considered a baseline vehicle, that being other vehicles base their assumptions as a percent of this vehicle's values, so the up/down and share controls are disabled.

[[File:PumpToWheelsSetupCG.png|thumb|700px|none]]