Analysis Specifications
In the previous Section you learned how to manage Analyses and how to add Result Ranges for single Analyses. In this section we are going a step further and create an Analysis Specification for the whole Sample and learn about inclusive and exclusive borders in the minimum and maximum Ranges.
Add global Analysis Specifications
Analyses Specifications are defined per Sample Type and can be added in the LIMS Setup. Click on the ⚙️button in the upper right corner and chose the Analysis Specifications tile and press then the Add Button.
Enter the following values in the add form:
- Sample Type:
Water
- Title:
Water
- Description:
Analysis Specifications for Samples with the Sample Type "Water"
- Specifications:
- Calcium:
Min warn: 9.5
Min Operator: >
Min: 9
Max Operator: <
Max: 11
Max warn: 10.5
- Magnesium:
Min warn: 9.5
Min Operator: >
Min: 9
Max Operator: <=
Max: 11
Max warn: 10.5
- Total Hardness:
Min warn: 9.5
Min Operator: >=
Min: 9
Max Operator: <=
Max: 11
Max warn: 10.5
- Calcium:
Click the Save button when you are done.
Min/Max Operators Explained
You might have wondered about the logic of the Min Operators >
and >=
and
the Max Operators <
and <=
about being maybe the wrong way around, because
according to Wikipedia, the "greater than" sign is >
¹ and the "less than"
is <
².
However, the logic used here specifies everything that is in range rather than out of range with these operators.
Therefore, the Min operator
states that everything greater or equal to the
entered value is in range, and the Max operator
states that everything lower
or equal to the entered value is in range.
To sum it up this means that values of 9
and below and 11
and above are out of
range for Calcium
, but not for Total Hardness
, where 9
and 11
are included
by the Min Operator
and Max Operator
. The Magnesium
Analysis excludes 9
for
the minimum allowed value, but includes 11 for the maximum allowed value.
Apply an Analysis Specification to a Sample
Now it is time to apply the Analysis Specification to a Sample. Navigate to the listing of all Samples and copy one of the existing Samples.
Add the new created Analysis Specification in the corresponding field. Also make sure that there are no manual result ranges set for the selected Analyses in the Add form from the previous examples, because they would take precedence over the Analysis Specifications set in the Sample. Press the Save button when you are done.
☝️Note:
The (Lab)
Suffix in the name distinguishes between global (Lab)
and Client
(Client)
located Analysis Specifications.
Receive the Sample after it was registered as you did in the section Sample Basics and make sure you are in the View tab of the Sample.
☝️Note:
The notation of the braces (
)
and brackets [
]
next to the values
define if the values are included or excluded. For instance, (0,10]
means
greater than 0 and less than or equal to 10, while [0,10)
means greater than
or equal to 0 and less than 10.
Enter the following values as results:
- Calcium:
9
- Magnesium:
9
- Total Hardness:
9
Press the Save button when you are done and note the Exclamation Mark next
to the Calcium
and Magnesium
Analyses notifying that these values are out of
range when adding the mouse over it.
☝️Note:
There is currently a bug in SENAITE Core that you will lose the Min/Max Operator
settings when you manage the Analyses in a Sample created with an
Analysis Specification that defines them.
Fortunately, there is a workaround that you manually remove all the
Specifications in the Manage Analyses screen before saving. This will re-use
the values from the Analysis Specification.
Publish Out of Range Analyses
Please submit, verify and publish the results as you have done in the Sample Basics section to view the preview of the final report.
The final report shows the defined ranges and added a red warning sign next to the results that are out of range.
☝️Note: The final Analysis Report can be highly customized to meet almost any lab requirement. Contact the professional service providers for more details.
Congratulations 🙌 you successfully learned how to apply Analysis Specifications to Samples