Docs › Reference

FAQ and troubleshooting

Quick answers to the problems people meet most often. If yours is not here, email hello@codeboxglobals.com.

Installing

Android says the install is blocked

Zalosim comes from the website, not an app store, so Android asks you to allow your browser (or Files app) to install unknown apps. Tap Settings in the message, switch the permission on for that app, go back and open the downloaded file again. See Download and install.

The app will not install or will not open on an older phone

Zalosim needs Android 7 or later. On older or low-cost phones, try the older phones download link under the main download button on zalosim.com.

An update will not install over the old version

Some early test copies were signed differently from the released app. If Android refuses to install over one, back up your cases first (see Cloud backup), uninstall the old copy, then install the new one. Uninstalling deletes cases stored on the device.

Activation

The 6-digit code has not arrived

  • Wait a minute and check your spam or junk folder. The email comes from no-reply@zalosim.com with the subject "Your Zalosim code".
  • Check that the email address on the Activate screen is spelt correctly. Change email or key takes you back to fix it.
  • Tap Send a new code. Each new code cancels the previous one, and codes last 10 minutes.
  • After 5 codes in an hour you will see Too many codes sent to this email. Wait an hour and try again.
  • Some university mail servers are slow. If codes never arrive at your school address, ask whether you can use another address (on an individual licence the email must match the key).

"That key is not valid"

Check the key against your licence email. Spaces, dashes and capitals do not matter, but every character must be there. If it still fails, ask whoever issued it.

"All N devices for this key are in use"

Every seat on the key is taken. Ask your institution's administrator to free a seat or add seats. On an individual licence (2 devices), release one of your devices first: ⋯ › About › Release this device. If the device is lost, contact us.

"This key belongs to …"

Individual keys only work with the email they were issued to. Use that address.

"This licence expired" or "This licence is suspended"

A new device cannot be activated on an expired or suspended key. Ask for a renewal, or contact us.

"No internet connection"

Activation, releasing a device and cloud backup need the internet. Everything else works offline.

Licence and clock

A banner says "Your device date is wrong"

The device's date is more than a day behind. Set the correct date and time in Android's settings (automatic date and time is easiest). Changing the clock never extends a licence.

The solver bar says "Read-only: licence expired"

The licence has passed its 7-day grace period. You can still open cases and export reports. Tap Request renewal on the banner, then let the device go online so it picks up the renewal. See Expiry, grace and read-only.

The app went back to the Activate screen

The device was removed from the licence (released here or by an administrator). Activate again with the key and your email. Your saved cases are still on the device.

Cases that will not solve

Where do I start?

  1. Read the solver bar. It names the first operation that is not solved and why.
  2. Look for amber or red objects on the PFD, or amber and red dots in the navigator pane, and open the first one upstream.
  3. Read its status strip. Messages such as Unknown Delta P or feed stream 1: Unknown Flow say exactly what is missing.

A feed stream stays amber

It needs a composition, a flow and two state variables (see Specifying a feed stream). Red Over-specified means you gave too many of T, P, VF, H and S: clear one.

An operation says "Unknown Delta P" or "Unknown Duty"

Give it its one specification: an outlet pressure for a valve, pump or compressor; an outlet temperature, vapour fraction, duty or Delta T for a heater or cooler. Outlet conditions can be typed on the outlet stream.

The 3-phase separator warns about the water phase

Tick Liquid-liquid split (full VLLE) on the fluid package's StabTest tab, in the Properties environment.

A loop does not converge

  • Give the Recycle outlet (the tear stream) a realistic estimate of composition, flow, temperature and pressure.
  • Open the Messages pane on the solver bar to see what the solver tried.
  • Check for a temperature cross in heat exchangers: a Delta Temp or minimum approach specification is usually easier to meet than an outlet temperature.

An Adjust does not converge

Start the adjusted variable near the answer, set a sensible minimum and maximum, and check that the target can be reached at all. Make sure the solver is active (not holding).

A column does not converge

Check the Degrees of Freedom on the Monitor page is 0, add top and bottom temperature estimates, try a different pair of active specifications, or tap Reset and Run to start cold.

Nothing recalculates

The solver may be on hold: the solver bar says Holding. Press the green Go button or F8.

Screen and controls

I cannot find the palette

Tap the Object palette button (square with a plus) in the PFD toolbar. On a phone, picking an object closes the palette so you can tap where it goes; open it again for the next object. The palette's own × closes it.

Where are the top bar and Save button on my phone?

In the Simulation environment they are hidden to give the PFD more room. Tap the double-arrow toggle at the top left to show them.

The screen does not rotate

Zalosim turns with the device in landscape and upright portrait (tablets also upside down). If it stays put, check that auto-rotate is on in Android's quick settings.

Report (PDF) is missing from the menu

It appears once the case has components and a fluid package.

Numbers are in the wrong units

Tap the unit set button at the top right and choose another set. You can also type a value in any unit with the keypad's unit row.

I lost my work when the app closed

Restart Zalosim: it offers to recover the autosaved case. Save regularly, and back up important cases to the cloud.