pychemstation
Agilent HPLC Macro Control
Unofficial Python package to control Agilent Chemstation; we are not affiliated with Agilent. Check out the docs for usage instructions. This project is under active development, and breaking changes may occur at any moment.
Getting started
Before running this library, these are the steps you need to complete.
Add python package
pip install pychemstation
Add required MACRO script
- Open ChemStation
- Run this in the ChemStation command line:
Print _AutoPath$
. Go to this path in your file navigator, as this is where you will put your MACRO file(s). - Download the
hplc_talk.mac
.- On line 69, change the path name up to
\cmd
and\reply
. For instance, you should have:MonitorFile "[my path]\cmd", "[my path]\reply"
- and then add this file to the folder from the previous step.
- On line 69, change the path name up to
- To have these MACRO files be read by ChemStation, you must either:
- Open ChemStation and run:
macro hplc_talk.mac
HPLCTalk_Run
- OR add the above lines to a MACRO file named:
user.mac
, and then putuser.mac
in the same folder from step 3.- ChemStation will automatically load these MACRO files for you. However, sometimes this does not work, and if it
does not, you will have to run the lines in the
user.mac
manually.
- ChemStation will automatically load these MACRO files for you. However, sometimes this does not work, and if it
does not, you will have to run the lines in the
Example Usage
from pychemstation.control import HPLCController
import pandas as pd
# these paths will be unique to your Chemstation setup
DEFAULT_METHOD_DIR = "C:\\ChemStation\\1\\Methods\\"
DATA_DIR = "C:\\Users\\Public\\Documents\\ChemStation\\2\\Data"
DEFAULT_COMMAND_PATH = "C:\\Users\\User\\Desktop\\Lucy\\hplc-method-optimization\\tests"
hplc_controller = HPLCController(data_dir=DATA_DIR,
comm_dir=DEFAULT_COMMAND_PATH,
method_dir=DEFAULT_METHOD_DIR)
hplc_controller.preprun()
hplc_controller.switch_method(method_name="General-Poroshell")
hplc_controller.run_method(experiment_name="Run 10")
data_ready = hplc_controller.check_hplc_ready_with_data()
if data_ready:
hplc_controller.get_spectrum()
chrom = hplc_controller.spectra["A"]
# afterwards, save, analyze or plot the data!
values = {"x": chrom.x, "y": chrom.y}
chromatogram_data = pd.DataFrame.from_dict(values)
chromatogram_data.to_csv("Run 10.csv", index=False)
Adding your own MACROs
If you wish to add your own MACRO functions, then all you need to do is write you MACRO (using Agilent's) MACRO guide,
put the file in the user.mac
file and then list the function you want to use.
Developing
If you would like to contribute to this project, check out our GitLab!
Authors and Acknowledgements
Lucy Hao
- Adapted from AnalyticalLabware, created by members in the Cronin Group. Copyright © Cronin Group, used under the CC-BY-4.0 license.