MSL-Equipment

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

  1. Configuration File

and two different types of Database Formats

  1. Equipment-Register Database
  2. Connections Database

The following example uses a configuration file that specifies a registry database containing 3 digital multimeters that are available in a lab which can be used to measure a voltage. The information about how to connect to the equipment is found in a connections database.

You specify which of the digital multimeters you are using as an <equipment> element in the configuration file.

Loading the configuration file using the Config class is the main entryway in to the MSL-Equipment package:

>>> from msl.equipment import Config
>>> cfg = Config('/path/to/config.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 Connections Database. To access the Hewlett Packard 34401A [1] EquipmentRecord in the registry database (which is known by the dmm alias that is specified in the configuration file) use:

>>> db.equipment['dmm'] 
EquipmentRecord<Hewlett Packard|34401A|D10011>

Connect to the Hewlett Packard 34401A [1] digital multimeter and query the *IDN? command:

>>> dmm = db.equipment['dmm'].connect() 
>>> dmm.query('*IDN?') 
'Hewlett Packard,34401A,D10011,A.02.14-02.40-02.14-00.49-03-01'

For more examples of what a Configuration File or a 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.

Index

[1](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.