Professional Documents
Culture Documents
eve
the bioprocess platform software
User Guide
eve® – 2021 H2
Bioprocess software
Version 1.123
info@infors-ht.com
eveSupport@infors-ht.com
TABLE OF CONTENTS
Table of Contents
1 Getting Started 6
1.3 Login 8
2.2 Buttons 14
3 DASHBOARD 17
6 LIBRARIES 108
7 RESOURCES 159
8 SETTINGS 182
9 Contact 211
10 Glossary 212
1 Getting Started
eve® the bioprocess platform software is able to do more than just planning, controlling and analysing your biopro-
cesses. eve® integrates workflows, devices, bioprocess information and big data in a web-based platform that lets
you organise your projects - no matter how complex they are.
eve® integrates complex control strategies based on soft-sensors and phase transition techniques and makes it
accessible to non-expert users via a modern intuitive workflow. Online and offline data are seamlessly integrated
for comparison and graphical analysis in real time.
eve® is the platform for big data in bioprocesses. It uses cutting-edge NoSQL technology instead of traditional SQL.
eve® catapults your bioprocesses into the world of big data, making bioprocess information centralised, unlimited
and fast.
eve® embraces incubation shakers and bioreactors of all sizes and types and allows to connect and manage your
lab resources in an easy way.
License Structure
eve® has a modular structure and permits that only required capabilities need to be specified and each user can
build a tailored set of functionality to meet their precise needs. The basic software can be expanded with additional
licenses.
License Functions
Solution suitable for work in the validated environment according to FDA 21 CFR Part 11. The
premium license contains additional safety features as well as validation documents for the soft-
ware.
eve®
Automatic log-off
Premium High security password
Password aging
User lockout after failed log-ins
Declaration of conformity, IQ protocols and functional specification
The following sections should help you to get familiar with the conventions used in this document.
To highlight warnings, important information or application examples, they are presented as follows:
This symbol indicates a hazardous situation which could result in malfunction of the software and/or
data loss.
This symbol indicates a simple application example for a function or setting in the software and indic-
ates an easy solution for a specific demand.
Text conventions
The following designations are used to indicate instructions, results and elements on the user interface:
Active (clickable) elements on the user interface of the software (e.g. buttons or tabs) are shown in bold
letters.
Passive (not clickable) elements on the user interface (e.g. menu titles) are shown in italic letters.
Actions to be carried out are indicated with a numbered list (1. 2. 3.).
Results of actions are indicated with an arrow ( ).
Images
All images showing the various menus, dialogue boxes and pages of eve® the bioprocess platform software reflect
the view of a user with the user role Manager with Premium software license. Please note that the images aid gen-
eral understanding. Due to potential changes in the software, these may differ from the actual graphical user inter-
face.
1.3 Login
After a successful installation of eve® the software can be started as follows:
The default web browser of your operating system starts and the eve® login screen appears. For inform-
ation regarding the supported web browsers, refer to the installation guide (see "Installation Guide" on
page 218).
Username: Administrator
Password: Administrator
Note that administrators are only allowed to manage the equipment and user accounts (see "User
Administration" on page 176). Full feature access is exclusively activated for users with a role as a
Manager or User.
It is possible to log out at any time by clicking the icon on the top right. After logging out, the login screen
appears, where you can log in anew if required. If you close the browser window, you will be logged out as well.
Session timeout
If automatic user log-off is activated in the global settings (see "Automatic User Log-Off" on page 192), the session
will automatically expire after a defined waiting period. This means that you are automatically logged out if you are
not performing any interaction via keyboard or mouse during the waiting period. Please note that all data that
have not been saved will be lost when you are logged out.
Session timeouts will be announced 10 seconds in advance. After the session has been expired, the login screen
appears and you can log in anew if required.
It is not possible to update a release 2020 Q1 or older directly to a release newer than 2020 Q2 R1. In this
case, you first have to update eve® to 2020 Q2 R1 and then from 2020 Q2 R1 to the desired release newer
than 2020 Q2 R1.
After performing an update we strongly recommend to store a backup of the database. This is necessary, as
backups created with an older software version may no longer be usable after the software update.
Backup files created with version 1.73 or later can be restored in version 2020 Q1 or older. Backup files cre-
ated with version 2020 Q1 or older cannot be restored in version 2020 Q2 or later. Therefore, after updat-
ing to version 2020 Q2, it is strongly recommended to store a new backup file.
To
Backup and Restore Data
≤ 2020 Q1 ≥ 2020 Q2
Data structure
In eve®, the batch data can be organised in experiments and projects in order to ensure easy management, doc-
umentation and traceability of the data. Batch data can be structured as follows:
Project: Projects are the top level of the structure. A project contains one or more experiments. When cre-
ating a single batch or multiple batch experiment, these can be assigned to a project. New projects can be
added in the RESOURCES section.
Experiment: An experiment contains one or more batches. When creating a single batch or multiple batch,
the experiment is automatically created and gets the same name.
Batch: A batch is an individual bioprocess configured in an experiment and assigned to a unit (e.g. vessel A
of a bioreactor). Batches can either be created individually (single batch) or in parallel using a reference
batch (multiple batch).
Device components
To be able to work with eve®, especially to manage the equipment, it is important to know how the individual
parts of a device are represented in eve®. The following table provides an overview of the various device-related
terms used in eve®.
Unit OR
External humid-
A piece of equipment that can be bound
ifier (A) bound to
to another unit. A unit can have one or
vessel A of a
more modules.
bioreactor
Workflow
eve® provides a workflow to plan and run an experiment. Basically the workflow to plan and run an experiment
from scratch consists of the following steps:
b. Define the culture media you use (optional) "Culture Media" on page 125
a. Plan a single batch experiment "Plan and Run Single Batch" on page 19
III. Define the culture media (optional) "Culture Media Information" on page 35
OR
b. Plan a multiple batch experiment "Plan and Run Multiple Batch" on page 59
Menu Functions
In the PLAN & RUN menu single and multiple batches can be
planned and started. The following functions are available:
2.2 Buttons
The following table gives an overview about the icons used in the software.
Help Expand
Export Archive
Report Unarchive
Load
The data libraries BATCHES and AUDIT TRAIL are provided with an advanced search function.
Detailed information on the search functions in these libraries can be found in the corresponding
chapter:
- "Search and Filter Batch Data" on page 110
- "Search and Filter Audit Trail" on page 154
Sort table
1. To sort a table in either ascending or descending order, click the heading of the column you want to sort by.
Filter table
Not all tables provide a filter function. If a filter function is available, the filter icon is displayed
next to the column header.
1. To filter a table by a specific entry, click the filter icon in the header.
The entries of the table are filtered according to the entered search term.
3 DASHBOARD
The dashboard is the main overview window of eve®. The widget-like tiles of running batches and planned exper-
iments support a fast and easy control and allow access to the experiments and batches. Furthermore, a list of the
most recent actions logged in the audit trail is provided.
The bar on the left side of the screen provides access to the various menus of the software. Depending on the user
rights of the logged in person, the menus are visible or hidden.
Workflow
The steps ORGANISM, CULTURE MEDIA and BATCH STRATEGY are optional. A quick start function allows you to
start the batch as soon as you have entered all mandatory information in the BASIC SETUP step. However, the
optional steps allow you to specify the batch more in detail by entering information concerning the organism to be
cultivated and the culture media used. This information can be used for documentation purposes for example. The
BATCH STRATEGY step allows you to partially or completely automate the cultivation process.
The batch including all changes made to the batch settings is automatically saved in the BATCHES library. If you
want to start or modify the batch at a later time, you can open the batch in the BATCHES library.
A navigation bar is provided to navigate between the different workflow steps. Note that at least the mandatory
information in the BASIC SETUP step must be entered so that the other workflow steps become active. The cur-
rently active step is displayed in orange in the navigation bar.
In addition to the metadata, that can be entered by default, further user-specific metadata can be
defined (see "Custom Basic Setup Metadata" on page 199).
To be able to assign a batch to a project, the project must first be created in the RESOURCES menu
(see "Projects " on page 174). If no project is selected, the batch is automatically assigned to a "no-
name" project.
For information how to create a new recipe, see "Create New Recipe" on page 120.
For information how to add a new device, see "Add New Device" on page 161.
3. Select any free device to continue with the configuration of the batch.
If you simply want to plan an experiment, it is also possible to select a device which is not con-
nected or in use. However, to start a batch, the device must be free.
4. Click OK at the bottom of the CHANGE DEVICE pop-up screen to save your settings and get back to the
BASIC SETUP screen.
If a recipe with an old device name was imported and assigned to a batch, the device must be
reselected. In this case, the message RESELECT DEVICE is shown.
Device parameter Parameter present on the device (e.g. temperature, pO2 etc.).
Parameter whose value is delivered by a device that is not connected to the software.
Offline parameter
The value is therefore entered manually by the user (e.g. when taking an offline sample).
Computer program that calculates new information based on acquired batch data. It
uses data from parameters (inputs) in order to create information in the form of new
Soft-sensors parameters (outputs). The signals are used for calculating additional actual process
information based on a specific algorithm. Soft-sensors can be added and edited in the
SOFT-SENSORS section and are available as parameter in the PARAMETERS section.
To be able to configure the parameters, you first have to select a device for the batch (see "Select
Device" on the previous page).
The CONFIGURE PARAMETERS pop-up screen appears. By default, the list of the parameters is expanded.
All parameters that are required for the current batch must be activated. Proceed as follows:
The control toggle button is disabled for all parameters that do not have a setpoint (e.g. sensor
parameters).
For some devices (e.g. INFORS HT shakers) it is not possible to switch the control parameters on or
off. In this case, the CONTROL column and the toggle buttons are not visible.
By clicking on the CONTROL column header itself you can switch all parameter controls either on
or off simultaneously.
The touch screen software of the INFORS HT bioreactors provides the option of setting up a cas-
cade control of a process parameter. If a parameter is controlled by a cascade, no manual setpoint
can be set in eve® and the message CONTROLLED BY CASCADE is shown.
For each parameter (device parameters and soft-sensors) it is possible to enable or disable the alarm. If enabled, an
alarm is triggered, if the actual value of the parameter is no longer within the set alarm limits. The alarm message is
shown in the ALARMS tab on the bottom of the screen. Furthermore it is possible to receive the alarm message by
e-mail (see "Alarms" on page 106).
Fixed alarm type: If you select FIXED, you can set absolute values as alarm limits. Example: An alarm is
triggered if the temperature falls below 35 °C or rises above 39 °C.
Dynamic alarm type: If you select DYNAMIC, you can define a range that moves with the setpoint. The
upper and lower alarm values will continuously be calculated in relation to the setpoint during the batch.
Note that dynamic alarms are only available for parameters that can be controlled and therefore can have a
setpoint. Example: An alarm is triggered if the temperature exceeds or falls below the setpoint by 2 °C.
Depending on the selected alarm type, either a range or absolute limits can be set. To change the range or the limit
of a parameter alarm, proceed as follows:
1. Click into either the upper or lower alarm field of the parameter.
2. Change the value by entering a new value.
The new range or limit of the alarm is set.
By default, for each parameter the alarm is switched on. To disable the alarm of a specific parameter, proceed as
follows:
B. Offline parameters
Each batch can have several configured offline parameters. The actual values for the offline parameters can be
entered when taking an offline sample (see "Take or Export Offline Samples" on page 77).
Configuring and adding an offline parameter can be helpful if you already know what kind of
samples you will take during the cultivation process. For example the definition of biomass (xt)- and
substrate concentration (st) may be useful for visualising the taken offline samples in the chart dis-
play.
When you take a sample and enter the value for the offline parameter, you will be forced to enter
the value with exactly the decimals defined here (e.g. 2 decimals = x.xx) (see "Take or Export Offline
Samples" on page 77).
C. Soft-sensors
For information how to configure a new soft-sensor, see "Add New Soft-Sensor" on page 137.
7. If necessary, click the icon to edit the constant values of the soft-sensor.
Inoculum volume and inoculum concentration/OD can also be specified during a running batch when
the batch is inoculated (see "Inoculate Batch" on page 76).
For information how to create a new organism, see "Add New Organism" on page 123.
Inoculum concentration
1. Go to the ORGANISM section.
2. Enter any value in the INOCULUM CONCENTRATION field for your inoculum concentration.
3. Select the corresponding unit for your inoculum concentration in the drop down menu next to it.
The inoculum concentration with the corresponding unit is displayed.
Specifying the inoculum concentration (x0) as an example enables the possibility to use this value for
a biomass growth model. Furthermore, any entered information in this section is saved to the batch
and always accessible.
For information how to create a new culture medium, see "Add New Culture Medium" on page 126.
1. Click into the enter a compound field at the top of the culture medium compound list.
As you start to type any culture medium compound a list of proposed culture medium compounds
(synchronised from the culture medium compounds library) appears and allows you to select you
desired culture medium compound.
Simple changes of the culture medium compounds can be conducted by clicking into the corresponding fields.
Each amount and unit of a specific culture medium compound can be changed directly in the displayed list.
1. Click directly on the specific culture medium compound which you want to change and enter the new value.
The changed value will turn immediately into orange as an indication of change.
By clicking on the icon you can easily delete a culture medium compound from the current cul-
ture medium compound list.
Changing any values or compounds of the selected culture medium results into two options for saving the altered
culture medium:
Save the altered culture medium as a new entry to the culture media library
Save the altered culture medium to the current batch
1. Click SAVE TO LIBRARY to save the altered culture medium to the culture media library.
Click OK if you simply want to save the altered culture medium to your batch and continue in the
PLAN & RUN workflow.
If you do not save the altered culture medium to your culture media library, the culture medium will
not be available for any further batches.
The different phases of a strategy are connected to each other via transition rules. The transition rules determine
which conditions must be met before the next phase can start.
By default, every batch strategy starts with the phases "Preparation" and "Batch". The transition for
this two phases is triggered by inoculating the batch (see "Inoculate Batch" on page 76). However,
the two preconfigured phases can be renamed or deleted.
Defining the number of phases at the very beginning helps to build the frame work of the strategy.
As soon as all the phases are configured, it is easy to configure each parameter for every phase.
For a simple fed-batch cultivation the pre-programmed function "exponential" can be used to get a
exponential feeding profile. The exponential feed profile is based on Ft = F0 ∙ eµ∙t where F0 and µ∙t
have to be defined.
The touch screen software of the INFORS HT bioreactors provides the option of setting up a cascade
control of a process parameter. If a parameter is controlled by a cascade, the message box
PARAMETER CONTROLLED BY CASCADE is shown. When you hover over the message box, the text
disappears and allows you to edit the setpoint or the function. Note that eve® doesn't send new set-
points to parameters that are cascaded in the touch screen software of the bioreactor.
1. Click the PLUS icon on the right-hand side of the last phase container.
2. Click into the name of the phase and enter a new name.
The new phase is ready for the configuration of all process parameters.
With the PLUS icon, a phase can only be added at the end of the sequence. To add phases
between already existing phases or to change the order of the phases, click EDIT PHASES.
2. To change the order of the phases, move them to the desired position using drag and drop.
3. Click OK to save your settings.
It is not possible to replace a phase where a function is running over several other phases. Fur-
thermore it is not possible to place a phase in between two phases that are connected with a func-
tion.
The transition rules can be combined using AND or OR functions. A transition rule also can be used multiple times.
Multiple transition rules can only be combined by one of the boolean connection buttons (either AND
or OR). It is not possible to mix AND and OR.
Example: The next phase starts as soon as the temp. is higher than 30 °C and the pH is higher than 7.
To delete a transition rule, simply click on the icon on the right-hand side of the transition rule.
The setpoint of a parameter continues as long as no other value/function is configured for this spe-
cific parameter (i.e. also for several process phases). This rule is also true for any configured function
which reaches a certain maximum/minimum at a specific time point. As long as no other specific set-
point is configured in the strategy, the parameter value will not change.
1. Click the icon on the right-hand side of the parameter entry field to configure any function for a specific
parameter.
2. Select any of the provided functions and click the corresponding icon.
The CONFIGURATION screen appears.
Linear function
The preconfigured linear function consists of the two constants slope and offset (intercept). For each constant any
real number can be configured.
If the configured function does not reach the planned end value (maximum/minimum) within the con-
figured phase, the setpoint of this specific parameter will no longer follow the configured function
and the last value will be applied (see "Set Transition Rules" on page 43).
Ramp function
The preconfigured ramp function is based on the linear function but consists of a start and the end point and any
specified time interval. This function is especially applicable when no previous information function (i.e. calculation
and models) of the parameter is available.
The time interval defines the slope of the ramp function and by that how fast the end setpoint is
reached. If the configured function does not reach the planned end value
(maximum/minimum) within the configured phase, the setpoint of this specific parameter will no
longer follow the configured function and the last value will be applied (see "Set Transition Rules" on
page 43).
Exponential function
The preconfigured exponential function consists of the two constants factor and exponent. For each constant, any
real number can be configured.
If the configured function does not reach the planned end value (maximum/minimum) within the con-
figured phase, the setpoint of this specific parameter will no longer follow the configured function
and the last value will be applied (see "Set Transition Rules" on page 43).
Step function
The step function is a table that allows to configure a certain parameter value as setpoint for any given timepoint
(absolute).
The table is always ordered automatically as soon as you enter a new value.
5. Click into the setpoint entry field to configure any setpoint of the parameter for this specific step.
6. If necessary, you can tick the REPEAT checkbox to repeat the entire step function (all steps).
The repeat function within the step function is especially useful when a repetitive profile is applied.
If the configured function does not reach the planned end value (maximum/minimum) within the con-
figured phase, the setpoint of this specific parameter will no longer follow the configured function
and the last value will be applied (see "Set Transition Rules" on page 43).
Gravimetric feed
Gravimetric functions are designed for feed pumps (although available for all parameter types). The evolution of
the setpoint will follow a feed rate profile in g h-1 based on the flow rate of the pump and controlled by the weight
of a specific balance.
Feed rate based: If this mode is selected, the feed is optimised for feed rate. The overall (absolute) weight
can drift due to interferences on the balance.
Weight based: If this mode is selected, the feed is optimised for feed integral. The feed rate will fluctuate
more.
When creating a gravimetric function you can choose between the exponential, polynomial and profile options.
1. Click EXPONENTIAL.
6. Enter the maximal flow rate of the used pump at 100 % (INFORS HT equipment provides a built in calibration
function for that) in g h-1.
In the drop down selection of the balance, all parameters of type "Weight" and "Unknown" are
displayed.
7. Select the type of gravimetric feed control by clicking FEED RATE or WEIGHT.
Changing P- or I-Term or the window size will have influence on how the controller works.
1. Click POLYNOMINAL.
6. Enter the maximal flow rate of the used pump at 100 % (INFORS HT equipment provides a built in calibration
function for that) in g h-1.
In the drop down selection of the balance, all parameters of type "Weight" and "Unknown" are
displayed.
7. Select the type of gravimetric feed control by clicking FEED RATE or WEIGHT.
Changing P- or I-Term or the window size will have influence on how the controller works.
1. Click PROFILE.
9. Enter the maximal flow rate of the used pump at 100 % (INFORS HT equipment provides a built in calibration
function for that) in g h-1.
In the drop down selection of the balance, all parameters of type "Weight" and "Unknown" are
displayed.
10. Select the type of gravimetric feed control by clicking FEED RATE or WEIGHT.
11. Change the P-Term and I-Term for the controller if necessary.
Changing P- or I-Term or the window size will have influence on how the controller works.
Example
Sine function
//Setpoint as a Sine
var startValue = (output.MaximalValue - output.MinimalValue) / 2.0;
var sineRange = startValue * 0.7;
output.Setpoint = startValue + sine Range * Math.Sin(process.CurrentPhaseTime.TotalSeconds);
Define function
1. Click CUSTOM.
2. Optional: Add one or more predefined methods in the SCRIPTING METHODS section to use for your func-
tion or script. For information how to manage scripting methods, see "Scripting Methods" on page 148.
3. Enter any function or script in the editor window in the CONFIGURATION section.
An automatic syntax checker will ensure the correct syntax. Syntax errors will be notified and displayed
with an error message in the corresponding script line.
If the configured function does not reach the planned end value (maximum/minimum) within the con-
figured phase, the setpoint of this specific parameter will no longer follow the configured function
and the last value will be applied (see "Set Transition Rules" on page 43).
For a more detailed and more comprehensive description about the scripting in eve®, please refer to
the eve® scripting guide .
The batch is started and the MONITOR screen of the batch appears (see "Monitor, Adjust or Analyse
Batch" on page 74).
If you want to start the batch later on, just close the PLAN & RUN window. The batch is saved auto-
matically and can be opened again in the BATCHES library.
If you want to start a simple batch without any organism/culture media information or batch
strategy, a quick start function is available. All you need to do is define a name for the batch and
select the device in the BASIC SETUP step. To start the batch, click QUICK START on the bottom
right of the BASIC SETUP screen.
Workflow
The workflow to plan a multiple batch experiment starts with the definition of the reference batch. The procedure
is similar to creating a single batch experiment (see the four workflow steps below). Afterwards, each batch of the
multiple batch experiment can be modified as required and started individually.
1. Click MULTIPLE BATCH on the left-hand side in the PLAN & RUN menu.
The name of the multiple batch experiment will be used both for the experiment and the single
batches within the experiment. Each batch gets the same name as the experiment with an ascend-
ing number. The name of the individual batches can be modified once the reference batch has
been defined.
6. To define the settings of the reference batch, proceed the same way as when planning a single batch. For
details to the different workflow steps, refer to the corresponding chapters:
"Basic Setup" on page 20
"Organism Information" on page 32
"Culture Media Information" on page 35
"Batch Strategy" on page 40
7. When you have defined all the settings and entered all the necessary information, click
GENERATE EXPERIMENT at the bottom right-hand side of the BATCH STRATEGY screen.
The multiple batch overview table of all the planned batches appears.
1. Click on the device name button in the BASIC SETUP column of the multiple batch overview table.
3. Click OK to save your settings and get back to the multiple batch overview table.
1. Click the icon in the BASIC SETUP column of the multiple batch overview table.
2. Follow the instruction as for a single batch for editing the basic setup (see "Basic Setup" on page 20).
3. Click BACK TO OVERVIEW to get back to the multiple batch overview table.
If you just want to change the name of a single batch, you can also click directly into the name
column of the multiple batch overview table and change it.
1. Click the icon in the ORGANISM column of the multiple batch overview table.
2. Change the organism by clicking the icon next to the change organism option.
1. Click the icon in the CULTURE MEDIA column of the multiple batch overview table.
If you want to delete or edit an existing culture media, click the or icon on the right-hand
side of the culture media list.
3. Follow the instruction as for a single batch for editing the culture medium (see "Edit Culture Medium" on
page 37).
4. Click OK to save your settings.
5. Click BACK TO OVERVIEW to get back to the multiple batch overview table.
1. Click the icon in the STRATEGY column of the multiple batch overview table.
2. Follow the instructions as for a single batch to edit the strategy (see "Batch Strategy" on page 40).
3. Click BACK TO OVERVIEW to get back to the multiple batch overview table.
Start a batch
1. To start a single batch, click START in the ACTION column of the multiple batch overview table. To start two
or more batches at the same time, select the batches and click START in the footer.
The batch is started and the MONITOR screen of the batch appears (see "Monitor, Adjust or Analyse
Batch" on page 74). If one or more batches cannot be started, a corresponding message appears.
1. To open the chart view of a running batch, click OPEN in the ACTION column of the multiple batch overview
table.
The MONITOR screen of the specific batch appears.
The name of the multiple batch experiment is displayed at the top of the chart. Running/started
batches within the experiment are listed in a tab allowing fast switching between them.
Delete a batch
1. To delete a single batch, click the icon on the right-hand side of the ACTION column in the multiple batch
overview table. To delete two or more batches at the same time, select the batches and click DELETE in the
footer.
2. Confirm that you want to delete the specific batch(es).
The batch is deleted and removed from the multiple batch overview. If one or more batches cannot be
deleted, a corresponding message appears.
Inoculate a batch
Multiple batches can be inoculated simultaneously via the multi batch overview. This means that it is not necessary
to inoculate each batch individually (see "Inoculate Batch" on page 76). Proceed as follows:
Menu Function
The BATCHES section provides a list of all running and completed batches including
"Batches Menu" on batch start time. From the batches overview, you can access the chart view of each
the facing page batch, switch on or off the e-mail alarm notification, export the batch data and create
recipes.
The RUNNING BATCHES section allow you to monitor all running batches at once. The
"Running Batches
menu provides a customizable overview of all running batches including the actual val-
Menu" on page 71
ues of the parameters and alarm states.
To be able to subscribe to e-mail alarm notifications, an e-mail server must be configured (see "E-
Mail Server Configuration" on page 196) and e-mail alarm notification in the user profile must be
activated (see "My Profile" on page 182).
E-mail alarm notifications will be sent only once when a parameter is out of range.
By default, the batches are listed after their creation time (most recent at the top). By clicking on the column
header, the table can be sorted by the device or batch name in ascending or descending order.
By clicking the icon next to the batch name, the chart view of the corresponding batch can be opened.
2. To show or hide a parameter, mark the parameter and use the ADD or REMOVE button to move it to the cor-
responding window.
3. To change the position of a parameter, mark the parameter in the VISIBLE PARAMETERS window and use the
MOVE UP or MOVE DOWN button to set the position of the parameter.
4. Confirm with OK.
The settings are stored and are reloaded the next time the overview is opened.
If there is an active or an inactive alarm for a parameter, the field of the corresponding parameter is highlighted as
follows:
Active alarm
If there is an active alarm for a parameter (actual value
is out of range), the field of the corresponding para-
meter is highlighted in red. The device and batch
names as well as the header of the parameter column
are highlighted in light orange.
Inactive alarm
If there is an inactive alarm for a parameter (actual
value was out of range but is within range again) and
the alarm has not yet been confirmed, the field of the
parameter is highlighted in orange. After acknow-
ledging the alarm in the ALARMS tab, the field is no
longer highlighted.
Device alarm
If there is an active or an inactive alarm for a device (e.g. connection loss), the field of the corresponding device is
highlighted as follows:
Active alarm
Inactive alarm
There are different entry points to open the chart view of a batch:
Every running and completed experiment and its batches can be accessed through the BATCHES library or
the BATCHES section in the MONITOR AND ANALYSE menu.
Additionally, running experiments and its batches can be accessed through the DASHBOARD or the
RUNNING BATCHES section in the MONITOR AND ANALYSE menu.
The chart view of a batch can always be opened by clicking the icon.
When you open a batch that is part of a multiple batch experiment, all individual batches belonging
to this experiment are opened. Use the tabs on the top to switch between the batches.
To be able to analyse an archived batch, the batch first has to be unarchived (see "Archive Batch
Data" on page 111).
2. If available, enter the measured value of your inoculum concentration into the CONCENTRATION entry field.
The inoculum volume and inoculum concentration/OD (from the recipe) are pre-filled if this inform-
ation was provided in the organism workflow (see "Organism Information" on page 32). Note that
the expected concentration/OD based on the recipe and the volume cannot be changed anymore
after confirming. The measured concentration/OD, however, can be changed at any time later on.
To be able to enter a value for an offline parameter, the offline parameter must first be created in the
parameter section. This can either be done when planning a batch or during a running batch (see "B.
Offline parameters" on page 28).
The new sample appears in the offline sample list with the corresponding time stamp.
3. Click into the VOLUME field on the right-hand side of the sample entry to define the offline sample volume.
4. Click into the VALUE field on the right-hand side of the sample entry to enter the offline sample value.
When a measurement has been confirmed by clicking the icon, it cannot be changed anymore.
Note that confirming the measurement is only possible for users with user role Technician, User or
Manager.
Offline samples can be exported as a .xls file. The exported offline samples can be edited (e.g. with Microsoft Excel)
and imported again. To export the offline samples, proceed as follows:
1. Click EXPORT at the bottom of the OFFLINE SAMPLES screen to export your offline samples.
The .xls file will be downloaded automatically and can be opened e.g. with Microsoft Excel.
You can add additional samples to the .xls file and import it again. However, as soon as a value is
confirmed in eve®, the value can no longer be changed.
Offline samples can be imported from an .xls file. The imported offline samples will overwrite the existing sample
list. To import offline samples, proceed as follows:
1. Click IMPORT at the bottom of the OFFLINE SAMPLES screen to import your offline samples.
The entered comment is saved in the log book and appears in the log book list with the according time
stamp.
A new pop-up window with the list of all recorded parameters appears.
2. To change any parameter setpoint or parameter alarm, proceed in the same way as setting the parameters
when planning a batch (see "Configure the Parameters" on page 23).
The parameter setpoint window can be displayed independently (e.g. on a second monitor) in
order to always have full access to the parameter setpoints.
If a function from the strategy is active on this particular parameter, the setpoint might immediately
be overwritten by the strategy again.
A new pop-up window with the strategy screen appears. The active phase is marked with an orange rect-
angle.
2. To change or add a phase, transition or parameter function, proceed in the same way as when defining the
strategy when planning a batch (see "Batch Strategy" on page 40).
3. Click OK to save your settings.
The new strategy settings are saved.
To display only the information you need (e.g. to compare specific parameters), the comparison chart can be adap-
ted the same way as for a single batch (see "Configure Chart" on page 93). If two or more batches contain the
same parameter, each parameter gets a number in square brackets next to its parameter name (axis caption) and
batch name in the tabs. To be able to compare similar phases of two or more batches, the time lines of the batches
can be synchronised.
Example
In the example below, the parameter Generic Gas Analyser Exit CO2 of three batches is compared. Each batch and
each parameter receives a number as identifier. To improve the readability, the chart view is configured so that
each parameter has its own axis caption on the left side. To be able to easily distinguish the signals of the para-
meters, they are displayed in different colors. Tabs in the head allow to switch between the charts of the batches.
Accessibility
The compare views are accessible globally in the whole eve® system. This means that a compare view can not only
be used by the user that has created the compare view but by all users in the eve® system. The settings (e.g. chart
properties) defined by the creator are the initial settings for other users accessing the same chart for the first time.
The users can modify the compare view as desired. Changes are always saved user-specifically. This means that
when a user modifies the compare view, this will not affect the settings of the other users that work with the same
compare view.
When a compare view is deleted, the compare view is deleted globally. It is also possible to delete
compare views created by other users. Therefore, be carefull when deleting compare views and be
sure, that the compare view is no longer used by anyone.
Select Batches
1. Open any batch, either a running batch or a completed batch from the library, by clicking the icon (see
"Monitor, Adjust or Analyse Batch" on page 74).
The chart display of the specific batch appears.
3. Select the batches for the comparison by activating the checkboxes on the left-hand side of the table.
A pop-up screen appears where you have to define a new name for the batch comparison.
Synchronise Batches
To be able to compare similar phases of different batches, the chart view of the different batches can be syn-
chronised. With the synchronisation function, you can for example overlay parameter signals exactly on top of each
other for better comparison. For each batch in the compare view either a fixed synchronisation time or the inocu-
lation time can be selected. Proceed as follows:
1. Click SYNCHRONISATION at the bottom right-hand side of the compare chart display.
Inoculated batches (see "Inoculate Batch" on page 76) can also be synchronised at the time point
where inoculation happened.
2. Enter the exact time point at the specific batch where the synchronisation should be applied to.
The compare chart display shows all the compared batches as a tab at the top of the chart display. To switch to a
single batch, proceed as follows:
1. Click on any tab of the compared batches which are listed as a tab at the top of the chart display.
2. Click on the compare view tab (name of your compare view) to get back to the compare view.
The chart display of the compare view appears.
A new chart is added and the chart display appears in split screen.
1. Click the icon on the right-hand side of the chart you want to delete.
A menu with setting options for the chart display appears.
A new input entry field appears where the name and a description of the template can be specified.
1. Click the delete icon on the right-hand side of the corresponding template.
2. Confirm the deletion of the selected template.
The selected template is deleted.
Print chart
Depending on the operating system installed, the standard print option screen may look different.
You can define which parameters are displayed and how they are presented on the y-axis (see "Configure
Axis" on the next page).
You can customise the appearance of each parameter in the chart (e.g. changing the color or line size) (see
"Change Parameter Appearance" on page 96).
You can adjust the scale of each axis in y-direction (see "Configure Axis Scale" on page 99).
You can define which time period should be displayed on the chart (see "Change Time Scale and Zoom" on
page 101).
You can define how the tooltip should be displayed when hovering over a parameter-line (see "Change
Tooltip Mode" on page 104).
You can define how often the values on the chart should be updated (see "Configure Data Loading" on
page 105).
It is recommended to position parameters with large differences in scale (e.g. stirrer and pH value) on
different axis. Otherwise, small changes in the measured value would not be visible in the chart.
To show, hide or move a parameter to another axis on the chart, proceed as follows:
1. Click on any number to assign your parameter to one of the six axis (left 1-3 and right 1-3).
The specific parameter appears on the selected axis (second left in this case) on the chart display.
If two or more parameters have a similar axis scale it is also possible to combine them on one axis:
1. Click on the same number to assign your two parameters to the same axis.
Both of the parameters appear on the same axis on the chart display.
As soon as you assign a parameter to a specific axis, the parameter will appear on the selected axis
(live synchronisation in the background on the chart display).
All the parameters appear on the chart display on the first left axis.
1. Click directly on the axis caption (parameter name) either on the left-hand side or right-hand side of the main
chart display.
Any change in the PARAMETER APPEARANCE pop-up screen has immediate effect and is visualised
live in the background on the chart display.
Change axis
1. Click on any number in the AXIS option to assign your parameter to one of the six axis (left 1-3 and right 1-3).
The specific parameter appears on the selected axis (first left in this case).
Change marker
Each data point of a parameter is represented by a marker in the chart. By default data points are represented by a
dash and are therefore not visible in the chart. To change the marker and to make the data points visible, proceed
as follows:
1. Click on the icon in the MARKER option to change the marker of your parameter appearance.
To improve both, the clarity and the performance of the chart, the markers are hidden when the
data is dense, and shown for more widespread data points.
Change color
To be able to clearly distinguish the individual parameters in the chart, the colour of the lines can be changed. Pro-
ceed as follows:
1. Click on the icon in the COLOR option to change the color of your parameter appearance.
To change the size of the lines and the markers of the data points, proceed as follows:
1. Click on the cursor of the scroll bar in the LINE SIZE option and move it to the right (thicker) or to the left (thin-
ner) to change the line size.
1. Click on any number on the axis to change the scale of the axis.
By default, all the axis have the AUTO-SCALE option activated. To be able to change the axis scale, you have to
uncheck this option.
The entry fields for min. and max. values are enabled.
1. Click on the cursor of the scroll bar in the DECIMALS option and move it to the right or to the left to change
the amount of decimals.
Each parameter has a set number of decimals. To change the decimals for the entire system, you
have to configure the specific device parameter (see "Change Unit Settings" on page 168).
1. Click directly on a time point on the x-axis to change the time format.
During the monitoring, the chart can be configured so that the hours before the inoculation are negative and the
zero point shifts towards the incoulation timepoint:
The batch time since inoculation is displayed next to the icon as well as on the axis itself (zero point is
moved towards the inoculation line).
Zoom Navigation
1. Click (and hold) anywhere on the chart display and drag the mouse pointer to the time point where you want
to end the zoom.
The area where the zoom is applied to gets a pale blue background.
At the bottom of the chart display a quick navigation toolbar is available. As soon as any zoom is applied to an area
on the chart display, the quick navigation toolbar can be used for navigation. To scroll on the time scale with the
selected zoom window, proceed as follows:
1. Drag on the edges of the pale blue zoom window at the bottom of the chart display or click directly into the
area and drag it to a specific time point.
The very top left of the chart displays if the data is "LIVE" (running process) or "HISTORY" (past).
Example of the second tooltip mode in the upper left corner of the chart display:
The refresh rate defines the time period between two chart
updates in seconds (e.g. an entry of 10 means, that the
REFRESH RATE 20
chart is updated every 10 seconds). Note that the refresh
rate can only be changed for running batches.
5.5 Alarms
For information how to set alarm limits for the parameters, see "A. Parameters (device parameters
and soft-sensor parameters)" on page 24.
Alarm limits, consisting of an upper and lower alarm value, can be set for each parameter. The software checks the
actual values of the parameters against the alarm limits and triggers an alarm as soon as the actual value of a para-
meter exceeds the defined limits.
For visual notification in case an alarm occurs, each menu/submenu has an alarm tab on the bottom side. By click-
ing on the alarm tab, the list of the currently active and inactive alarms can be expanded. Depending on the alarm
state, the alarm tab appears in white or red:
To assure traceability, alarms are also logged in the audit trail (see "Audit Trail" on page 153).
Alarm states
Active alarm: An alarm is active when the actual value of the parameter is out of range or the failure caus-
ing the alarm (e.g. loss of connection) is still present. You cannot acknowledge the alarm but only open the
batch by clicking the icon. When an alarm is active, the entry itself and the alarm notification tab
appears in red. The tab is additionally blinking.
Inactive alarm: An alarm is inactive when the actual value of the parameter has been out of range but is
within the range again or the failure causing the alarm has been fixed. When an alarm is inactive, the entry
itself appears in orange but the notification tab appears still in red.
Acknowledge alarm
If the condition that triggered an alarm is no longer present, and the alarm is thus inactive, the alarm can be
acknowledged. To do so, proceed as follows:
6 LIBRARIES
Libraries are a storage place for all different kinds of data and a very powerful tool to structure and link process
information. The library menu allows you to store any batch-related data and thus to prepare any batch in the
appropriate way. This includes, among others, the following tasks:
Import, export and archive batches (see "Batches" on the facing page)
Create reports (see "Create Report" on page 114)
Create and edit recipes (see "Recipes" on page 119)
Create and edit organisms (see "Organisms" on page 122)
Create and edit culture media (see "Culture Media" on page 125)
Create and edit compounds (see "Compounds" on page 130)
Create and edit soft-sensors (see "Soft-Sensors" on page 133)
Display and export audit trail (see "Audit Trail" on page 153)
6.1 Batches
A batch is an individual bioprocess configured in an experiment and assigned to a unit (e.g. bioreactor vessel). The
batches library lists all planned, running and completed batches. By default, the batches are listed after their cre-
ation time (most recent at the top). By clicking on the column header, the table can be sorted by the selected
column in ascending or descending order. An extended search function allows you to search for entries in the
batches library (see "Search and Filter Tables" on page 16).
The following search operators can be used to narrow down the search or to define the search string precisely:
The keywords are not case-sensitive, keywords can be written in uppercase or lowercase char-
acters.
Syntax
AND/OR operators must be capitalized.
AND/OR operators must be at first position.
It is recommended to replace whitespaces/blanks in search strings by an asterisks (*).
Examples
AND batch* device* user1 finds batch1, batch2, batchABCD {...} on device1, device2 {...} for user
'user1'.
2020-07-16* finds every batch that has been created or started on 16 July 2020.
Every completed batch can be archived. Archived batches are not visible anymore in the MONITOR & ANALYSE sec-
tion and cannot be opened or exported. With the corresponding filter settings, archived batches are still visible in
the batches library. To archive a batch, proceed as follows:
If you would like to see all batches inclusive the archived ones, proceed as follows:
Unarchive batch
If an archived batch is unarchived again, it will have the same status as before the archiving procedure. This means
that the batch is visible again in the MONITOR & ANALYSE section and can be opened, exported or used to com-
pare batches.
The following file formats for importing batch data are supported:
eve files
Iris files
.csv files
Excel files
To import an excel or .csv file, you have to make sure that this file was created by eve® or at least has
exactly the same data structure and order.
5. Select your batch data file and click Open at the bottom of the windows browse pop-up screen.
Your selected batch data file is saved in the batch library.
The following file formats for exporting batch data are supported:
eve files
.csv files
3. Click the corresponding export button depending on what kind of batch data file you want to create.
4. If you export the batch data as .csv file, select either AVERAGE or RAW.
RAW: All datapoints are exported.
AVERAGE: The .csv file is exported with a datapoint every x seconds/minutes/hours/days. The averaged data-
point is in the middle of the entered average interval (e.g. if you enter an interval of 10 seconds, the first data-
point is at 5 seconds, the second at 15 seconds and so on).
5. Select whether you would like to export the data since inoculation or the entire batch data. If the batch has
not been inoculated, the option SINCE INOCULATION is not available.
6. Click SAVE.
The exported batch data file appears as downloaded file at the bottom of your web browser.
If you want to display the exported .csv file in Microsoft Excel, do not open the .csv file directly but
import the file via the built in Excel import function - otherwise the format of the displayed data is
wrong.
Note for .csv files: The exported batch data for a specific parameter (e.g. temperature, °C) are only
recorded when a change in the signal value is measurable. This can lead to gaps in the parameter
time series. To avoid gaps in the .csv file, the option FILL GAPS IN CSV EXPORT in the global settings
can be enabled (see "csv Export Settings" on page 198).
Depending on which web browser you are using, the download is displayed at the bottom of the
web browser (download folder) or a pop-up appears where you have to specify the download dir-
ectory.
If a report is created from a multiple batch experiment, the first step of the workflow starts with
BATCHES. This step allows to select all the batches which will be included in the report.
For default batch report settings, please configure the batch report in global settings (see "Default
Batch Report Settings" on page 188).
Report components
Report components are defined modules with specific information for the report (such as organism or culture
medium information). By default, all the components are selected and activated. A description of the components
is listed below:
Components Description
Report parameters
For every monitored parameter different parameter specific information can be displayed. A description of the para-
meter options is listed below:
Parameter
Description
option
Displays a chart of the parameter with trend, standard deviation (blue) and min./max. value
CHARTS
(orange)
AUDIT TRAIL Lists in a table all the audit trail entries of the parameter
FUNCTIONS Lists in a table all relevant information about the functions of the parameter
Allows to display the data points in a averaged (every 30 data point) or raw (every second)
DATA POINTS
way
1. Select/deselect your desired parameters and parameter options for the report.
The selection of the parameters and parameter options can be executed for every row and column
by clicking on the name of the parameter (e.g. Temp) or parameter option (SETPOINTS). If you want
to deselect or select all parameters and parameter options, click in the empty cell on the upper left
corner.
2. Click NEXT.
The PREVIEW screen appears.
Report preview
The preview creates the report. After creation, the report can be browsed and downloaded (different types of data
formats). Depending on what kind of report components were selected, the report consists of different parts.
However, the following modules are included in every report.
Report
Description
module
Title page of the report with: Creation date/time, creator (user), project name, experiment name,
Title page
experiment creation date/time
Batch over-
Information about: Project, experiment, batch, state, device, batch time and inoculation time
view
To browse through the created report and download it afterwards, proceed as follows:
1. Click on the small arrows at the top of the preview pop-up screen.
2. Click the download icon to download and save the report of the experiment/batch.
6.2 Recipes
A recipe is a predefined configuration of a batch involving elements such as devices, organisms, culture media,
soft-sensors, setpoints and strategies. The function allows you to save the configuration of an existing batch and
apply it afterwards to a new batch (see "Basic Setup" on page 20). Recipes can also be exported or imported from
another eve® system. To access the library of created recipes, proceed as follows:
4. Click RECIPE.
A new pop-up screen appears where you have to enter a name for the recipe.
A windows browse pop-up screen appears to browse your batch data on the computer.
4. Select your recipe data file (.json) and click Open at the bottom of the windows browse pop-up screen.
Your selected recipe file is saved in the recipe library.
6.3 Organisms
The organisms library allows you to store all relevant information about a specific organism and to access the data
at any time. Organisms are defined by the cell type and the clone.
3. Enter the corresponding information into the mandatory fields, indicated by a * after the name.
4. Enter the corresponding information into the optional fields.
To add a new culture medium to the culture media library list, proceed as follows:
The CREATE CULTURE MEDIUM pop-up screen appears with a predefined workflow to create a new cul-
ture medium. It starts with basic details about the culture medium.
6. Click into the ENTER A COMPOUND NAME OR FORMULA field to add a compound to your culture medium.
As soon as you start to type a compound name or compound formula, a selection of your stored com-
pounds is proposed.
8. Click into any concentration compound field to change the concentration of the compound.
9. Click on any unit compound field to change the unit of the compound.
3. Edit any information of the culture medium either in the DETAILS or the COMPOUNDS section.
4. Click SAVE at the bottom of the EDIT CULTURE MEDIUM pop-up screen.
The changed culture medium is saved and stored in the culture media library list.
6.5 Compounds
In eve® each culture medium consists of one or more compounds. The compounds library allows you to manage
these compounds, namely add new compounds, edit existing compounds or delete not used compounds. The com-
pounds library shows all compounds that are available when creating a new culture medium. eve® already
provides a comprehensive amount of standard culture media compounds, which can also be edited if required.
6.6 Soft-Sensors
Soft-sensors are virtual sensors that calculate new parameter values based on a mathematical model or a cor-
relation of already known parameter values. Basically soft-sensors are algorithms providing calculated values and
information which cannot be easily obtained from an in-process sensor, e.g. batch biomass prediction.
Soft-sensors can be added and managed in a dedicated library. To access the soft-sensors library, proceed as fol-
lows:
Name Description
input1.Setpoint Current value of a parameter, read only for inputs but writeable for output parameters
Name Description
process.TimeSinceInoculation TimeSpan Gets the elapsed time of the process since inoculation
process.IsInoculated bool Gets the value if the process has been inoculated
process.IsStopped bool Gets the value if the process has been stopped
Operator Description
+= Add and assign: it adds right operand to the left operand and assigns the result to left operand
Subtract and assign: it subtracts right operand from the left operand and assigns the result to the
-=
left operand
Logical AND operator: only if both given statements (a, b) are true, the result is true. Else the result
&&
is false
Logical OR operator: if one of the given statements (a, b) is true, the result is true. Else the result is
||
false
! Logical NOT operator: inverts the truth value of the following statement (true à false, false à true)
Name Description
Examples
// Input: temp
// Output: tempSP
tempSP.Value = temp.Setpoint;
//Culture volume
var Wvol = 1.0;
// Specific rate
var specRate = AirFlow.Value / Wvol;
// RQ Value
RQ.Value = CER.Value / OUR.Value;
For a more comprehensive description about the scripting in eve®, please refer to the eve® scripting
guide.
The CREATE SOFT-SENSOR pop-up screen appears which has a predefined workflow to create a new
soft-sensor and starts with the basic details of the soft-sensor.
8. Click the PARAMETER TYPE field to change the parameter type of a specific input.
11. Click the NAME field to change the name of a specific output.
12. Click the PARAMETER TYPE field to change the parameter type of a specific output.
13. Click the UNIT field to change the unit of a specific output.
16. Click the NAME field to change the name of a specific constant.
17. Click the UNIT field to change the unit of a specific constant.
1. Open chart view of the completed batch (see "Monitor, Adjust or Analyse Batch" on page 74).
The chart view of the batch appers.
3. Edit any information of the specific soft-sensor in one of the sections (details, inputs, outputs, constants,
scripting methods or configuration).
4. Click SAVE at the bottom of the EDIT SOFT-SENSOR pop-up screen.
The changed soft-sensor is saved and stored in the soft-sensor library list.
As soon as the soft-sensor is selected from the soft-sensor library list, the specific outputs will be displayed as para-
meters:
If soft-sensors are applied on completed batches, they can be deleted as well directly from the para-
meter list.
4. Select your soft-sensor file (.json) and click Open at the bottom of the windows browse pop-up screen.
Your selected soft-sensor is saved in the soft-sensor library.
Scripting methods can be added and managed in a dedicated library. To access the scripting methods library, pro-
ceed as follows:
The CREATE SCRIPTING METHOD pop-up screen appears which has a predefined workflow to create a
new scripting method and starts with the basic details of the scripting method.
12. Click SAVE at the bottom of the CREATE SCRIPTING METHOD pop-up screen.
The scripting method is added to the scripting method library list and can be used for any soft-sensor or
custom function.
3. Edit any information of the specific scripting method in one of the sections (details, inputs, output or con-
figuration).
4. Click SAVE at the bottom of the EDIT SCRIPTING METHOD pop-up screen.
The changed scripting method is saved and stored in the scripting methods library list.
Changes in a scripting method are not automatically applied to the soft-sensors and custom func-
tions referring the specific scripting method. Modified scripting methods have to be updated manu-
ally in the settings of the soft-sensor/custom function (see "Update Scripting Method" on page 1).
1. Open the settings of the soft-sensor/custom function that should use the modified scripting method.
2. Open the section SCRIPTING METHODS.
If one of the scripting methods in the list has been modified in the meantime, the update icon is enabled.
The audit trail cannot be turned off nor can entries in the audit trail be deleted. The software does not allow any
manipulations of the audit trail.
By clicking on the column header, the table can be sorted by the selected column in ascending or descending
order. An extended search function allows you to search for entries in the audit trail (see "Search and Filter Audit
Trail" on the next page). The complete audit trail or parts of it can be exported and saved in various file formats.
Name Description
USER The user ID of the (logged) user responsible for this action
The address of the local device the action was executed from or the gateway the request ori-
IP ADDRESS
ginated from
Date of event (note: date has to be entered in format yyyy-mm-dd, e.g. 2020-07-16)
User name
Event type
Action
Project name
Experiment name
Batch name
Device name
Unit name
IP Addresse
The following search operators can be used to narrow down the search or to define the search string precisely:
+: the term must be present (e.g. +Manager means Manager must be present).
-: the term must not be present (e.g. -Service means Service must not be present).
AND: both terms must be present.
OR: one of the terms must be present.
NOT: the term must not be present.
Quotation marks ("") can be used to search for the entire expression in the specified order.
Question marks (?) can be used to replace a single character.
Asterisks (*) can be used to replace zero or more characters.
The keywords are not case-sensitive, keywords can be written in uppercase or lowercase char-
acters.
Examples
Escherichia AND coli states that Escherichia and coli has to be present.
"Escherichia coli" states that the whole expression "Escherichia coli" has to be present.
Lab states that Lab (without any more characters) has to be present.
Lab* states that Lab has to be present and more characters can follow.
Lab? states that Lab has to be present and exactly one character must follow.
By default, all terms are optional, as long as one term matches. The preferred operators are + (this term must be
present) and - (this term must not be present). All other terms are optional. For example, this query:
states that:
The familiar operators AND, OR and NOT are also supported. However, the effects of these operators can be more
complicated than is obvious at first glance. NOT takes precedence over AND, which takes precedence over OR.
While the + and - only affect the term to the right of the operator, AND and OR can affect the terms to the left and
right.
Rewriting the above query using AND, OR and NOT demonstrates the power and complexity of this function:
This is incorrect because at least one of coli or Labfors is now required and the search for those terms
would be scored differently from the original query.
This form now replicates the logic from the original query correctly, but the relevance scoring bears
little resemblance to the original.
The query result is a list of all library entries matching the search/filter.
3. Optional: Specify a time period filter by entering dates in the FROM and TO fields or enter a customised filter
in the FILTER field.
4. Click PREVIEW.
The PREVIEW screen appears.
5. Click the download icon to download and save the report of the selected audit trail entries.
7 RESOURCES
The RESOURCES menu is used to manage all the resources such as users, devices and projects. This includes,
among others, the following tasks:
7.1 Equipment
The EQUIPMENT section allows you to manage your equipment, namely add or remove devices, change device set-
tings or connect external devices. eve® supports incubation shakers and bioreactors of all sizes and types, and lets
you connect and manage your equipment in a convenient way.
External devices
External devices such as balances, pumps or any other device (e.g. HPLC, mass spectrometer etc.) can be linked to
an existing device (e.g. bioreactor). To add an external device, eve® provides different drivers:
After successful installation of the driver, the device can be added to the eve® device list (see "Add New Device"
on the facing page).
If you connect a device to eve® the first time, the equipment overview is the landing page as soon as
you want to start a batch.
The ADD DEVICE pop-up screen appears where the selection of all different kinds of bioreactors and
shakers is possible.
If you want to add a device that is not available in the CHOOSE DEVICE section, a specific driver
may be required. Contact INFORS HT in case you have any questions.
You will be forwarded automatically to the CONFIGURATION step of the ADD DEVICE pop-up screen.
The standard configuration for any INFORS HT equipment communicates via port 8080.
The ADD DEVICE pop-up screen appears where the selection of all the devices is possible.
5. Click the plus icon of the bioreactor unit (vessel) to which you want to connect the external device.
A unit can only be connected to one other unit. To unbind the unit again, simply uncheck the check-
box.
Units and device parameters which were added on the physical device will be displayed in eve® after updating the
device. Changes made in eve® (e.g. device name, parameter name and refresh rate) will not be overwritten when
updating the device.
Note that the update function is only applicable for INFORS HT touchscreen devices (OPC XMLDA/UA) and devices
connected to eve® using an INFORS HT generic driver. Devices with XDDC protocol cannot be refreshed.
To be able to update a device, the device must not be in use, i.e. there must be no running batch on the device.
To change the settings affecting the whole device (e.g. device name or communication settings), click the
icon on the right hand-side of the device name (see "Change Device Settings" on the facing page).
To open the overview of all modules associated to a specific unit (e.g. to change the settings of a module or
a parameter), click the icon next to the unit (see "Change Unit Settings" on page 168).
To change the settings affecting a module (e.g. enable or disable parameters), click the icon on the
right hand-side of the module name (see "Change Module Settings" on page 169).
To change the settings affecting a specific parameter (e.g. parameter name, unit or PID settings), click the
icon on the right hand-side of the parameter name (see "Change Parameter Settings" on page 170).
Setting Description
The name of the device that is shown in the equipment overview. The name of
the device can only be changed when the device is not in use (no running batch).
NAME
Furthermore, the new name is only applied to planned and running batches, not
to completed batches.
The refresh rate defines the minimal interval of time between two com-
munication cycles with a specific device. The refresh rate can be set from 1 to
999 seconds.
REFRESH RATE
By changing the refresh rate the entire communication with the
device is configured.
The synchronise start/stop function can be used to enable or disable the batch
SYNCHRONISE START/STOP
start/stop on the device. To activate this function, check the checkbox.
Setting Description
Setting Description
NAME The name of the parameter is read from the equipment and can be changed if required.
Shows all the parameters that are associated to this module. For each parameter it can be
defined if the parameter is visible or not. Check the checkboxes of the parameters that should
appear for the specific device.
If a parameter is visible or not can also been seen in the module overview.
PARAMETERS
1. Click the icon of the specific module to show the associated parameters.
Setting Description
NAME The name of the parameter is read from the equipment and can be changed if required.
UNIT The unit of the parameter is read from the equipment and can be changed if required.
Defines how many decimals are displayed of the specific parameter. The number of dis-
DECIMALS
played decimals must be equal or lower than the log precision.
The log precision defines the number of decimals that are saved into the database for the
configured parameter. The system writes a new value into the database as soon as a value
LOG PRECISION is within the specified decimals.The number of decimals is by default 0 for each parameter.
The entered value for the decimals must be between 0 and 8. Note that only users with
user roles Manager or System Administrator can change the log precision.
PID settings
Inappropriate changes to the PID settings may have a negative effect on the batch or the device. Only
change the PID settings, if you are fully aware of the consequences or after consulting the man-
ufacturer.
PID controllers (Proportional Integral Derivative controller) are used for some of the parameters (e.g. Temperature
or pH). The PID function is based on a generic formula and where the individual terms can be described as:
P = proportional factor, proportional response to an error, used to reach a setpoint. The bigger the value,
the sharper the control.
I = integral factor, integration of the error in 1/second. A typical integral factor is < 0.05.
D = differential quotient, derivative of the error, set in seconds (mostly to 0).
PID settings can be accessed in the device parameter settings and in custom functions (see eve® scripting guide).
Term Description
Proportional factor: The greater the discrepancy between the setpoint value and the actual value
P (PTerm)
the greater the controller output.
The integral factor aggregates all errors over the time. If the setpoint is not achieved using the pro-
I (I Term, s-1) portional factor, the integral factor adjusts the output successively until the setpoint value is
achieved. An integral factor set too high will lead to oscillation of the control loop.
The differential quotient calculates the change in the actual value over the time and counteracts
D (DTerm, s)
this change to limit any overshoot.
The negative factor can be used to add weighting to two-sided control (+100 to -100 %) (e.g.
Negative heavy acid, light alkali). In the process 1 is the balance and 0.5 or 2 equate to the half or double
Factor the controller output accordingly. Example: Nitrogen influences the pO2 value less than oxygen,
thus a negative factor of 2 can compensate for the reaction of the controller.
If a deadband is entered, no control is implemented within this value at either side of the setpoint
Deadband
value (symmetrically, + / -). I.e. the controller output is = 0. The deadband is used for pH control.
I Limit The integral influence is used to ensure that the integral factor cannot increase over an indefinite
(Integ. period. This limits erroneous accumulation. The integral influence is set between 0 and 100 % of
Limit, %) the controller output.
Evaluation The evaluation time determines the intervals in seconds at which the PID value is recalculated. The
Time controller speed is defined this way. A scanning time of 10 seconds is a good average value.
2. Select the device type from the dropdown list (e.g. GenericBalance for any balance).
The settings of the unknown parameter will be changed according to the selected device type. If any spe-
cific settings need to be configured (e.g. unit change, log precision rate etc.), see "Change Parameter Set-
tings" on page 170.
7.2 Projects
Projects are the top level of the experiment structure. A project can consist of one or more experiments with one
or more batches. Projects can be used within the entire system, i.e not only the owner, but every user can use the
project for his/her experiment.
User rights
System Admin-
Manager User Technician Operator Guest
istrator
Start/stop batch x x x x
Monitor batch x x x x x
Compare batches x x x x x
Acknowledge alarm x x x x
Archive/unarchive batch x x
Libraries
Create recipes x x x
System Admin-
Manager User Technician Operator Guest
istrator
Resources
Refresh devices x x x x
Create projects x x x x
Settings
Activate licenses x x
1. Operator is not allowed to add offline parameters and soft-sensors and confirm the measurement when taking an offline sample
2. User is not allowed to edit device type (Multifors 2) and log precision
Standard
The following rules apply by default, regardless of the eve® license and settings. These are fix and cannot be
changed.
A login with user name and password is required at each program start.
User names must be unique.
Once a user account has been created, the account cannot be deleted anymore. If an account is not needed
anymore, it can be set to inactive.
Password length must be at least 6 characters.
The password needs to be different from the 5 last passwords used by the user.
If FDA-compliance according to FDA 21 CFR Part 11 is required, advanced password security features can be indi-
vidually activated or deactivated in the settings. Please note that these functions are only available with the
Premium license.
If activated, the password length must be at least 8 characters and contain at least one numerical or non-
alpha-numerical character (see "High Security Password" on page 195).
If activated, the password expires after a defined time and must be changed (see "Password Aging" on
page 195).
If activated, the number of login attempts is limited. If the defined number of attempts is exceeded, the user
is automatically set to inactive. Only a user with user role System Administrator or Manager can reactivate
the user (see "User Blocking after Failed Log-In" on page 193).
Field Description
The username must be unique. Note that the username is fixed and cannot be
USERNAME
changed later.
PASSWORD Password with min. 6 or, if high security password function is active, 8 characters.
Entering an e-mail address is required if the user wants to receive alarm notifications
EMAIL ADDRESS by e-mail (see "Subscribe to E-Mail Alarm Notifications" on page 70). Note that a user
can also add or change the e-mail address in his user profile.
Each user must be assigned to a user group. The user group defines which rights the
ROLE
user is assigned to (see "User Roles and User Rights" on page 177).
The complete deletion of any user account is not possible. However eve® allows you to
set a user account to inactive if the account is not used anymore. Users in inactive
ACTIVE
status can no longer log in. Users are automatically set to inactive status if the number
of login attempts defined in the global settings is exceeded (if activated).
3. Fill in the fields as required. Refer to "Add New User" on the previous page for details.
4. Click OK at the bottom of the pop-up screen.
The new user is created and listed in the user list.
8 SETTINGS
In the SETTINGS menu, both user-specific and global settings can be set. The user-specific settings allow you to
customise your user profile while the global settings apply to the entire system. Among others, the following tasks
can be performed:
8.1 My Profile
In the MY PROFILE menu you can modify your personal user profile. This includes changing the password and pro-
file picture as well as enabling or disabling the e-mail alarm notification. To access the user profile, proceed as fol-
lows:
Change password
Users of all user groups can change their own password (see "User Names and Passwords" on page 178 for details
regarding password rules). To change the password, proceed as follows:
4. Select the picture you would like to use as your profile picture.
5. To crop the picture, select the specific area of your profile picture by dragging the square with the mouse.
If you want to delete a profile picture, click the icon and the profile picture will be deleted per-
manently.
To be able to subscribe to e-mail alarm notifications, an e-mail address must be entered and E-
MAIL ALARM NOTIFICATION must be activated. You can then decide for each batch whether you want to receive
alarm notifications by e-mail or not (see "Alarms" on page 106). Note that to activate the e-mail alarm notification,
the e-mail server must be configured beforehand (see "E-Mail Server Configuration" on page 196).
The e-mail alarm notification is enabled for the specified e-mail address.
When you start a batch that you have created yourself, e-mail alarm notifications are automatically
subscribed to you.
8.2 Global
The GLOBAL menu contains settings that apply to the entire eve® system. Note that only users with the user level
Manager or System Administrator are able to change the global settings (see "User Roles and User Rights" on
page 177).
Batch settings
System settings
"Administrator E-
Enter the e-mail address of the responsible
ADMINISTRATOR E-MAIL ADDRESS Mail Address" on
system administrator.
page 191
"Automatic User
AUTOMATIC USER LOG-OFF (TIME Switch on/off automatic logoff of any user
Log-Off" on
INTERVAL) after a defined period of inactivity.
page 192
Data settings
"Custom Organism
Define custom metadata that can be
CONFIGURE ORGANISM METADATA Metadata" on
entered when adding a new organism.
page 200
3. Select all component checkboxes that should be selected by default when creating a report.
4. Click NEXT.
The parameter option screen appears.
5. Select all parameter option checkboxes that should be selected by default when creating a report.
6. Click SAVE to save your default batch reporting settings.
The default batch report settings are applied to the entire eve® system.
If a user wants to start a batch without filling out the necessary information, the execution is
blocked.
Password reset
Disc space monitoring
Password reset
The email address can be used for password requests in case a user cannot remember his/her password. The e-mail
address is shown when a user taps on the FORGOT PASSWORD? button on the login page.
To prevent data loss, it is necessary that there is always enough free disc space. To prevent the disc space from
becoming too low, the system monitors the available space on a weekly basis. If remaining disc space is lower than
50 GB and lower than 25 GB, an e-mail is sent to the e-mail address of the administrator defined in the global set-
tings. If no administrator e-mail address is defined in the global settings, the e-mail is sent to all other admin-
istrators that are active and have a valid e-mail address.
Note that compare views are not affected by this setting. Even if the option is enabled, compare views can still be
modified and stored individually.
8.2.7 IP Whitelist
The IP whitelist is a list of IP addresses you define as approved to start a batch or to make changes within a run-
ning batch. If this feature is activated, no client with an IP address other than those on the IP whitelist can be used
to start a batch or modify a running batch.
Note that the whitelist only affects running batches. Users with IP addresses not on the whitelist can still add
batches and modify planned batches. Users with IP addresses not on the whitelist are not allowed to perform the
following tasks:
To add a client (computer of a user) to the IP whitelist, the IPv4 address of the client is used. However,
if the eve® server (computer where eve® is installed) should be added to the whitelist, it is not pos-
sible to use the IPv4 address. To add the eve® server, always use the IP address 127.0.0.1, which cor-
responds to "localhost".
Note that you must be logged in on the eve® server to configure the whitelist. It is not possible to con-
figure the whitelist via a connected client.
To activate the function and to add entries to the IP whitelist, proceed as follows:
4. Click ADD IP ADDRESS.
5. Enter the IP addresses from which changes should be possible (e.g. "192.168.1.15" or "127.0.0.1" for the
eve® server).
6. Confirm by clicking SAVE.
The changes in the IP whitelist are saved.
At least 8 characters
At least one upper and one lower case character
At least one non-alphanumerical or numerical character
1. Go to SETTINGS > GLOBAL.
2. Select the HIGH SECURITY PASSWORD checkbox.
The new passwords will need to meet the requirements as mentioned above.
In addition, users are not allowed to reuse the last five passwords used. This is set by default and can-
not be changed.
To ensure that the e-mail alarm function works correctly, the configuration setup should be tested by
sending a test e-mail before users can use the function.
Please consider the General Data Protection Regulation (GDPR) according to the EU law when enter-
ing personal data (i.e. e-mail address).
If you want to change the behaviour of data export and fill the data gaps with the last measured value, proceed as
follows:
As an example, the table below shows how the two different settings influence the csv data export of temperature
time series:
0 29.37 29.37
0.8 30.03
1.0 30.03
1.2 30.03
1.4 30.03
1.6 30.03
4. Enter the name of your metadata information and select (if required) the unit(s).
5. Click SAVE to save your configuration.
The selection of the value in the UNIT field has the following effects:
- Select (no unit): Any value (numbers or letters) without unit can be entered.
- None: Any value (only numbers) without unit can be entered.
- Unit (e.g. °C): Value (only numbers) can be entered with the selected unit.
- Two or more units (e.g. g and ml): The unit can be selected from a dropdown list.
4. Enter the name of your metadata information and select (if required) the unit(s).
5. Click SAVE to save your configuration.
The selection of the value in the UNIT field has the following effects:
- Select (no unit): Any value (numbers or letters) without unit can be entered.
- None: Any value (only numbers) without unit can be entered.
- Unit (e.g. °C): Value (only numbers) can be entered with the selected unit.
- Two or more units (e.g. g and ml): The unit can be selected from a dropdown list.
The custom organism metadata are available when creating a new organism as well as when editing
an existing one.
4. Enter the name of your metadata information and select (if required) the unit(s).
5. Click SAVE to save your configuration.
The selection of the value in the UNIT field has the following effects:
- Select (no unit): Any value (numbers or letters) without unit can be entered.
- None: Any value (only numbers) without unit can be entered.
- Unit (e.g. °C): Value (only numbers) can be entered with the selected unit.
- Two or more units (e.g. g and ml): The unit can be selected from a dropdown list.
The custom culture media metadata are available when creating a new culture medium as well as
when editing an existing one.
8.2.16 Backup
eve® allows to create backups of the database with all entered and acquired data at a specific date and time. The
backup can be used to restore the database at a later time. This action will overwrite all the data in the database at
the moment of restoring. The backup contains all the data relative to:
Batch data
Libraries (recipes, organisms, culture media, compounds and soft-sensors)
Audit trail
User accounts
Devices and projects
Global and user-specific settings
By default, the backup (and restore) path is set to C:\INFORS-HT\backup. The location of the backup can be
changed manually to a local drive or to an external disc (external hard disc / USB drive). It is not possible to store the
backup on a network drive.
If you store the backup on the local drive of your computer, we strongly recommend to create an
additional backup of the folder where the eve® backup is stored.
To avoid data loss, we strongly recommend to store a backup each time before updating eve® to a
newer version.
Please note that the compatibility of the backups between different eve® versions cannot be assured.
To avoid data loss, we strongly recommend to save a new backup after every eve® update. Refer to
"Compatibility of software releases" on page 9 for information regarding compatibility of the dif-
ferent eve® versions.
Create backup
3. Confirm the message. Note that depending on the size of the data, taking a backup can take several hours.
Once the success message appears, the backup has been created and is stored in the defined backup loc-
ation. The file name consists of the date and time of the backup in the following format: yyyymmdd-
hhmmss.
The system allows you to create backups of the complete database at any date and time if no batch
is running.
The new path is saved automatically and will be used for further backups.
Restore backup
Restoring a backup will erase all current data in the database and replace it with the backup data.
This cannot be undone!
Besides creating a backup and restoring it on the same server, it is also possible to restore a backup taken on a dif-
ferent server. If different eve® versions are installed on both servers, note that not all eve® releases are compatible
with each other. Refer to "Compatibility of software releases" on page 9 for details.
1. Go to the folder where the backup has been stored (typically C:\INFORS-HT).
2. Copy the folder "Backup" (consisting of the backup files) to C:\INFORS-HT on the eve® server where the
backup should be restored.
3. Reboot the eve® server.
4. Restore the backup as described in "Restore backup" on the previous page.
8.3 License
The LICENSE section allows you the activation of packages (i.e. additional features), devices and the Software Main-
tenance option. Each package can be activated using a unique activation ID which either can be perpetual or sub-
scription. After a successful purchase of eve® or any additional package of eve®, you will receive an activation ID
for the corresponding license. Note that only users with the user level Manager or System Administrator are able to
activate a license (see "User Administration" on page 176).
To get access to the currently active licenses or to activate a new license, proceed as follows:
We release up to four major software upgrades per year that include new features and suggestions received from
our customers. With the Software Maintenance license you are entitled to the upgrades, updates and all bug fixes
that are released during the maintenance period. This allows you to keep the system up to date and benefit from
the newest features. Furthermore, the updates allow to ensure compatibility with the most current Windows ver-
sion.
The full compatibility of older eve® versions with Windows builds newer than the release date of the
respective eve® version cannot be guaranteed. As such the functionality of older eve® versions might
be impaired due to future Windows updates. Therefore, it is strongly recommended to have a valid
Software Maintenance license (naming before 2020 Q1 release: Software Support and Assurance) to
update the eve® installation to the most current version, before performing a Windows update.
Preventive maintenance
Your eve® server is analyzed from remote (e.g. Team Viewer), a precautionary clean-up is performed, and repair
recommendations will be documented. In case you need to transfer your data from an existing eve® installation to
a new eve® installation this can be performed as a part of the annual maintenance. If you want to benefit from this
annual service a 30-day notice in advance is mandatory.
Preventive maintenance requires the full access to the software. Therefore, the following pre-
requisites must be met so that preventive maintenance can be provided:
- The eve® server must be connected to the internet.
- Remote access to the eve® server must be possible.
- Team Viewer (or similiar tool) must be installed on the eve® server.
3. Enter the activation ID from the e-mail or pdf-file (copy and paste) into the Enter Activation Id field.
After the logout the new features will be activated with the next login.
3. Enter the activation ID from the e-mail or pdf-file (copy and paste) into the Enter Activation Id field.
8. Click either BROWSE COMPUTER and select the received file from the e-mail or drag and drop the received
file directly into the pop-up screen.
The selected file appears in the PENDING LICENSE ACTIVATION pop-up screen.
8.4 About
The ABOUT menu displays the current version of eve® the bioprocess platform software and further contact inform-
ation of INFORS HT. eve® the bioprocess platform software is a member of the "swiss made software" product
family.
9 Contact
Our Customer Service is at your disposal for technical advice and specialist enquiries. Furthermore, we are always
interested in new information and experiences resulting from user’s applications for the software that may be valu-
able for the continued development of our products.
Infors AG
Headoffice, Switzerland
Rittergasse 27
CH-4103 Bottmingen
eveSupport@infors-ht.com
Contact details of our subsidiaries and local dealers worldwide can be found on our website.
Whenever you have to contact any service and support, please specify the software version. The soft-
ware version can be found in menu SETTINGS > ABOUT.
10 Glossary
Actor
In contrast to sensor parameters, which only deliver measurement values, actor para-
meters control a particular component of the device (e.g. temperature, stirrer). Actor
parameters therefore can have a setpoint.
Actual value
Current value of a parameter, which is measured by a sensor and for control compared
with the setpoint of the corresponding actor parameter.
Alarm
Alarms are triggered when either a parameter value is out of range or a problem with a
device occurs (e.g. loss of connection). The alarm range is defined by upper and lower
alarm values which can be defined as fixed or dynamic.
Audit trail
Log containing every user action performed (e.g. create, start and stop batch, log-in,
log-out etc.). The audit trail allows to control and record all changes made in the soft-
ware.
Batch
An individual bioprocess configured in an experiment and assigned to a unit (e.g. biore-
actor vessel).
Batch strategy
A serie of defined phases intended to provide process control, including changing and
shifiting setpoints of process parameters, transition conditions and functions.
Cascade control
Hierarchically nested control loops, where the value of a parameter in the chain affects
the following parameter (e.g. automatic control of pO2 by adjusting the stirrer speed
and air supply).
Chart
Graphical visualisation of the batch that allows you to monitor and analyse a batch and
its parameters.
Client
A computer of a eve user that is connected to the eve server.
Compound
Ingredient of a culture medium (e.g. NaCl, KOH etc.).
csv
Comma-separated-values. File format typically used to exchange or store data. .csv files
can be opened with Excel, for example.
Custom function
The behaviour of the parameters can be affected and controlled by various predefined
mathematical functions. Besides the predefined functions, you can create your own cus-
tom functions using CS script.
Device
The physically present piece of equipment. In eve® devices can be added and managed
in the EQUIPMENT section. A device can have one or more units. Example: A Bioreactor
(device) with 6 vessels (units).
Device parameter
Parameter present on the device (e.g. temperature, pO2 etc.).
Dynamic alarm
Alarm whose limit values are dynamically adapted to the setpoint (e.g. alarm is triggered
when the temperature is ± 2 °C above/below the setpoint).
Equipment
General term for all devices that are connected to eve® and are used for carrying out
bioprocesses. This includes shakers, bioreactors, external pumps, scales, etc.
Experiment
Container that contains one or more batches. Each batch (single batch) or a group of
batches (multiple batch) is automatically assigned to an experiment.
Fixed alarm
Alarm whose limit values are fixed defined values, regardless of the set setpoint (e.g.
alarm is triggered when temperature falls below 35 °C or rises above 39 °C).
Function
A function is an algorithm that can be either in a phase or a soft-sensor and that defines
its behaviour.
Input
Input variables (also called independent variables) are the inputs to functions and can be
any rational number.
IPv4 address
Unique address of an individual computer, mobile device or network-enabled equip-
ment to identify the device in a network. An IPv4 address consists of four blocks with
numbers from 0 to 255 (e.g. 192.168.1.1).
License
The software license determines which features of the software you are allowed to use.
You can choose between the Basic, Standard and Premium license. In addition there is a
Software Maintenance license available, which gives you access to new software ver-
sions including new features and bug fixes as well as preventive maintenance support.
New licenses can be activated in the software using an activation ID.
Localhost
Domain name with which a locally installed internet server can be accessed. In this par-
ticular case, the localhost is the computer on which eve is installed. To address eve on
the eve server, the IP 127.0.0.1 is used.
Module
A measurement or control element of an individual unit or a logical grouping of para-
meters. A module can have one or more parameters. Example: Feed (module) with the
parameters "Duration", "Total volume" and "Pump factor".
NoSQL
Database systems that follow a non-relational approach. NoSQL databases do not
require a fixed schema, are more flexible and easy to scale. NoSQL databases are there-
fore particularly suitable for big data applications.
Offline parameter
Parameter whose value is delivered by a device that is not connected to the software.
The value is therefore entered manually by the user (e.g. when taking an offline
sample).
OPC
Standard that specifies the communication of real-time plant data between control
devices from different manufacturers ( e.g. the communication between a local con-
troller (PLC) and a SCADA package).
Output
Output variables (also called dependent variable) are the output of functions and can be
any rational number.
Parameter
Measurement and/or control circuit used for the bioprocess consisting of a sensor
and/or actor. Example: Temperature or Air flow.
Parameter type
The parameter type represents a device and can generate multiple parameters (e.g. exit
gas analyser which generates the parameters Exit O2 and Exit CO2).
Phase
A phase is a parameter dependent process condition and consists of functions (1 func-
tion per parameter, consecutive phases can have the same function for the same para-
meter).
Phase transition
Transition from one phase of the strategy to an other phase triggered by one or more
predefined conditions (e.g. time-dependent or parameter/signal-dependent).
Project
A project contains one or more experiments. Experiments can be grouped into a project
to structure and organise the batch data. When creating a new experiment, this can be
assigned to a project.
Quick start
A function which allows the user to start a batch quickly without any advanced con-
figuration.
Recipe
A user-defined configuration of a process involving elements such as device, organism,
culture medium, setpoints, phases and control strategies etc.
Refresh rate
Chart: Defines how often the system updates the data on the chart display. Device set-
tings: The minimal interval of time between two communication cycles with a specific
device.
Scripting method
Code block that can be added and managed in a dedicated library and called when writ-
ing the script for a soft-sensor or custom function.
Sensor
A sensor records and delivers information about physical parameters. A sensor para-
meter therefore cannot have a setpoint.
Server
Computer on which eve is installed and which the various clients access via the web
browser.
Setpoint
The target value of a parameter which the control system will aim to reach.
Soft-sensor
Computer program that calculates new information based on acquired batch data. It
uses data from parameters (inputs) in order to create information in the form of new
parameters (outputs). The signals are used for calculating additional actual process
information based on a specific algorithm. It is used for process monitoring, fault dia-
gnosis, as well as control applications.
Transition rule
Part of the strategy that operates as a trigger for the start of the next phase of the
strategy.
Unit
The part of a bioprocess device that can perform a bioprocess. In eve®, each batch has
to be assigned to one specific unit. A unit can have one or more modules. Example: Ves-
sel A of a bioreactor. A unit can also be a piece of equipment that can be bound to
another unit. Example: External balance.
eve® – 2021 H2
Bioprocess software
Version 1.123
info@infors-ht.com
eveSupport@infors-ht.com
TABLE OF CONTENTS
Table of Contents
1 About this Installation Guide 2
2 System Requirements 3
4 Procedures 9
4.3 Licensing 13
5 Troubleshooting 16
6 Contact 18
The following sections give an overview about the conventions used in this user guide.
To highlight warnings, important information or application examples, they are presented as follows:
This symbol indicates a hazardous situation which could result in malfunction of the software and/or
data loss.
This symbol indicates a simple application example for a function or setting in the software and indic-
ates an easy solution for a specific demand.
Text conventions
The following designations are used to indicate instructions, results and elements on the user interface:
Active (clickable) elements on the user interface of the software (e.g. buttons or tabs) are shown in bold
letters.
Passive (not clickable) elements on the user interface (e.g. menu titles) are shown in italic letters.
Actions to be carried out are indicated with a numbered list (1. 2. 3.).
Results of actions are indicated with an arrow ( ).
Images
All images showing the various menus, dialogue boxes and pages of eve® the bioprocess platform software reflect
the view of a user with the user role Manager with Premium software license. Please note that the images aid gen-
eral understanding. Due to potential changes in the software, these may differ from the actual graphical user inter-
face.
2 System Requirements
Hard drive: SSD or SAS. Please consider 400 MB to 1 GB per batch per week for data storage capacity. The
volume of the batch depends on the number of parameters and logging rate of the device.
Please note that a minimum of 20 GB free space on the hard drive is required for installation and
update. Also, make sure there is always at least 20 GB of free space available while eve® is running
and being used. Otherwise the correct functioning of the software will be impaired.
Category Requirements
Memory 16 GB RAM
Category Requirements
Processor Intel i7 (at least 6th gen.), i9 or Xeon with at least 4 cores / 8 threads
Category Requirements
For simultaneous multiuser acces (approx. > 6 users/devices) industrial, endurance approved hard-
ware components are mandatory.
Please note that eve® is designed as a server application. Therefore certain processes are deployed as
a service and will be started automatically. To provide high performance to the hosted databases
RAM of the server is reserved for eve® only.
Windows 10 Pro/Enterprise
Windows 11 Pro/Enterprise
Windows 2016 Server
Windows 2019 Server
The target machine must be updated with the latest available Windows updates before installation.
For simultaneous multiuser access (approx. > 6 users/devices) Windows Server is mandatory. Fur-
thermore, please avoid any additional applications that are using a lot of resources (CPU, memory,
I/O, Bandwidth etc.).
Please mark at least the following processes as trusted processes and exclude them from antivirus scanning:
Raven.Server.exe
elasticsearch-service-x64.exe
w3wp.exe
inetinfo.exe
Microsoft shared\Web Server Extension\12\Data\Applications\
Microsoft shared\Web Server Extension\12\Logs\
C:\INFORS-HT
Please note that the software is not compatible with touch monitors.
eve® is tested and approved with Google Chrome. Technically any other web browser can be used.
However, for best performance we recommend the use of Google Chrome.
The installer also installs the prerequisites necessary to install and run eve® if they are not available:
.NET 4.7.2
Java
Windows PowerShell
Internet Information Service (IIS)
RavenDB as Windows Service
ElasticSearch as Windows Service
After successful installation the following folder will be installed on the computer:
C:\INFORS-HT
To prevent any mishandling of the directory where the eve® data is stored, Windows login author-
isation is recommended.
To lock any configuration on the local time settings of Windows, restriction of changing the time by
any user is recommended.
Please ensure that all power saving, sleep and hibernate settings (and screen saver) are turned off in
Windows.
Port 80 (HTTP)
Port 8080 (OPC communication to devices)
Note that if you are going to add third party devices, the used ports of the respective device have to be opened in
addition to the mandatory ports mentioned above.
4 Procedures
3. Tick the I accept the terms in the license agreement checkbox and click Next at the bottom of the License
Agreement screen.
A warning screen appears, notifying you that it is strongly recommended to perform a backup before
updating eve®.
The default web browser of your operating system starts and the eve® login screen appears.
Username: Administrator
Password: Administrator
Administrators are only allowed to manage the equipment and user accounts. Full feature access is
exclusively activated for users with a role as a Manager or User.
4.3 Licensing
For activating the purchased packages of eve® the bioprocess platform software, please follow the instructions in
the eve® User Guide.
With release 2020 Q2 the databases (RavenDB and Elasticsearch) have been upgraded. This must be considered
when updating the software or restoring backup data, as this means that not all eve® releases are compatible with
each other. Pay attention to the following:
It is not possible to update a release 2020 Q1 or older directly to a release newer than 2020 Q2 R1. In this
case, you first have to update eve® to 2020 Q2 R1 and then from 2020 Q2 R1 to the desired release newer
than 2020 Q2 R1.
After performing an update we strongly recommend to store a backup of the database. This is necessary, as
backups created with an older software version may no longer be usable after the software update.
Backup files created with version 1.73 or later can be restored in version 2020 Q1 or older. Backup files cre-
ated with version 2020 Q1 or older cannot be restored in version 2020 Q2 or later. Therefore, after updat-
ing to version 2020 Q2, it is strongly recommended to store a new backup file.
To
Backup and Restore Data
≤ 2020 Q1 ≥ 2020 Q2
If you perform an update, make sure that version 1.79 or later is installed. If you have an earlier version,
please contact eveSupport@infors-ht.com.
Once you have started the installation of eve®, do not try to install an earlier version, even if you deinstalled
the current version or if the installation was unsuccessful.
If you perform an update from 1.85.408 or earlier, it is recommended to delete all devices on the equip-
ment page and to reinstall them after the update to activate equipment specific features.
Since version 1.92.492 the INFORS HT Multitron driver is needed to add a Multitron to eve®. Multitrons
added in previous versions will still work without driver. The driver is available in the ZIP file and must be
installed on the eve® server.
The eve® installation must have a valid Software Maintenance license (naming before 2020 Q1 release: Soft-
ware Support and Assurance). Otherwise the installation process will be canceled automatically.
Make sure there is no batch running during the update procedure.
Update procedure
To avoid data loss in case something goes wrong during the update procedure, we strongly recom-
mend to store a backup of the databases before starting the update procedure. To do so, go to
SETTINGS > GLOBAL and select BACKUP. For details refer to the eve® User Guide.
2. Follow the same instructions as for the first installation (see "First Installation" on page 9).
1. Click on the eve® Setup.exe file which was originally used for the first installation.
The Program Maintenance screen appears.
5 Troubleshooting
To enable eve® to be able to use email accounts that require MFA, we recommend white-listing the IP range. This
will allow authentications from eve® to bypass MFA while preserving normal MFA functionality for authentication
requests not originating from eve®.
The following description uses as example Microsoft Azure to explain how the MFA exceptions can be defined. The
procedure for other cloud platform providers (e.g. Google Cloud) works similarly.
Please note that the procedure described below is as of November 2021 and may become outdated.
Configuration
Microsoft Azure has two levels of MFA configuration. Depending on your environment, you may need to configure
one or both to properly enable MFA white listing.
1. Login to https://portal.azure.com.
2. Select Azure Active Directory from the navigation pane.
3. Select Conditional Access under the Security heading on the Azure AD navigation pane.
If you do not have any policies enabled for MFA, you do not have to make any changes and can stop
here. If you still want to create a new policy and don’t have any existing MFA policies, skip the
Exclude Accounts from MFA Policy step.
Validate Policy
1. Click the What If button at the top of the conditional access policy list.
2. Click User and select the account you want to test.
3. Enter "x.x.x.x" in the IP Addresses textbox.
4. Select x from the Country dropdown.
5. Click the What If button.
6. If any policies display in the Policies that will apply tab, click on them and validate that they do not require
MFA.
7. Change the IP Addresses value to "x.x.x.x".
8. Click the What If button.
9. You should see the policy you created in the previous section in the Policies that will apply tab.
6 Contact
Our Customer Service is at your disposal for technical advice and specialist enquiries. Furthermore, we are always
interested in new information and experiences resulting from user’s applications for the software that may be valu-
able for the continued development of our products.
Infors AG
Headoffice, Switzerland
Rittergasse 27
CH-4103 Bottmingen
eveSupport@infors-ht.com
Contact details of our subsidiaries and local dealers worldwide can be found on our website.
Whenever you have to contact any service and support, please specify the software version. The soft-
ware version can be found in menu SETTINGS > ABOUT.
Infors AG
Rittergasse 27
CH-4013 Bottmingen
www.infors-ht.com
info@infors-ht.com