Trial match to cohort to dataset
This scenario demonstrates how to screen patients against clinical trial eligibility criteria, save the resulting patient list as a reusable cohort, build a dataset from that cohort, and share the cohort or dataset with the study team.
Best for: trial feasibility and recruitment planning.
Step 1: Match patients against a trial
- In the left navigation, go to Agents and Tools > Clinical Trial Matcher.
- Start a new trial matching workflow.
- Search for a clinical trial by trial identifier, title, condition, intervention, sponsor, or keyword.
- If a custom study is being evaluated, paste the trial eligibility criteria into the matcher.
- Review the parsed inclusion and exclusion criteria.
- Confirm which criteria can be evaluated against the available patient data.
- Adjust or remove criteria that are not relevant to the local screening workflow, where criteria editing is available.
- Select the target patient population or source scope for matching.
- Start the trial matching process.
- Wait until the trial job status is Completed.
- Review the resulting patient list.
Step 2: Review match results and save matching patients as a cohort
- Open the completed trial matching results.
- Review the included, excluded, and potentially eligible patient groups.
- Inspect the criteria-level explanations for a sample of matched and excluded patients.
- Confirm that the match logic aligns with the intended feasibility or recruitment use case.
- Select the patients that should be saved for follow-up review.
- Click Create Cohort to begin cohort creation.
- Enter the cohort name, description, category, and any linked cohort information.
- Use a clear name that references the trial or study objective.
- Review the cohort configuration and patient count.
- Click Create Cohort to save the matched patient cohort.
Step 3: Build a dataset from the trial cohort
- In the left navigation, go to Data Curation Studio > Dataset Builder.
- Select Cohort & Clinical Filter as the dataset mode.
- Select the data type required for study review, such as Unstructured for clinical notes and reports.
- Click Next to continue to Cohort Selection.
- Select the trial cohort created from the matching results.
- Click Next to continue to the criteria step for the selected data type.
- Apply document filters to include the evidence needed for screening, such as pathology reports, oncology notes, radiology reports, medication records, procedure notes, or lab-related documents.
- Click Next to continue to Dataset Details.
- Enter the dataset name and description.
- Use a name that clearly links the dataset to the trial or feasibility review.
- Click Next to continue to Review Dataset.
- Review the selected cohort, document filters, data types, and expected dataset contents.
- Click Create Dataset to create the dataset.
Step 4: Review documents or run extraction to support screening
- Open the created dataset from Dataset Explorer.
- Review the included patients and supporting documents.
- Confirm that the dataset contains the evidence needed to validate key eligibility criteria.
- Open patient documents where manual review is required.
- If targeted evidence needs to be extracted, run Information Extraction on the dataset for trial-relevant facts such as biomarkers, stage, prior therapies, disease progression, lab values, or performance status.
- Review extraction results before using them for screening decisions.
- Use extracted facts as reviewer context or to refine the dataset, depending on the supported workflow.
- Document any criteria that cannot be evaluated from the available data.
Step 5: Share the cohort or dataset with the study team
- Review the saved cohort and dataset before sharing.
- Confirm that the patient list, evidence scope, and document filters match the study-team request.
- Share the cohort with the study team.
- Share the dataset with the study team when deeper document review is needed.
- Provide the study team with the cohort, dataset, extracted evidence, or review notes according to the approved team workflow.
Recipe reference
Each stage of this scenario is also a standalone recipe you can reuse in other workflows.
Match patients to a clinical trial and reuse the cohort
When to use on its own: For trial feasibility, recruitment planning, or oncology demo scenarios.
Features involved: Clinical Trial Matcher, Cohort Builder, patient list review, saved cohorts.
Edge cases / limitations: Some trial criteria are too vague or unavailable in the source data. Results may need clinical validation.
Value: Moves trial feasibility from manual chart review toward a repeatable screening workflow.
Build a dataset from a cohort or ingestion results
When to use on its own: After ingestion and before Data Curation, Information Extraction, or De-Identification.
Features involved: Dataset Builder, Dataset Explorer, cohort filters, ingestion-result filters, dataset preview.
Edge cases / limitations: Data Curation and De-Identification require a dataset; a cohort alone is not enough. Too broad a dataset makes downstream jobs slow or noisy; too narrow risks missing evidence.
Value: Gives you a controlled, reusable work package instead of repeatedly selecting raw records.
Run Information Extraction on a dataset
When to use on its own: When you need targeted extraction such as biomarkers, pathology details, staging terms, adverse events, or custom clinical facts.
Features involved: Information Extraction, custom extraction profiles, extraction run history, result review and export.
Edge cases / limitations: Extraction quality depends on source document quality and field definitions. Results should be reviewed before customer-facing or clinical use.
Value: Lets you quickly discover useful facts before committing to a larger curation workflow.