Skip to contents

Planning an experiment follows a reproducible routine:

  1. Load required libraries: Load inti, knitr, and dplyr packages.
  2. Define factor levels: Set up lists with genotypes, treatments, and management factors.
  3. Dispatch design generator: Choose between CRD, RCBD, Split-plot, or Augmented designs.
  4. Plot the field sketch: Verify spatial layouts and serpentine/zigzag sequences.
  5. Label design: Design the experimental labels to facilitate the data collection.
  6. Export to Field Book app: Generate field-ready sheets with trait parameters.
# Install packages and dependencies

library(inti)
library(dplyr)
library(huito)

Designs with Two Factors

When evaluating two factors, four designs become available: CRD, RCBD, Split-plot RCBD, and Augmented.

Factorial Completely Randomized Design (Factorial CRD)

Recommended for multi-factor experiments under homogeneous conditions, such as temperature- and salinity-controlled germination assays in growth chambers.

# 1. Define factors: Salinity levels and incubation temperatures
factors_crd_2f <- list(
  NaCl = c("0", "50", "100"),
  Temp = c("20", "25")
)

# 2. Generate factorial CRD layout
crd_exp_2f <- design_repblock(
  nfactors = 2,
  factors = factors_crd_2f,
  type = "crd",
  rep = 4,
  zigzag = TRUE,
  seed = 2026
)

# Fieldbook preview
crd_exp_2f$fieldbook %>%
  head(10) %>%
  knitr::kable(caption = "Factorial CRD Fieldbook preview")
Factorial CRD Fieldbook preview
qrcode plots ntreat NaCl Temp sort rep rows cols design
inkaverse_1001 1001 1 0 20 1 1 1 1 crd
inkaverse_1002 1002 6 100 25 2 2 1 2 crd
inkaverse_1003 1003 2 50 20 3 3 1 3 crd
inkaverse_1004 1004 6 100 25 4 1 1 4 crd
inkaverse_1005 1005 2 50 20 5 2 1 5 crd
inkaverse_1006 1006 2 50 20 6 1 1 6 crd
inkaverse_1007 1007 5 50 25 7 4 2 6 crd
inkaverse_1008 1008 1 0 20 8 3 2 5 crd
inkaverse_1009 1009 6 100 25 9 3 2 4 crd
inkaverse_1010 1010 5 50 25 10 2 2 3 crd

# Spatial layout visualization
tarpuy_plotdesign(
  data = crd_exp_2f,
  factor = "NaCl",
  fill = c("plots", "Temp")
)

Label

The experimental field book generated by the design is used as the input data for label creation. Each row represents an experimental unit, allowing the automatic generation of individualized labels.

# Experimental fieldbook
fb <- crd_exp_2f$fieldbook

Customize the label layout

The label layout can be customized by combining text, images and QR codes. Each layer can use values from the experimental field book, allowing automatic generation of labels for every experimental plot.

Load package and import fonts.

font <- c("Permanent Marker", "Tillana", "Courgette")

huito_fonts(font)

You can find more fonts in https://fonts.google.com/

Label design

label <- fb %>%  
  label_layout(size = c(10, 2.5)
               , border_color = "blue"
               ) %>%
  include_image(
    value = "https://flavjack.github.io/inti/img/inkaverse.png"
    , size = c(2.1, 2.4)
    , position = c(1.2, 1.25)
    # , opts = list("image_scale(200)", "image_noise()")
    ) %>%
  include_barcode(
     value = "barcode"
     , size = c(2.5, 2.5)
     , position = c(8.2, 1.25)
     ) %>%
  include_text(value = "INKAVERSE"
               , position = c(4.6, 2)
               , size = 20
               , font = font[1]
               , fontface = "bold"
               , color = "red"
               ) %>%
  include_text(value = "NaCl"
               , position = c(4.5, 1.2)
               , size = 12
               , font = font[2]
               , color = "black"
               , prefix = "NaCl: "
               , fontface = "bold"
               ) %>%
    include_text(value = "Temp"
               , position = c(4.6, 0.5)
               , size = 12
               , color = "#009966"
               , font = font[2]
               , prefix = "Temperature: "
               , fontface = "bold"
               ) %>% 
  include_text(value = "plots"
               , position = c(9.7, 1.25)
               , angle = 90
               , size = 12
               , color = "brown"
               , font = font[3]
               , prefix = "Plot: "
               ) 

Label preview

The preview mode label_print(mode = "preview") generate a example of the label design from a random row of the data set.

Generate the complete labels

If you want generate the complete labels list, change: label_print(mode = "complete").

label %>% 
  label_print(mode = "complete"
              , filename = "horizontal_crd_exp_2f"
              , nlabels = 12)