Feedstocks

The Feedstocks page is used to manage the feedstocks available in AVEVA Unified Supply Chain. A feedstock is a material that can be used by the process unit models in AVEVA Unified Supply Chain as a feed material. Feedstocks are often crude oils, but may also be products or other imported materials such as reformate or atmospheric residue.

Feedstock are identified by a unique Reference. They belong to a Type (Crude, Import or Gas) and to a Traded Material.

Many feedstocks, such as crude oils, may have their properties defined externally in other applications such as Assay. However, you can define in AVEVA Unified Supply Chain any materials not natively managed by such applications. When defining a feedstock such as this, you can use the feedstocks page to associate the feedstock with a traded material, and to edit the properties that are typically required for that feedstock.

Example: Natural gas is not managed by Assay, but is required by AVEVA Unified Supply Chain models as a fuel for hydrogen plants. The models used for the Hydrogen Make Units (HMU) typically use the calorific value of the natural gas to calculate the hydrogen production. Therefore, the Feedstock Editor is used to associate this required property value to the feedstock in order for the material to be used to drive the HMU models.

Consider how you want a feedstock to be used in the future. Feedstocks created in the global reference data are available to all users with permission and can be re-used in various models. Therefore global feedstocks are useful to represent materials with fairly constant qualities that are used by many people.

Example: If you import ethanol for blending at several sites, the quality of this is probably fairly constantly defined and may be used at several locations. Therefore a global feedstock is useful.
In contrast, an inventory of FCC feed will change from month to month within a single plant, and across two plants the qualities will be different. Therefore, this feedstock is best defined within each relevant plant model itself (Feedstock Properties).

Manage feedstocks

To add a new import:

1. On the Feedstocks tab, do either of the following:

   • Click Add Import in the Feedstocks group of the Home ribbon tab.

   • Right-click anywhere on the table and choose Add Import from the context menu.

2. Double-click the appropriate cell to enter the import Name and Reference.

3. Use the drop-down menus to select a Traded Material to associate with the import, or choose to create a new one. This drop-down list is fully searchable. For tips on the best way to use search functionality, see Advanced Grids.

4. Use the drop-down menu to select a Share where to publish the import.

5. If required, configure the import Properties: select the imports you want to configure by holding down the Ctrl key as you click on each one. Once selected, right-click and choose Goto Properties from the context menu. This opens the Properties tab, where you can add the properties you require for your new imports. Only cells with a white background are editable.

   

To add a new gas feedstock:

6. On the Feedstocks tab, do either of the following:

   • Click Add Gas in the Feedstocks group of the Home ribbon tab.

   • Right-click anywhere on the table and choose Add Gas from the context menu.

7. Double-click the appropriate cell to enter the gas Name and Reference.

8. Use the drop-down menus to select a Traded Material to associate with the gas, or choose to create a new one. This drop-down list is fully searchable. For tips on the best way to use search functionality, see Advanced Grids.

9. Use the drop-down menu to select a Share where to publish the gas.

10. Configure the gas composition in the Gas Feedstock Composition tab, described later in this topic.

To edit a feedstock, you must have the right permissions. These are listed in the Permission column. If your permission is Read Only, you can view the feedstock and use it in your cases, but without modifying it. If your permission is Editable, you can also modify the feedstock by double clicking and using the drop-down menus in the appropriate cells, and by editing the Properties, as described above.

To delete one or more feedstocks (only if the feedstock Permission is set to Editable):

11. Select the feedstocks you want to delete.

12. Do either of the following:

    • Click Delete Feedstock in the Feedstocks group of the Home ribbon tab.

    • Right click on the selected feedstocks and choose Delete Feedstocks from the context menu.

Undo pending changes

You can undo changes you have made on the Feedstocks page, but have yet to commit to the server. You will know a change has been made because:

• The database icon on the far left will have a red tick over it when a change has been made in that row. It will remain there until you have committed these changes.

• The cell that has changed will turn into bold font, until it is committed.

• If a value was set, and then cleared or deleted, <Value Cleared> is displayed in its place.

To undo your changes, right click on the cell in question, and select the Undo Change option. This will revert the cell to its original value.

Define gas composition

In the Gas Feedstock Composition tab you can define the components of each gas feedstock and their proportions.

Unlike feedstocks of type Import (for which you define properties in the Properties tab), properties for Gas type feedstocks are calculated and updated automatically based on the composition.

Each column to the right of UoM corresponds to one of the gas feedstocks in the Feedstocks tab.

To define compositions for your gas feedstocks you first have to add one or more components to the table:

13. Click Add Components in the Feedstocks group of the Home ribbon tab. The Add Components dialog opens. This dialog contains a list of the fixed materials in the shares you have access to.

    

14. Select each component you want to add to the table. Type in the Search text box to filter the list.

15. Click Close. The selected components are added as rows to the table.

Once you have added the necessary components, enter their proportions for each gas feedstock in the corresponding columns. If you leave a proportion cell empty, this is treated as zero.

Click Show Properties in the Feedstocks group of the Home ribbon tab to show or hide the properties of each gas feedstock, below their compositions.

Manage properties

The Properties tab of the Feedstocks page shows the available feedstocks you can import into an AVEVA Unified Supply Chain model, and the properties of these feedstocks. By default the available feedstocks are shown as columns in the grid, and the different associated properties are shown as rows in the grid.

You can filter the list of properties and feedstocks by typing in the Properties and Feedstocks fields at the top of the table, respectively.

To add a property:

16. Do either of the following:

    • Click Add Property in the Feedstocks group of the Home ribbon tab.

    • Right click anywhere in the table and choose Add Property from the context menu.

17. In the Add Feedstock Property dialog, choose a property from the list and its associated unit of measure.

18. Click OK.

To delete one or more properties:

19. Select the properties you want to delete.

20. Do either of the following:

    • Click Delete Property in the Feedstocks group of the Home ribbon tab.

    • Right click on the selected properties and choose Delete Property from the context menu.

21. Click Yes in the confirmation dialog.