VLizard documentation

User manual

Welcome to the user manual for VLizard, a VLE wizard. ๐Ÿง™โ€โ™‚๏ธโš—๐ŸฆŽ

This document will quickly guide you through the process of using VLizard app for processing VLE data.
Both isobaric and isothermal VLE data are supported, though some features are only for isobaric data.
It does not cover all advanced features, but should be enough to get you started.
Please refer to other pages for advice on tests of thermodynamic consistency.

Content

  1. First navigation
  2. Adding Pure compounds
  3. Adding VLE dataset
  4. Fitting thermodynamic models
  5. Other features
  6. Troubleshooting

First navigation

After opening the app, you should see the welcome page, and most importantly, the navigation top bar:

top bar

The (?) icon will lead to this manual. But let's start by visiting the Pure compounds page.

Adding Pure compounds

Having a vapor pressure model available for each pure compound is a prerequisite for any kind of VLE data processing.

If you have just freshly installed VLizard, there are example data from literature for ethanol & water.
So click the "Perform analysis" icon: analysis icon

A dialog appears with visualization of the vapor pressure model.
๐Ÿ’ก Any plot can be saved as vectorized svg image to your computer.

Try editing a model via the pencil icon.
๐Ÿ’ก This is fullscreen dialog, it can be closed only via buttons, not Escape key, so you don't accidentally lose progress.

You may also "Add a new model" at the top of the page, and fill the dialog similarly โ€“ enter the model parameters that you have available. Or, if you have experimental data for vapor pressure, you can "Perform fitting" โ€“ paste your data into the table and click "Optimize".

Don't worry about the temperature range, it's only informative โ€“ calculations will warn you when you extrapolate too much, but won't fail.
๐Ÿ‘‰ After adding a model, it is recommended to do an perform analysis to sanity check it.

Of course, any model can be deleted. Let us now proceed to visit the Binary systems page.

Adding VLE dataset

All binary systems are listed here. Each system can have multiple datasets, and you can fold/expand them using arrows.

Look at one of the example datasets:
Icon edit table icon lets you edit the VLE data.
Icon visualize icon visualizes your data.
Icon analysis icon is most important โ€“ it opens a menu with a wide range of analyses.

The analyses include visualization (same as above) and all the tests of thermodynamic consistency.
The help button leads to overview of tests so you can learn more about them.

Now you may enter your experimental VLE data, be it isobaric or isothermal.
Either "Add new" binary system, or you may add a dataset directly to an existing system via new table icon
๐Ÿ’ก Is your table in a different format? No problem, just rearrange the column headers and pick your units of measure.

Now you may perform analysis for your VLE data โ€“ the most important feature!

Fitting thermodynamic models

The only remaining feature to be described is the Fitting page. You may skip this if you do not need to fit your VLE data with a thermodynamic model. Note that it is required to perform the van Ness test of thermodynamic consistency.

This page lists your binary systems, but there are no fitted models yet, so add one via new table icon
A dialog appears:

๐Ÿ’ก Mark all parameters as constant if you wish to just input the final model parameters from elsewhere.

After a successful fitting, you shall see the model persisted in the list.
Icon visualize icon to display fitting again (tabulates model through original data).
Icon analysis icon to tabulate the model at arbitrary pressure.

Other features

There are some icons in the top bar we have not covered yet:

Note: the local data files are stored at following directories:

Troubleshooting

Having problems? Here are some general steps you can try.
If nothing helps, please report the bug ๐Ÿ› using this contact.

In any case, please keep in mind this a free open-source project. I am doing my best to make it functional and user-friendly, but it may not always be perfect. Thank you for your understanding!