Generate Single Trial Design

In Katmandoo DiGGer is used to generate randomised trial design using the Trial Design Parameter values of a selected trial in the Trial Main Form.

Click here for more explanation of experimental design.

To design trial using DiGGer, the design type of the trial must use design software dks.dll and the DesignGenotypeFormat must be "GenotypeName|GenotypeId". Click here for more information.

Following information must exist before a trial design can be created.

• Trial: Trial header information for which the randomised trial design to be created must exist in the trial table.
• Trial Design Parameter: The design parameter value must be entered for the trial and these are the Virtual Columns used by DiGGer (if they are not in your database, please contact Katmandoo Team for the spreadsheet with the Trial Design Parameter).

Table Name of the following Virtual Columns: TrialDesignParameter

Column Name	Column Caption	Column Description	Column Aliases
BlockBothDirection	Block Both Direction	Block the trial design in Both Direction. Do NOT set data type as Boolean as the DiGGer use either Y or N.	DiGGer_BlockBothDirection
NoOfColumns	No of Columns (No of Ranges)	Number of Columns in the trial design	NoOfRanges,No_Range, DiGGer_NoOfColumns, DiGGer_Ranges
NoOfColumnsPerRep	No of Columns per Rep	'Number of columns per Rep in the trial design	DiGGer_NoOfColumnsPerRep
NoOfRows	No of Rows	Number of Rows in the trial design	DiGGer_NoOfRows
NoOfRowsPerRep	No of Rows per Rep	Number of rows per Rep in the trial design	DiGGer_NoOfRowsPerRep
NoOfTreatments	No of Treatments (No of Entries)	Number of Treatments in the trial design	DiGGer_NoOfTreatments

• Genotype: The genotypes that will be used in the trial must exist in the database. There are following restrictions by DiGGer on Genotype Name:
  • Maximum length of the Genotype Name is 255.
  • Genotype Name can't have double quote ( " ) and pipe (  |  ) as it is used a seperator between GenotypeNames.

In the Trial Main Form, use [ Record > Trial Design > Generate Trial Design of Selected Trial ] to activate following Generate Trial Design Form.

To design trial using DiGGer, the design type of the trial must use design software dks.dll. Click here for more information.

Illustrative snapshot of First Step:

1. Use this option to load the preselected genotype list of the Trial Type of the selected Trial.
   • In the snapshot, the genotype list of [ Wheat Row Spacing ] trial type for year [ 2008 ] will be loaded in the next page.
   • Use [ Task > Trial > Raw data > Manage Trial Type ] to update genotype list of any trial type.
2. Use this option to use genotypes that were used in a trial (ie trial having trial design are only list!).
3. Or use this option if you would like to select genotypes yourself.
4. Click it to edit (correct) trial design parameters.

Note: User can always click on [ Cancel ] to close the form to cancel generating trial design.

Illustrative snapshot of Second Step:

1. Use Search Genotype component to load genotypes in the [ Available Genotypes ] list.
2. Click it to find Genotype Alias using Quick Search. This is useful when you know the Genotype Alias but don't know the Genotype Name.
3. Genotypes that are selected to generate trial design of the selected trial.
4. Click it to generate trial design using the Trial Design software (in this case DiGGer). If trial design is generated successfully, then it will ask to:
   • save Genotype list if the trial type of the trial does not have for the site year (of the trial). If answered yes, then it will save the Genotype list for the Trial Type / Year in the database.
   • close the form and start Import Trial Design wizard using the output file generated by DiGGer. If answered yes, then it closes the form and start Import Trial Design wizard with Import Trial Design using DiGGer output file option and DiGGer output file selected.
5. Click it to (close the form) to import the trial design using the output file generated by the trial design software.
6. Click it to copy input and output files generated by the trial design software to another folder.

Note: User can always click on [ Cancel ] to close the form without generating trial design.

Illustrative snapshot of DiGGer error message:

• Reason part of above message is generated by DiGGer which indicates that number of treatment does not match with selected genotypes.
  • Click here for list of error messages that are returned from DiGGer.
• In this example, number of treatments for LRSA07MERI2 and LRSA07CONA2 were 12 and 30 respectively but only 8 genotypes were selected, which led to generate above error message.
  • Suppose 14 genotypes were selected, then DiGGer would have successfully generated trial design for LRSA07MERI2 but would fail on LRSA07CONA2.
  • Suppose 32 genotypes were selected, then DiGGer would have successfully generated trial design for LRSA07MERI2 as well as LRSA07CONA2.

Illustrative snapshot of DiGGer progress message:

1. Click it to activate recent message list
2. Indicates progressing phase of the generarting trial design of the trial
3. Indicates starting of trial design process
4. Indicaes the trial design of the trial was incomplete because of reason displayed in the Generate Trial Design Form.

These are the error messages that can be generated by DiGGer.

