The purpose of MSL-Equipment is to help facilitate the management and the control of equipment in the laboratory.
It aims to achieve this by requiring that information about the equipment that is used in the laboratory is kept in
a centralized (and ideally updated) database. It allows for easily sharing equipment between research teams without
any downtime in learning how to establish communication to the borrowed equipment. Therefore, you can be confident
whether the equipment that was used for a project meets the calibration requirements needed to obtain the desired
measurement uncertainty and you can spend your time acquiring and analysing data rather than figuring out how to
query, for example, a
*IDN? command from the equipment.
Three items are used by MSL-Equipment to help organise, share and communicate with equipment that is available in the laboratory to perform a measurement
and two different types of Database Formats
The following example illustrates a configuration file that specifies a database containing 6 Digital Multimeter’s
that are available in a lab which can be used to measure a voltage. The person performing the measurement specifies
which of the Digital Multimeter’s they are using as an <equipment> XML tag in the configuration file. They load the
configuration file using the
Config class, which is the main entryway in to the
<?xml version="1.0" encoding="utf-8" ?> <msl> <!-- The Digital Multimeter that is being used to perform the measurement --> <equipment alias="dmm" model="34465A"/> <!-- The Connection database --> <equipment_connections> <path>example.xlsx</path> <sheet>Connections</sheet> </equipment_connections> <!-- The Equipment-Register database --> <equipment_registers> <register> <path>example.xlsx</path> <sheet>Equipment</sheet> </register> </equipment_registers> </msl>
>>> from msl.equipment import Config >>> cfg = Config('msl/examples/equipment/example.xml') >>> db = cfg.database()
Once you have a reference to the
database you have access to all the records in
the Equipment-Register Database and in the Connection Database. To access the Keysight 34465A 
EquipmentRecord in the example database (which is known by the
dmm alias that
is specified in the configuration file) use:
>>> db.equipment['dmm'] EquipmentRecord<Keysight|34465A|MY54506462>
Connect to the Keysight 34465A  Digital Multimeter and query the
>>> dmm = db.equipment['dmm'].connect() >>> dmm.query('*IDN?') 'Keysight Technologies,34465A,MY54506462,A.02.14-02.40-02.14-00.49-03-01\n'
For more examples of what a Configuration File or the Database Formats can look like or how to use MSL-Equipment in your own application see the Examples. The API Documentation also shows a more detailed example that loads the same configuration file.
|||(1, 2) Companies that sell equipment that is used for scientific research are identified in this guide in order to illustrate how to adequately use MSL-Equipment in your own application. Such identification is not intended to imply recommendation or endorsement by the Measurement Standards Laboratory of New Zealand, nor is it intended to imply that the companies identified are necessarily the best for the purpose.|