Configure Mixtures

You will need to configure Mixture schemas in the Registry prior to beginning to use Mixtures functionality in the platform. When creating a new schema, you will see a Mixture option under the Entity Type dropdown. 

Configuring Mixtures in the Registry

The schemas outlined below is one recommendation of how to configure Mixtures. Depending on your specific needs, an alternate design may work better for your organization. At the most basic level, you will need two Mixture schemas and one other schema type that you will categorize the ingredients of your mixtures.

Example configuration:
A Recipe schema will capture the list of ingredients and their respective ideal quantities for a mixture. This will have an Entity Type of Mixture. The ingredients and respective quantities in the Recipe schema should represent the theoretical mixture that will be used to make a preparation of a mixture in lab. For example, HBS Buffer could be registered as a recipe entity.

• Build a new schema to represent your Recipe.

• Entity Type: Mixture

• Add relevant metadata fields that you would like to track against a theoretical mixture Recipe, such as:
  - Expected Recipe characteristics, such as pH or osmolarity
  - Expected use

A Preparation schema will capture the list of ingredients and their actual quantities used by scientists in lab to create the mixture. This will have an Entity Type of Mixture. The ingredients and respective quantities in the Prep schema should represent what was actually used to make a preparation of a mixture in lab. For example, HBS Buffer Lot could be registered as a preparation entity.

• Build a schema called Preparation

• Entity type: Mixture

• Check the Allow recording measured values for ingredients box directly below the Entity Type field. This setting enables users to log the actual quantities of ingredient used when making a prep of a mixture in lab.

• Create a metadata field to link to the Recipe. Make the field format an Entity Link to the previously created Recipe schema. Check the boxes for the Required column and the Parent Link column.

• Add other relevant metadata fields that you would like to track against a specific preparation of a mixture, such as
  - Expiration Date
  - Description
  - Final pH value

Note: It is recommended to name Recipe and Preparations similarly. To have Benchling do this automatically and systemically, we'd suggest enforcing a naming template.

A Components schema will be used to log the specific ingredients and components that can be used in Mixtures. This will have an Entity Type of Custom Entity. For example, NaCl and deionized water could be registered as component entities.

It is important to note that, though you can create a component-specific schema, you are also able to use entities of existing schemas as ingredients in your recipes. For instance, if you already have a schema for stock chemicals, you can use those entities as ingredients. You can also use entities from different schemas as components.

Build a schema called Components:

• Entity type: Custom Entity

• Add relevant metadata fields that you would like to track against an ingredient, such as Vendor (Text / Dropdown) and CAS # (Text)

• Note: catalog # and lot text can be recorded within the Mixtures feature itself and do not need to be included as metadata fields.You can import components in bulk following instructions in this help article

Registering New Mixtures

A. In the UI, register new entities under the Components entity schema. These entities will represent the ingredients used in Recipe entities.

1. Navigate to the Registry > ‘+’ > Entity from Schema > Component. For example, if you typically use DMEM and FBS to create some cell culture media, DMEM and FBS would be registered as entities under the Components schema

2. All ingredients for all Recipe entities should be captured as entities under the Components entity schema

B. Register a new Recipe entity under the Recipe entity schema. Add the ingredients used in the recipe (the registered Components entities) within the Components section of the Metadata tab of the Recipe entity.

1. Navigate to the Registry > ‘+’ > Mixture > Recipe

2. Navigate to the Components section of the Metadata tab > ‘+’ > Add the relevant Component entities previously registered

3. Record the Catalog # for each Component, the Target Amount that is recommended when making the Recipe, and add Units using the dropdown

C. Register a new Preparation entity under the Preparation schema. Fill in the Recipe Entity Link field with the Parent Recipe.

1. Navigate to the Registry > ‘+’ > Click Mixture > Preparation

2. Specify the Recipe that you will be following to create this Preparation

3. Specify the total quantity of the preparation you would like to make using the Target Amount field
   - In the Prep Ingredients table, see that all components were automatically hoisted by Benchling from the values specified in the Parent Recipe entity
   - All component quantities and units were hoisted and calculated by Benchling from the specified Parent Recipe entity and the specified Target Amount

4. In the Prep Ingredients table, select Edit to update fields related to each component
   - Use the Measured Amount field to record the actual quantities of each component that was added to the mixture preparation
   - Use the Lot Text field to include information on the lot number of the specific component being used for the mixture preparation
   - Use the Note field to include any other desired information

Recording Mixture Preparations in the Notebook

When creating mixture preparations that are relevant to an experiment or specific entry, you can record the mixture preparation directly in the Notebook. Please see this help article for information on how to use our Mixture Prep tables in Notebook entries.