CemGEMS web app tutorial¶

Troubleshooting¶

Upgrade to v.0.7.x from earlier versions: What to do with processes¶

CemGEMS release 0.7.0 contains breaking changes in the data format of process definition document (e.g. simplified format of Span objects, new Param object list). This means that after the upgrade of web app on server, every user will have to delete and re-create all processes upon all recipes. This is easy to do in a few mouse click with each process created from an unmodified template. Slightly more work is needed to re-create processes that have been cloned and customized by the user.

If you have cloned, modified and set up your own process definitions then first make sure for each relevant one that you have all the key information (hydration model parameters, span targets and intervals, time intervals) available in your records as screenshots, in a text file or in a spreadsheet.

Proceed in steps as follows:

(i) log out and log in (to refresh the templates);
(ii) choose each your recipe, click "Equilibrate" button;
(iii) for each process: delete it; re-create under the same choice of templates and name; click "Simulate process" button to run and plot.
Skip the following steps if you have not modified this process definition relative its parent process (if cloned) or to the template provided in CemGEMS.
(vi) modify the process according to your records (but using the convenient new Process Setup Table); clone before modification, if necessary.
(v) click "Simulate process" button to run and plot.

How to clean your web browser storage¶

If you would like to be sure that your user profile is clean (e.g. after testing CemGEMS web app version earlier than 0.4.0), or want to download an exact mirror of your user profile in your browser, proceed as described below. Your existing recipes, processes and plots will not be affected and will be re-loaded from your user profile in the remote server database.

In your web browser, please navigate to https://cemgems.app web page and, if you were logged in, then log out from the CemGEMS web app. Further actions depend on the type of browser that you use.

Chrome:¶

Right-click on the browser window background and select "Inspect" from the appearing menu.
In the appearing Inspector widget, in the upper horizontal menu, find "Application" (widen the widget, if needed), and click on it.
In the appearing menu on the left side, find and click "Storage"; then click on the appearing button "Clear site data".
Close the "Inspect" widget, re-load the page, and login to CemGEMS web app again.

Edge (new, on Windows10):¶

Right-click on the browser window background and select "Inspect" from the appearing menu.
In the appearing Inspector widget, in the upper horizontal menu, find "Application" (widen the widget, if needed), and click on it.
In the appearing menu on the left side, find and click "Storage"; then click on the appearing button "Clear site data".
Close the "Inspect" widget, re-load the page, and login to CemGEMS web app again.

Opera:¶

Right-click on the browser window background and select "Inspect".
In the appearing widget, in the upper horizontal menu, find "Application" (widen the widget if needed), and click on it.
In the appearing menu to the left, find "Clear Storage", and click on a button "Clear site data".
Close the "Inspect" widget, re-load the page, and login to CemGEMS web app again.

Firefox:¶

Pressing a combination of three keys: "Ctrl/Cmd + Shift (Alt) + Delete" on Linux,Win/macOS, respectively, to open "Clear Recent History" widget.
Select a checkbox to clear "Offline Website Data" in the widget shown below.
Click "OK"; close the "Clear Recent History" widget.
Close the "Inspect Element" widget, re-load the page, and login to CemGEMS web app again.

Safari (on MacOS):¶

Select "Preferences" from the Safari menu or hold down the Command key and the comma key at the same time (Command+,).
Go to the Privacy tab and click on "Manage Website Data...".
In the appearing list, find "cemgems.app", select it, and click on the "Remove" button below and then "Done".
Close the Preferences widget, re-load the page, and login to CemGEMS web app again.

What to do if "Equilibrate Recipe" action fails¶

Expand the Input Recipe part and revert the latest changes, then explore how to augment them reasonably, then click "Equilibrate Recipe" to test.

One possible reason may be that some phases have been blocked from equilibration in Phase Aliases table (expert view). If that was the case, allow these phase(s) and try equilibration again.

Some cement recipes require higher W/B ratios than others. Increase W/B ratio and try equilibration again.

What to do if "Simulate Process" action fails¶

Upon GEMS failure during the simulation of a new process, the new process document will be available for editing using jsoneditor, which allows an expert user to fix it and to run the process completely.

If an existing process (that previously ran o.k.) fails then the reason may be in the latest changes in the parent recipe. Revert these changes and test the recipe equilibration as described above. Note that the process simulation may still fail even after the parent recipe equilibrates o.k.

Sometimes, especially for blended cements, the process simulation fails because of inappropriate start or stop value in one of the process spans. Open the process document in jsoneditor and try to adjust process spans so that the process runs completely.

Another reason of process failure at some step (in case of blending) may be that some SCM constituent adds too much oxidant or reductant. To explore this, make a clone of the parent recipe and change the constituent composition so that ir would be better balanced with respect to redox state. Then do the same changes in the parent recipe of the process and re-simulate the process.

TBD