Error Code	Error Message Heading	Type	Error Mesage Description
1	Treatment/Layout mismatch	Error	Number of plots in a replicate not a multiple of the number of treatments.
2	Number of treatments out of range	Error	There must be at least 2 treatments and fewer than 1500 to allow some replication.
3	Treatment file format error	Error	The .trt file should have 4 space or TAB separated columns: Trt name, no., rep. & group.
4	A-type specification error	Error	Code for efficincy measure (A-type) must be one of A++, Agg, A22, A11, A1+, Aa2 or Aaa.
5	A-type specification error	Error	A-types other than A++ require more than 1 treatment group in the treatment file.
6	A-type specification error	Error	There must be more than 1 Group 2 treatment when the A-type is coded as A22.
7	A-type specification error	Error	There must be more than 1 Group 1 treatment when the A-type is coded as A11.
8	Experiment size error	Error	There must be fewer than 1500 plots.
9	Experiment size error	Error	No room for replication of treatments.
10	Replicate size mismatch	Error	Replicate must fit within design dimensions Replicate size reset to match experiment size.
11	Replicate size error	Error	Replicate too small for number of treatments.
12	Replicate size error	Error	Replicates do not fit evenly in design.
13	Replicate size error	Error	Replicate size does not match treatment replication and initial design not read.
14	Swap block size error	Error	No swaps are possible. Check swap block dimensions.
15	Swap block size mismatch	Warning	Swap blocks do not fit in within a replicate. Swap blocks reset to be within replicates.
16	Correlation block size mismatch	Warning	Correlation blocks do not fit in the design. Correlation blocks reset to match the design.
17	Correlation block size error	Error	Correlation blocks do not fit evenly in design.
18	Correlation block size error	Error	Invalid correlation block dimensions.
19	Input design file error	Error	Starting design .din file does not exist.
20	Input design file error	Error	Error on reading from .din file.
21	Swap code file error	Error	Error on reading from .swp file
22	Input file error	Error	GENERATE or READ needed for input design code.
23	Input file read error	Error	Error in Correlation or Swap block dimensions.
24	Treatment replication error	Error	Non-missing plots not a multiple of treatment.
25	Input file read error	Error	Error on RNG seed line,
26	Input file read error	Error	Error on treatment information line.
27	Treatment file read error	Error	Error in .trt file
28	Input file read error	Error	Error in number of objectives in .in file. There must be between 1 and 9 objectives.
29	Input file read error	Error	Error in number of blocking factors coded.
30	Block specification error	Error	Too many fixed effects (max 100).
31	Correlation matrix too large	Error	Reduce correlation block size or number of objectives.
32	Truncation of blocks	Error	Blocks extending outside Correlation Blocks will be truncated.
33	Input file read error	Error	Error reading block specifications from .in file.
34	Input file read error	Error	Error reading linear covariate code [ NONE, ROW, COLUMN BOTH] from .in file.
35	Linear covariate error	Error	Too many fixed effects (max 100).
36	Input file read error	Error	Error reading spatial model code AR (-1,1), MA [-0.5,0.5], ID [].
37	Input file read error	Error	Error reading spatial parameters for AR (-1,1) or MA [-0.5,0.5].
38	Input file read error	Error	Error reading objective weight.
39	Input file read error	Error	Error reading spatial variance ratio, not > 0.
40	Input file read error	Error	Target A-value or Max. interchange error.
41	Input file read error	Error	Search intensity must be in the [0,100] range.
42	Input file read error	Error	DiGGer control must be N(New phase) or E(End).
43	Treatment information error	Error	Replication in .trt file does not match the starting design in .din.
44	Treatment swap list error	Error	There are no treatment swaps possible.
45	Input file read error	Error	Number of experiments must be 1 in this DiGGer version.
46	Treatment swap list error	Error	There are too many possible treatment swaps (max. 600000). Reduce swap block size?
47	Too many objectives	Error	The information matrix is too large. Reduce the number of objectives.
48	Treatment swap error	Error	No valid treatment swaps were found.
49	Input file read error	Error	Error on the experiment layout line.
50	Input file read error	Error	RANDOM treatments need treatment gamma.
51	Input file read error	Error	Treatment number is out of range [0,NTRT].
52	Input design file read error	Error	Correlation block cannot be smaller than the full design when there are missing plots.
53	Input swap file read error	Error	The swap .swp file does not exist.
54	Treatment group error	Error	Too many treatment groups (max. 100).
55	File read error	Error	Input file does not exist.
56	Input file read error	Error	Error in the number of treatments.
57	Input file read error	Error	Error in the experiment dimensions.
58	Input file read error	Error	Error in the replicate dimensions.
59	Input file read error	Error	Error reading treatment information.
60	Input file read error	Error	Error reading block in 2D indicator.
61	Input file read error	Error	Cannot open .txt file.
62	Input file read error	Error	Cannot open .in file.
63	Input file read error	Error	Cannot open .trt file.
64	Input file read error	Error	Cannot open .out file.
65	Input file read error	Error	Cannot open .log file.
66	Input file read error	Error	Cannot open .lst/.csv file.
67	Input file read error	Error	Cannot open .din file.
68	Input file read error	Error	Cannot open .swp file.
75	Input file read error	Error	Too few treatments listed in input file.
76	Parameter error	Error	Rows or Columns in Target Block.
77	Parameter error	Error	Spatial indicator [T,F] or [Y,N].
78	Parameter error	Error	RowColumn indicator [T,F] or [Y,N].
79	Parameter error	Error	IndependentBlock indicator [F] or [00 00].
80	Parameter error	Error	TrtType indicator FIXED.
81	Parameter error	Error	Trt Variance Ratio -1.
82	Parameter error	Error	Target Group.
83	Parameter error	Error	Initial Design.
84	Parameter error	Error	Initial Swap.
85	Parameter error	Error	RNG Seeds.
86	Parameter error	Error	InFile.
87	Parameter error	Error	Spatial or RowColumn or BlockIn2D must be TRUE.
901	Existing DiGGer  file can not be deleted	Error	Can not delete (old) existing DiGGer files. Please make sure that the (old) existing DiGGer files (of the trial in the trial design folder) are not opened by any other application so that they can be deleted and new ones can be created by DiGGer.