In a study, data is collected over time for subjects or participants. In some cases the exact date of collection is relevant, in others the elapsed time between collections matters more, and in still others, the sequence is more important than either of these. There are two methods of organizing study data into time-based "buckets" for analysis. For information about studies which do not require such buckets, see Continuous Studies.
  • Visits: Data is organized by sequence number provided into a series of defined visits or events. Visit based studies do not need to contain calendar date information, nor do they need to be in temporal order. Even if the data collection is not literally based on a person visiting a clinic a series of times, sequence numbers can be used to map data into sequential visits regardless of how far apart the collection dates are.
  • Timepoints/**Dates**: A timepoint is a range of dates, such as weeks or months, rather than a literal "point" in time. The interval can be customized, and the start-date can be either study-wide or per-participant. For example, using timepoints aligned by particpant start date might reveal that a given reaction occured in week 7 of a treatment regimen regardless of the calendar day of enrollment.


When setting up a visit-based study, you define a mapping for which datasets will be gathered when. Even if your study is based on a single collection per participant, we recommend that you still define a minimum of two visits for your data. One visit to store demographic data that occurs only once for each participant; the second visit for all experimental or observational data that might include multiple rows per participant visit, such as in the case of results from two rounds of tests on a single collected vial.

You have two options for defining visits and mapping them to datasets:

  1. Create Visits. Manually define visits and declare required datasets.
  2. Import Visit Map. Import visit map XML file to quickly define a number of visits and the required datasets for each.
You will continue associating visits with datasets when you upload unmapped datasets or copy assay datasets.

Note: Visits do not have to be pre-defined for a study. If you submit a dataset that contains a row with a sequence number that does not refer to any pre-defined visit, a new visit will be created for that sequence number.


When you define a study to use timepoints, you can manually create them individually, or you can specify a start date and duration and default timepoints will be automatically created when datasets are uploaded.

There are two ways timepoints can be used:

  • Relative to the Study Start Date: All data is tracked relative to the study start date. Timepoints might represent calendar months or years.
  • Relative to Participant Start Dates: Each participant can have an individual start date, such that all data for given participant are relativized to his/her individual start date. On this configuration, timepoints represent the amount of time each subject has been in the study since their individuals start dates, irrespective of the study's overarching start date. To set up: Include a StartDate column in a dataset marked as demographic.
For example, the Tutorial: Set Up a New Study defines 28-day timepoints automatically based on each participant's individual start date using the Demographics dataset. The relevant items in the dataset definition are circled in red:

Related Topic





expand all collapse all