Exporting a Stream to ESP

From wiki.olisystems.com
Jump to: navigation, search



The OLI Analyzers, are extremely useful in characterizing a set of chemistries and conditions. Once this analysis is complete, it is often useful to take the resultant calculation as a stream and then export it to ESP. This saves time in manually creating the stream in ESP.


We make the following assumptions:

  • You have a valid license for both the Analyzers and ESP
  • You are using Analyzers 9.1 and ESP 9.1 or later.


For this tutorial we will use a Water Analysis that we have previously created. The export process is essentially the same for all programs in that only a Stream can be exported to ESP.

Review your Analyzer file

In this example we have a Stream Analyzer file with a Water Analysis. In the following figure, we are reviewing the final reconciliation. You can select any calculation object you desire by highlighting it in the tree view.

Exporting the calculation object

You can export a calculation object such as the reconciliation above or you can export a stream. Here we are going to click the Export button

This will display a standard Microsoft Windows open dialog. Switch to the folder you in which you will save the file.

Provide a name for the ESP process input file (BIN extension). If this is a new ESP file, there will be no existing stream and you will see a dialog similar to the one below.

The default name of the ESP stream is the name of the object you are exporting with the added letters Out. You may rename the stream as necessary. Click the OK button.

The stream has been successfully exported.

Exporting to an existing ESP process file

Occasionally you will want to export the object to an existing ESP process file. Click the Export button as show above and then switch to the folder which has your process file.

Locate the file into which you will export the stream. In this example we are exporting the same reconciliation stream into the ESP process file absorber.bin.

Click the Open button. A warning will appear.

If this is what you intend to do, click Yes.

A list of stream in the current process file will be displayed.

Please do not use the same name as an existing file. One oddity of ESP is that it will not overwrite the existing name, rather it will create a copy of the name and unfortunately this copied stream will be ignored by ESP.

Enter a valid name and the click the OK button.

The following is a listing of the newly created ESP bin file.

Using the Exported Stream in ESP

A very nice feature of the Analyzers is that the chemistry model is created for you behind the scenes. In ESP, you are required to create the chemistry model. Exporting the stream to ESP will introduce species that may or may not be present in the chemistry model you wish to use.

In this example we will use the ESP stream that originally contained no existing streams.

Start ESP

You may need to switch to the folder that contains the new ESP BIN file. This can be done via the Options/Change Directories action item.

Once switched, select ESP Process and then select your process.

Select Process Build First

When exporting a stream to ESP, it is much easier to activate the exported stream via Process Build than to try to create the chemistry model initially. When ESP detects a stream that has components in it that are not in the current chemistry model, ESP will prompt you to add the missing species automatically. You will then be able to “Re-generate” the chemistry model to update the thermodynamics.

Select Process Build

Define the Chemistry Model but do not generate yet

You need to create a name for a new chemistry model. Select New Model. If you are using an existing process you can select an existing model as well.

Enter a valid name for the chemistry model. The maximum name length is 8 characters. No special characters are permitted.

Since our process had components that are not in the current model (new models only have H2O). We will be prompted to build our model dynamically. This is recommended. Select Continue

The ESP program will now ask for you to add or take no action for each species it finds in the process file that does not match the chemistry model. For a new model this will be all the species. We recommend that you select Add All

Building the ESP process

The steps here are discussed in detail in the ESP course notes as well as the ESP manuals. We will only show the basics. When starting Process Build you will be given a choice of blocks. For this example we will select Conventional Blocks

We now select Mix Blocks although you may select any block you desire.

This is the standard MIX block input screen. We recommend that you position the cursor on the first blank input screen as shown below.

Press the Enter key on a blank input field to see a list of available streams.

Select the exported stream. The current composition is displayed.

Since the chemistry model has not been generated or updated, we do not have information about molecular weight. Unit Conversion is very risky now and it is recommended that you not change units or adjust flow at this time.

Press the end key <F3> or the <END> key to save the stream. Fill out the block as normal.

Press the <F3> key to save the block.

Select Exit to temporarily leave Process Build.

Now Generate the Chemistry Model

The chemistry model previous defined is now ready to be generated and updated. Select Chemistry Model

Complete the generation steps as normal. You may now go back to the modified process block and change units and flows.