wxmtxyA GUI tool for EPICSauthor: Pete R. Jemian (jemian@anl.gov) version: 0.5 |
![]() |
wxmtxy provides EPICS support to users, allowing them to define a table of known positions for an X,Y positioner (motor) pair and provides a one-button click to drive the X,Y pair to a specific table setting. Also can record current position into a setting.
Several sets of X,Y positioners can be configured. (Each set is separate.) In fact, the positioners do not have to be motors, but can be any type of EPICS PV that will accept a numeric value.
wxmtxy is based on wxPython and relies on CaChannel to communicate with EPICS.
In the Graphical User Interface (GUI), tooltips are provided for most items. Moving and pausing the mouse over a widget (GUI component such as a button or a label) will cause a terse description of that widget to be displayed. Moving the mouse away will cause that tooltip to disappear.
For more help, explanations are provided in the HTML pages you are viewing now.
A save file window will appear. Navigate to a directory to save your settings, enter a name with the extension .XML and finish your task.
field | description |
---|---|
DESC | EPICS PV to use when asking the positioner for its description string |
DMOV | EPICS PV to use when asking the positioner if it is done moving. DMOV=1: not moving, DMOV=0: moving |
EGU | EPICS PV to use when asking the positioner for its engineering units string |
RBV | EPICS PV to use when asking the positioner where it is now |
STOP | EPICS PV to use when telling the positioner to stop moving immediately |
VAL | EPICS PV to use when telling the positioner to move to a new value |
term | description |
---|---|
EPICS PV | EPICS Process variable name. See http://www.aps.anl.gov/epics. Perhaps a document such as http://www.aps.anl.gov/epics/base/R3-14/10-docs/CAref.html for more details. |
EPICS motor record | EPICS abstract specification of a positioner such as a stepping motor. See http://www.aps.anl.gov/bcda/synApps/motor/index.html or http://www.aps.anl.gov/bcda/synApps/motor/R6-4/motorRecord.html for more details. |
XYpair | set of Tabs in wxmtxy belonging to an XYpair |
Tab | set of Rows in a Tab of an XYpair in wxmtxy |
Row | specific combination in wxmtxy of (label, X_position, Y_position) |
Settings File | XML file with specifications for EPICS Process Variables and saved positions for the wxmtxy.py application |
Text positions file | The "Text positions file" is a plain text file and can be prepared with any text editor. The file describes a set of positions to be loaded into a Tab of the wxmyxy application. |
The "Text positions file" is a plain text file and can be prepared with any text editor. The file describes a set of positions to be loaded into a Tab of the wxmtxy application. It contains an arbitrary number of rows. Each row contains three values, separated by tabs. The values are "label X_position Y_position" where the positions are in "mm". An example is provided (examples/standard-paddle.txt) that describes the positions on the standard 4-column paddle.
Users will likely produce a"Text positions file" by preparing a spreadsheet with sample description (label) and X,Y positions on the sample paddle. The origin (0,0) is the notch on the upper-right edge of the paddle.
file | description |
---|---|
examples/standard-paddle.txt |
positions on the standard 4-column paddle |
file | description |
---|---|
examples/USAXS_XY.xml |
settings file from USAXS sample and detector stages |
examples/test-settings.xml |
settings file used by developer to test various features |
file | description |
---|---|
wxmtxy.py | starts the wxmtxy application |
wxmtxy_root.py | Main frame of wxmtxy application |
wxmtxy_pair.py | configuration for X,Y pair of EPICS positioners |
wxmtxy_tab.py | set of rows with positioner settings |
wxmtxy_row.py | Define/manage GUI elements for one row of the table |
wxmtxy_pvsetup.py | configure EPICS for X,Y pair |
wxmtxy_xml.py | read/write routines for wxmtxy XML settings |
wxmtxy_axis.py | Maintain EPICS PVs and connections for one axis |
wxmtxy_version.py | version information for wxmtxy |
setup.py | Python distutils packaging file for wxmtxy |
file | description |
---|---|
wxmtxy_htmlview.py | HtmlView to view HTML-formatted help files |
pvConnect.py | simplified connections to an EPICS PV using CaChannel |
menuLauncher.py | standalone GUI to launch various utilities |
file | description |
---|---|
LICENSE | APS EPICS extensions software license |
README | Comments to developers reading the source code files |
XSLT stylesheet | XSLT stylesheet to display settings files nicely in a WWW browser |
Python
wxPython
ca
CaChannel
#************************************************************************* # Copyright (c) 2009-2010 The University of Chicago, as Operator of Argonne # National Laboratory. # Copyright (c) 2009-2010 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # This file is distributed subject to a Software License Agreement found # in the file LICENSE that is included with this distribution. #*************************************************************************