Visits and timepoints are similar methods of dividing collected data into sequential buckets for study alignment and data analysis. A study will be defined to use one or the other, and the process is similar for creating and working with either method.

A timepoint is a range of one or more days in a study. For instance, you might use weeks or months, defining timepoints of 7 or 30 days respectively.

A visit uses sequence numbers to order data and can be defined as a single number or a range. For example, a study may assign a given physical exam the sequence number 100, but if the whole exam cannot be completed in one day, follow-up information is to be tagged with sequence number 100.1. Data from both of these sequence numbers can then be grouped under the same visit if it is defined as a range such as 100-100.9.

Create a Visit or Timepoint

  • From the Study Dashboard, select the Manage tab.
  • Click Manage Visits (or Manage Timepoint).
  • Click Create New Visit (or Timepoint).
  • Define the properties of the visit or timepoint (see below).
  • Click Save.

Visit Properties

  • Label: Text name for this visit. This label will appear in the Study Overview.
  • VisitId/Sequence Range: Each row of data is assigned to a visit using a sequence number. A visit can be defined as a single sequence number or a range. When viewing the study schedule, the first value in the range is displayed along with the visit label you define.
  • Protocol Day: The expected day (sequence number) for this visit according to the protocol, used for study alignment.
  • Description: An optional short text description of the visit which (if defined) will appear as hover text on visit headers in the study navigator and the visit column in datasets.
  • Type: Visit types are described in Import Visit Map.
  • Visit Handling (advanced): You may specify that unique sequence numbers should be based on visit date. This is for special handling of some log/unscheduled events. Make sure that the sequence number range is adequate (e.g #.0000-#.9999)
  • Show By Default: Check to make this Visit visible in the Study Overview.

Timepoint Properties

  • Label: Text name for this timepoint.
  • Day Range: Days from start date encompassing this visit, i.e. days 8-15 for Week 2.
  • Protocol Day: The expected day for this visit according to the protocol, used for study alignment.
  • Description: An optional short text description of the visit which (if provided) will appear as hover text on visit headers in the study navigator and the timepoint column in datasets.
  • Type
  • Cohort
  • Show By Default: Check to make this timepoint visible in the Study Overview.

Associate Datasets and Visits or Timepoints

To mark which datasets are required for which visits or timepoints, use the Study Schedule view.

  • From the Manage tab, click Study Schedule.
  • Click the radio buttons at the intersection of dataset/visit pairs you want to define as requirements.
  • Click Save Changes.

You can also use the following pathways which may be more convenient in some cases.

Map Datasets to Visits

To specify which datasets should be collected at each visit:

  • From the Manage tab, click Manage Visits.
  • Click the edit link for the desired visit.
  • For each associated dataset listed, you can select Required or Optional from the pulldown.
  • Click Save.

Map Visits to Datasets

To specify the associated visits for a dataset, follow these steps:

  • From the Manage tab, click Manage Datasets.
  • Click the label for the dataset of interest.
  • Click the Edit Associated Visits button.
  • Under Associated Visits, specify whether the dataset is required or optional for each visit. By default, datasets are not expected at every visit.
  • Click Save.

Visit Dates

A single visit may have multiple associated datasets. The visit date is generally included in one or more of these datasets. In order to import and display your study data correctly, it's necessary to specify which dataset, and which property within the dataset, contains the visit date. Alignment of visit dates is also helpful in cross-study alignment.

Once one or more datasets are required for a given visit, you can specify the visit date as follows:

  • From the Manage tab, click Manage Visits.
  • Edit the visit.
  • From the Visit Date Dataset pulldown, select the dataset (only datasets marked as required are listed here.
  • Specify a Visit Date Column Name. The date in this column will be used to assign the visit date.
  • Click Save.

For a timepoint-based study, if the dataset has a column of type Integer named "Day", "VisitDay" or "Visit_Day", then that value will be stored as the VisitDay.

Protocol Day

The Protocol Day is the expected day for this visit according to the protocol, used for study alignment. It cannot be set explicitly when defining new visits or timepoints, but can be edited later. For a date-based study, the default protocol day is the median of the timepoint range. For a visit-based study, the default is 0.

Related Topics

discussion

Discussion

Search 

Pages 

previousnext
 
expand all collapse all