First Trial

Introduction

A trial is an experiment involving one or several factors (Genotypes, Products, etc.) in a specific environment (Growing Area) to evaluate certain traits (Variables). This guide will walk you through the process of creating your first trial in Bloomeo.

Prerequisites

Before creating trials, ensure you have the following:

  1. A minimal set of hierarchies (Geography, Organization, and Species). See Core Entities for more details.
  2. A set of genotypes or products to test. See Germplasm for more details.
  3. (Optional) A growing area to define the environment of your trial. See Growing Area for more details.

Create Your First Trial

  1. Use the POST /trial endpoint of the experiment service to create a trial.

    {
    "name": "Demo",
    "startDate": "2025-02-28T23:00:00.000Z",
    "endDate": "2025-03-07T23:00:00.000Z",
    "speciesV2": [["Forages"]],
    "quantityUnit": "seeds",
    "geography": [["France"]],
    "organization": [["BU1"]],
    "plannedExperimentalDesign": "NONE",
    "plannedNbReplications": 1,
    "expFactorType": "MONO_FACTOR_GENOTYPE"
}
    Optional linked entities

    A trial can be linked to many optional entities (such as users, partners, growing areas, market segments, etc.). If needed, first get the ID of the entity.

  2. Link an observation template:

    1. Get existing observation templates using the GET /template-observation endpoint of the experiment service.
    2. Link the chosen template to the trial using the PATCH /trial/{trialId}/template-observation endpoint of the experiment service. Example:
      {
    "refId": "67039e2c7da5159254c50940", // ID of the observation template
    "variablesPool": [
        {
            "variableId": "670386045dbb38613a214ada", // ID of the variable
            "scope": 2,
            "origin": "TEMPLATE_OBS"
        }
    ],
    "templateObsUnits": {
        "plot": [
            {"variableId": "670386045dbb38613a214ada", "scope": 2}
        ]
    }
}

  3. Link genotypes or products:

    1. Get existing genotypes or products using the GET /germplasm endpoint of the germplasm service.
    2. Link the chosen ones to the trial using the PATCH /factors/Trial/{trialId}/factors endpoint of the experiment service. Example:
      [
    {
        "type": "GENOTYPE",
        "modalities": [
            {
                "subModalities": [
                    {
                        "refId": "67470d0bcd56425157e21ab3", // ID of the genotype or product
                        "modalityIndex": 0,
                        "genotypeName": "Geno demo",
                        "materialScope": "Organizational Material",
                        "organization": [["BU1"]],
                        "localStage": "Stage 1 - Pre Breeding" // from Pick list of type local_stage
                    }
                ],
                "shortId": "G1",
                "isControl": true
            }
        ],
        "currentModaCodeIndex": 1
    }
]

  4. Link a growing area:

    1. Get existing growing areas using the GET /growing-area endpoint of the growing area service.
    2. Link the chosen one to the trial using the PATCH /trial/{trialId} endpoint of the experiment service. Example:
      {
    "growingAreaId": "668bedf732f89fe362572b03" // ID of the growing area
}

  5. Change the status of the trial to planned using the PATCH /trial/{trialId} endpoint of the experiment service. Example:

    {
    "status": "planned"
}

Next Steps

  1. Plan and assign tasks
  2. Collect data through Notations
  3. Analyze the results
  4. Set conclusions and recommendations