Getting started

Getting started with ChETL

What to read first, how the website and the platform differ, how to find a topic, how to run and read your first calculation, and answers to common questions.

The website and the platform

ChETL has two parts:

chetl.org, this website
Public explanations: the screenshot tour, the course map and module guides, the P–xy worked example, and pages about the project. No account is needed, and nothing is calculated here.
app.chetl.org, the learning platform
Where calculations run, with Theory, Blackboard, Plot, Interpretation, AI Tutor, Assessment and Data for each topic. Every “Launch ChETL” button leads there.

If you want to see the approach before signing in, read the tour or the worked example first. Both show real platform output.

Signing in

Choose Launch ChETL. Sign-in is handled entirely inside the platform, on its own sign-in page; this website never asks for account details. The AI Tutor is available only to signed-in users.

This website does not publish pricing, licensing or institutional-access terms. For course or departmental use, write to the project.

Your first calculation

  1. Open a topic and read the Theory. At least skim the solution strategy, which shows the decisions the calculation will make.
  2. Set the problem in the configuration panel. Choose the component or components, the state, the model and any range for the plot.
  3. Press Calculate. One engine produces the result, and every tab then describes that same calculation. Editing an input does not change the results until you calculate again.
  4. Work through the tabs. Follow the Blackboard, look at the plot, read the Interpretation, then ask the Tutor or try the Assessment.
  5. Change one input and calculate again. Compare what moved and what did not.

A good first exercise is to reproduce the published worked example. Open Phase Equilibrium › P–xy and set ETHANOL and WATER, Modified Raoult, NRTL, Library parameters, target Bubble, 343.15 K and x1 = 0.5. Your Blackboard should match the one in the worked example.

Reading results, warnings and unavailable states

  • Blackboard: the problem, the knowns with their sources, the unknown, the assumptions, then numbered steps of formula, substitution and result, ending with a boxed result and units. Rounded displayed values come from the full engine value.
  • Plot and Data: the same calculation over a range, with the configured state marked. Data rows are the plotted grid points, so the configured value is not necessarily one of them.
  • Interpretation: starts by restating what was calculated and ends with the model’s validity and limitations. Cautions appear, for example, when a correlation is used outside its reported range.
  • Unavailable results: when a model lacks data for a component, a requested phase does not exist at that state, or an iteration does not converge, the platform says so and explains why. It does not substitute another model or show an invented value. A single-phase flash result, by contrast, is a valid answer, not an error.

Printing and exporting

  • Blackboard: a populated Blackboard has a Print Blackboard control that downloads a PDF of the same steps.
  • Data: the sweep table can be copied or exported to CSV or Excel.
  • Website pages: the worked example and these guides print from the browser; the worked example prints with every step shown.

Getting help

  • Concepts: the topic’s Theory and the module guides.
  • Questions about your case: the AI Tutor answers short questions in the context of your calculation, within a daily allowance. Check important conclusions against the Theory and the results.
  • Errors and feedback: email info@chetl.org with the page or topic, the step and what looks wrong; see Contact.

Frequently asked questions

What does ChETL cover today?

Chemical Engineering Thermodynamics is the first course. Pure Component Properties, Solution Thermodynamics, Phase Equilibrium, Chemical Equilibrium and Thermodynamic Processes are available; Thermodynamic Cycles is upcoming. Other chemical engineering courses are placeholders for intended direction, not current work. See the course map and Development status.

Who is it for?

Students learning chemical engineering thermodynamics, educators who want transparent computation to teach with, and anyone who wants to see how a thermodynamic result is reached. It is a learning platform: its results are for study, not for equipment design or safety decisions. Educators can start with Teaching with ChETL.

Do I need an account, and what does it cost?

Reading this website needs no account. The platform at app.chetl.org handles sign-in itself. This website does not publish pricing, licensing or institutional-access terms; for course or departmental use, write to the project.

Do I need to know programming?

No. Calculations are set up by choosing components, models and conditions in a configuration panel, and the platform shows its steps.

What is the Blackboard?

The engine’s numerical working for your configured case: each value as formula, substitution and result, with units. It contains computed numbers only, with no hand-written steps and no symbolic derivation; derivations belong to the Theory. See it in the tour and the worked example.

Can I use ChETL results for design?

No. Results are model estimates for learning, valid only within their models’ assumptions and parameter ranges. Broad validation against experimental data is not claimed, and design needs codes, margins and data that a learning platform does not provide.

How far can I trust the AI Tutor?

The AI Tutor explains the case you have open, but its answers are generated dynamically, can vary and may be inaccurate. It does not produce or override the engine’s calculated values, and it has a daily question allowance. Check important conclusions against the Theory, the calculated results and cited references. More in Sources, review and limits.

Why won’t the Tutor give me a number for different conditions?

Official results come only from the calculation engine, and the Tutor is instructed not to produce new ones; any number in a reply is unofficial and may be wrong. To see a result at another temperature, composition or model, change the configuration and calculate; the Tutor can then discuss the new case.

Are the Assessment questions written by people?

Not always. Questions may be generated by AI for the topic and case, then screened by automated format and numerical checks; a curated topic-specific set is used when generation fails. Generated questions are not human-reviewed. Assessment offers Remembering, Comprehension and Application levels in Interactive Learning or Classroom Simulation mode.

Where do property data and model parameters come from?

From stored component data and correlations with named sources, and for mixture models from library, estimated or user-entered parameters, shown with their source and range on the Blackboard. The worked example shows how a case records its sources.

Why is my result “unavailable”?

The chosen model may lack data for a component, the requested phase may not exist at that state, the condition may be outside what the route can represent, or an iteration may not have converged. The platform explains which, instead of substituting another model. Try a different model, component or condition.

When will Thermodynamic Cycles or other courses be available?

No dates are published. Status labels on this website follow what is actually released in the platform; see Development status.

How do I report an error or give feedback?

Email info@chetl.org with the page or topic, the step, and what looks wrong. See Contact.

Launch ChETL