Knowledge Base for Supply App
Initial state setup
TheĀ Initial stateĀ setup is the only one that is not mandatory to define in order to run simulations.Ā It can be modified by Advanced Users and Power Users.Ā
The data can either be defined by the user from scratch or imported from the IRT database (see theĀ IRT ConnectionĀ section for more information).
Simulation start date
TheĀ Simulation start dateĀ tab lists the date from which all the following data should be considered.
If the data is coming from an IRT extract, this date will be the date on which the extract import was performed.
When running simulations, everything that is prior to the simulation start date will be considered as part of the past, and not simulated. This means that if a release in theĀ Production setupĀ is defined before the simulation start date, it will be ignored as the kits of that release should already appear in the inventories.
Sites
TheĀ SitesĀ tab contains information on sites used in the trial, including their status (open or closed). You can define sites as āclosedā in the āSites status (for simulations)ā column (see image below). This allows the system to ignore these closed sites in the simulations, e.g. if the recruitment is stopped at this site.
- TheĀ āopen/closedā statusĀ will be used during the simulations and it isĀ not coming from the IRT data extract. It needs to be defined manually.
- By default, all sites are set as āOpenā in the āSite status (for simulations)ā column.
To easily identify potential sites to close, you can use the āActive patientsā column (see image below).Ā A site can be closedĀ only if there are no active patients in it. For example, if a site is not recruiting anymore, but there are active patients still receiving treatment there, that siteĀ cannotĀ be closed.
The āNon-expired kitsā column (see image below) gives you information on the potential loss of kits if a site is closed.
You can filter the table and display only sites without active patients, and then use the edit bulk to close all of them.Ā
In the simulations, the following information is considered:
- New patients, dispensing and buffer replacements are not predicted at closed sites anymore.
- The information about how many sites have been opened and closed is kept and the system prevents to open new sites when the expected number of sites has been reached. For example, 5 sites are expected to be activated in Belgium. If 2 open sites and 1 closed site are defined in the initial state, the system is going to take all of that information into account, and therefore, it is going to open only 2 extra sites.
- Patients linked to a closed site are still counted as part of the recruitment assumptions and recruitment constraints.
- Patients and inventories which are in the initial state and linked to closed sites, can be kept without triggering any error message.
- Complete site group history (open and closed sites) is used in the reevaluation of patient attributes, dropouts and titrations.
Sites inventories
ThisĀ tab shows the current inventories in the active sites. Lot number, expiry date and quantity are defined for each package type in the inventory of a site. The sites in this section should already be defined in theĀ Sites groupsĀ tab.
Depot inventories
ThisĀ tab shows the current inventories in the depots. Lot number, expiry date and quantity are defined for each package type per depot.
You canĀ identify kits that are still in transit to the depots/sitesĀ with theĀ StatusĀ column (in theĀ Site inventoriesĀ andĀ Depot inventoriesĀ tables).
Only the āAvailableā and āAwaitingā statuses are displayedĀ (see image below) given that the others are not used in the simulations.
If you are modeling your depot shipments for a plan that has āAwaitingā stocks at local depots (in the Initial state), a warning banner will inform you about the depots for which the kits are not available yet (see image below).
ā Good practice for more accuracy in your results: To avoid those āAwaitingā kits to be shipped by the system before they are available, you can move your stocks back to the supplier depot and create a reserved shipment.
Patients
TheĀ PatientsĀ tab shows the current status of all patients registered in the trial. On top of the patients table is a summary on the patients statuses showing:
- The total number of patients registered in the trial.
- The number of patients still active.
- The number of patients that discontinued the treatment.
- The number of patients that completed the treatment.
- The number of patients that were randomized.
In the table, the following information are available for each patient currently in the trial:
- The site where the patient was enrolled (defined inĀ Sites groupsĀ tab).
- The associated site group
- The patient group
- The patient attribute (e.g. weight group)
- The stratum
- The status: you can give a specific status (active, discontinued or completed) to a patient.
- The last visit date
- The last visit
- The treatment arm
- The current dose level
- The baseline visit date
- The screening date
- The randomization date
- The completion date
- The number of consecutive visits on the same dose level, prior to the last know dose level. This information will be useful to know if prediction should be used right away for the patient.
- The site group isĀ only displayed for initial states created as of the 2024.4 versionĀ of the Supply App.
- The Supply App does not use the site group information when running the simulations. Therefore a blank space or the wrong site group will not have any effect on the results.
