Using IVART online

To use IVART online, please register on the WWARN website and then log in to use the tool.

Preparation of data

Correct data management and preparation is crucial for successful use of IVART Online. Data for IVART online processing must:

  • be organised in a 96-well plate format with 8 horizontal rows and 12 vertical columns.
  • be annotated by a system of “Tags” to identify results plates and drug layouts
  • include at least two drug-free controls on each plate
  • be saved in Microsoft Excel 2007 format (.xlsx)

 

“Tags” are strings of text placed in the cell immediately below and to the right of the cells corresponding to a 96-well plate of results or drug concentration data. Tags are critical to defining the location of a plate and ensure that results are matched correctly with drugs and concentrations. Result tags contain information about samples and the study (Table 1).

 

table4IVART

Variable in the result tag

Description

Value

ID1

Sample ID1

Required

ID2

Sample ID2

Optional

Date

Date of sampling from patient (dd/mm/yyyy)

Optional

DrugLayout

Name of Drug concentration layout

Required

Country

Country patient infected

Optional

StudySiteName

Location of study

Optional

Method

Readout method + duration of test

Optional

Lat

Latitude

Optional

Lon

Longitude

Optional

SampleType

Reference clone

Required only for references; leave blank for field isolates

Batch

Date of preparation of drug plate batch (dd/mm/yyyy)

Optional

 

There are two options to prepare data files for IVART analysis:

  1. Copy & Paste data into the IVART Data Template – an easy solution in order to immediately begin your analysis and a helpful step that allows for data organisation in prospective studies.
  2. Add tags to identify drug concentration layouts and result plates in your own data files according to the Example Tagging file. Users who become familiar with this more complex approach can process large datasets more quickly.

 

IVART Data Template

In the sheet Drug concentration Layouts of the IVART data template, the drug and its concentration (nM) in each well of the 96-well plate is specified. The layout can be adapted to your specific data set, organised by column or row, with increasing or decreasing concentrations. More than one drug concentration layout with its own unique name may be added. The template automatically generates a drug layout tag seen in the dark blue cell used by IVART to extract data (Fig. 1). The layout only has to be created once.

 

using-ivart-f1_0 .png

Figure 1: Defining your drug concentrations in the IVART data template

 

In the sheets Results Isolates and Results References the test results (i.e. counts per minute, absorbance, microscope count etc.) are pasted in the 96-well format for each drug and concentration. Information relevant for each plate, sample, and study can be entered in the white cells to the left of the plate. The template will automatically generate the plate tag (dark blue, lower right) when the variables Sample ID1 and DrugLayout, required for IVART analyses, are filled in (Fig. 2).

using-ivart-f2_0.png

Figure 2: Copy and paste test results and enter plate information in the IVART data template

 

Tagging data in an existing file

To specify the drug concentration used in each 96-plate well, a drug concentration layout worksheet is created following the Example Tagging file. The tag “DRUG-LAYOUT:NAME” is placed in the cell immediately below and to the right of the drug concentration layout. The Drug-Layout tag defines an area of 12 columns x 8 rows from which IVART extracts drug concentration values (in nM).

using-ivart-f3_0.png

Figure 3: Creating a drug concentration layout when tagging your data

 

Result plates are annotated by adding a tag in the lower right corner of the each plate - N12 in Figure 4. The tag can be copied from the Example Tagging file and it contains references to cells where information about the sample and study is located or can be filled in. The function of the tag can be changed to retrieve values from different cells and to have default values.

using-ivart-f4_0.png

Figure 4: Tagging the result plates in your data file by using the tag in the Example file

Data Upload and Analysis

Tagged data files can be uploaded to IVART and will be securely stored on WWARN’s servers where the access is limited to the user. The Plate Assistant provides feedback on any tagging errors, helping IVART to extract data correctly. It highlights problems with the file organisation that should be resolved before the file can be analysed and it issues warnings of inconsistencies in the data file. Once the data is ready, it can be analysed. A data set with a thousand assays can be processed within five minutes; the results are available for immediate download.

Selected data sets can be shared with WWARN through the IVART online system. It is not a requirement to share data with WWARN to use IVART Online. Details regarding the use of IVART Online are specified in the Terms of Use and in the Step-by-step User Guide available to download.