pyFAI.gui.widgets package

pyFAI.gui.widgets.AdvancedComboBox module

class pyFAI.gui.widgets.AdvancedComboBox.AdvancedComboBox(parent=None)

Bases: PyQt5.QtWidgets.QComboBox

ComboBox with other features

  • Provide a way to custom the displayed when using table view model.
  • Allow to disable hardcoded update of currentIndex.
__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

initStyleOption(option)
Parameters:option (qt.QStyleOptionComboBox) – Option to initialize
paintEvent(event)
Parameters:event (qt.QPaintEvent) – Qt event
setDisplayedDataCallback(callback)

Set a callback to custom the displayed text and icon of the displayed selected item.

This was designed to be used with setModel, in case the cell to display is not part of the model provided.

Only qt.Qt.DisplayRole and qt.Qt.DecorationRole are supported.

def displayedData(widget, row, role=qt.Qt.DisplayRole):
    if role == qt.Qt.DisplayRole:
        model = widget.model()
        index0 = model.index(row, 0)
        index1 = model.index(row, 1)
        text = index0.data() + " " + index1.data()
        return text
    elif role == qt.Qt.DecorationRole:
        return None
    return None
comboBox = AdvancedComboBox()
comboBox.setModel(model)
comboBox.setDisplayedDataCallback(displayedData)
Parameters:callback (Callable(int,QVariant)) – Callback a-la Qt abstract model data. Called with the row index and the role to update the text and the icon of the displayed item.
setModel(self, QAbstractItemModel)
setUpdateCurrentIndexEnabled(enable)

Allow to disable the default behaviour of the QComboBox which update the current index to 0 when the model crow from an empty state.

pyFAI.gui.widgets.AdvancedSpinBox module

class pyFAI.gui.widgets.AdvancedSpinBox.AdvancedSpinBox(parent=None)

Bases: PyQt5.QtWidgets.QSpinBox

A spin box with a little more custom behaviour.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

eventFilter(widget, event)
Parameters:
  • widget (qt.QWidget) – The widget receiving this event
  • event (qt.QEvent) – Event received by the widget
mouseWheelEnabled()

True if the mouse wheel is used to changed the value contained by the spin box.

Return type:bool
setMouseWheelEnabled(isWheelEnabled)

Change the behaviour of the mouse wheel with the value.

Parameters:isWheelEnabled (bool) – If True the mouse wheel can be used to edit the value contained into the spin box.

pyFAI.gui.widgets.CalibrantPreview module

class pyFAI.gui.widgets.CalibrantPreview.CalibrantPreview(parent=None)

Bases: PyQt5.QtWidgets.QFrame

CalibrantPreview show the rays of a calibrat at a wayvelength between 0 and Pi.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

getCalibrant()
paintEvent(self, QPaintEvent)
setCalibrant(calibrant)
setWaveLength(waveLength)
sizeHint(self) → QSize

pyFAI.gui.widgets.CalibrantSelector module

class pyFAI.gui.widgets.CalibrantSelector.CalibrantSelector(parent=None)

Bases: PyQt5.QtWidgets.QComboBox

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

findCalibrant(calibrant)

Returns the first index containing the requested calibrant. Else return -1

model(self) → QAbstractItemModel
setFileLoadable(isFileLoadable)
setModel(self, QAbstractItemModel)
sigLoadFileRequested

pyFAI.gui.widgets.ChoiceToolButton module

class pyFAI.gui.widgets.ChoiceToolButton.ChoiceToolButton(parent=None)

Bases: PyQt5.QtWidgets.QToolButton

ToolButton providing a set of actions to select.

The action is only triggered when the button is clicked.

The method addDefaultAction() is used to define new actions that can be selected.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

addDefaultAction(action)

Add an action that can be selected to set the default action displayed by the tool button.

Parameters:action (qt.QAction) – An action to execute when selected on the menu and then clicked.
Return type:qt.QAction
Returns:An action triggered when the provided action is selected.
defaultAction()

Returns the default selected action.

setDefaultAction(action)

Set the default action.

Reimplement the default behaviour to avoid to add this action to the list of available actions.

setWaiting(isWaiting)

Enable a waiting state.

Parameters:isWaiting (bool) – If true switch the widget to waiting state

pyFAI.gui.widgets.ColoredCheckBox module

class pyFAI.gui.widgets.ColoredCheckBox.ColoredCheckBox(parent=None)

Bases: PyQt5.QtWidgets.QCheckBox

Check box with an explict API to change the background color of the indicator.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

boxColor()
paintEvent(self, QPaintEvent)
setBoxColor(color)

pyFAI.gui.widgets.DetectorLabel module

class pyFAI.gui.widgets.DetectorLabel.DetectorLabel(parent=None)

Bases: PyQt5.QtWidgets.QLabel

Readonly line display

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

detector()
detectorModel()
dragEnterEvent(self, QDragEnterEvent)
dropEvent(self, QDropEvent)
setDetector(detector)
setDetectorModel(model)

pyFAI.gui.widgets.DetectorModel module

class pyFAI.gui.widgets.DetectorModel.AllDetectorModel(parent)

Bases: PyQt5.QtGui.QStandardItemModel

CLASS_ROLE = 256
MANUFACTURER_ROLE = 258
MODEL_ROLE = 257
__init__(parent)

Initialize self. See help(type(self)) for accurate signature.

indexFromDetector(detector, manufacturer)
class pyFAI.gui.widgets.DetectorModel.DetectorFilter(parent)

Bases: PyQt5.QtCore.QSortFilterProxyModel

__init__(parent)

Initialize self. See help(type(self)) for accurate signature.

filterAcceptsRow(self, int, QModelIndex) → bool
indexFromDetector(detector, manufacturer)
setManufacturerFilter(manufacturer)

pyFAI.gui.widgets.DetectorSelector module

class pyFAI.gui.widgets.DetectorSelector.DetectorSelector(parent=None)

Bases: PyQt5.QtWidgets.QComboBox

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

findDetectorClass(detectorClass)

Returns the first index containing the requested detector. Else return -1

model(self) → QAbstractItemModel
setManufacturerFilter(manufacturer)
setModel(self, QAbstractItemModel)

pyFAI.gui.widgets.ElidedLabel module

class pyFAI.gui.widgets.ElidedLabel.ElidedLabel(parent)

Bases: PyQt5.QtWidgets.QLabel

QLabel with an edile property.

If the value is elided, the full content is displayed as tool tip.

__init__(parent)

Initialize self. See help(type(self)) for accurate signature.

elideMode
getElideMode()
getText()
getToolTip()
getValueAsToolTip()
resizeEvent(self, QResizeEvent)
setElideMode(elideMode)
setFont(self, QFont)
setText(self, str)
setToolTip(self, str)
setValueAsToolTip(enabled)
text
toolTip
valueAsToolTip

pyFAI.gui.widgets.FileEdit module

class pyFAI.gui.widgets.FileEdit.FileEdit(parent=None)

Bases: PyQt5.QtWidgets.QLineEdit

QLineEdit connected to a DataModel containing a file or nothing.

It allows to edit a float value which can be nonified (by the use of an empty string).

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

applyedWhenFocusOut

Apply the current edited value to the widget when it lose the focus. By default the previous value is displayed.

dragEnterEvent(self, QDragEnterEvent)
dropEvent(self, QDropEvent)
event(self, QEvent) → bool
focusInEvent(self, QFocusEvent)
isApplyedWhenFocusOut()
keyPressEvent(self, QKeyEvent)
model()
setApplyedWhenFocusOut(isApplyed)
setModel(model)
sigValueAccepted

Emitted when a file was accepted.

In case the value is still the same, no signal is sent from the DataModel, but this signal is emitted.

pyFAI.gui.widgets.FitParamView module

class pyFAI.gui.widgets.FitParamView.ConstraintsPopup(parent=None)

Bases: PyQt5.QtWidgets.QFrame

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

fromConstaints(constraint)

Update the widget using a constraint model

labelCenter()
setDefaultConstraints(model)
setLabel(text)
setMaxFocus()
setMinFocus()
setUnits(internalUnit, displayedUnit)
toConstraint(constraint)

UUpdate a constrain tmodel using the content of this widget

class pyFAI.gui.widgets.FitParamView.FitParamView(parent, label, internalUnit, displayedUnit=None)

Bases: silx.gui.qt._qt.QObject

__init__(parent, label, internalUnit, displayedUnit=None)

Initialize self. See help(type(self)) for accurate signature.

model()
setConstraintsModel(model)
setDefaultConstraintsModel(model)
setModel(model)
sigValueAccepted

Emitted when a quantity was accepted.

widgets()

pyFAI.gui.widgets.GeometryHistoryComboBox module

class pyFAI.gui.widgets.GeometryHistoryComboBox.GeometryHistoryComboBox(parent=None)

Bases: pyFAI.gui.widgets.AdvancedComboBox.AdvancedComboBox

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

currentItem()
setAngleUnit(angleUnit)
setHistoryModel(historyModel)

pyFAI.gui.widgets.GeometryLabel module

class pyFAI.gui.widgets.GeometryLabel.GeometryLabel(parent=None)

Bases: pyFAI.gui.widgets.ElidedLabel.ElidedLabel

Label displaying a specific OpenCL device.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

geometryModel()

Returns the geometry model

Return type:Union[None,GeometryModel]
setGeometryModel(geometryModel)

Set the geometry to display.

Parameters:geometryModel (GeometryModel) – A geometry.

pyFAI.gui.widgets.LoadImageToolButton module

class pyFAI.gui.widgets.LoadImageToolButton.LoadImageToolButton(parent=None)

Bases: PyQt5.QtWidgets.QToolButton

ToolButton updating a DataModel using the selection from a file dialog.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

dialogTitle()

Returns the specified dialog title

Return type:str
filename()
isEnabled(self) → bool
model()
setDialogTitle(title)

Specify a title for the dialog

Parameters:title (str) – Title of the dialog
setEnabled(self, bool)
setModel(model)

pyFAI.gui.widgets.MethodLabel module

class pyFAI.gui.widgets.MethodLabel.MethodLabel(parent=None)

Bases: PyQt5.QtWidgets.QLabel

Readonly line display

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

labelTemplate()
method()
Return type:Union[None,method_registry.Method]
methodAvailability()
setLabelTemplate(template)

Set the template used to format the label

Parameters:template (str) – The template used to format the label
setMethod(method)
setMethodAvailability(availability)

Display or not in the widget if the method is available or not.

Parameters:availability (bool) – Display in the widget if the method is available or not.

pyFAI.gui.widgets.MonitorNameEdit module

class pyFAI.gui.widgets.MonitorNameEdit.MonitorNameEdit

Bases: PyQt5.QtWidgets.QLineEdit

QLineEdit specialied to select a monitor name from HDF5 file.

dragEnterEvent(self, QDragEnterEvent)
dropEvent(self, QDropEvent)

pyFAI.gui.widgets.OpenClDeviceLabel module

class pyFAI.gui.widgets.OpenClDeviceLabel.OpenClDeviceLabel(parent=None)

Bases: PyQt5.QtWidgets.QLabel

Label displaying a specific OpenCL device.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

device()

Returns the selected OpenCL device.

A device can be identified as a string like ‘any’, ‘cpu’ or ‘gpu’ or a tuple containing the platform index and the device index.

Return type:Union[None,str,Tuple[int,int]]
Raises:ValueError – If no devices are selected
setDevice(device)

Select an OpenCL device displayed on this dialog.

A device can be identified as a string like ‘any’, ‘cpu’ or ‘gpu’ or a tuple containing the platform index and the device index.

If this device is available on this platform is is selected in the list. Else it is selected as a custom indexes.

Parameters:device (Union[None,str,Tuple[int,int]]) – A device.

pyFAI.gui.widgets.QuantityEdit module

class pyFAI.gui.widgets.QuantityEdit.QuantityEdit(parent=None)

Bases: PyQt5.QtWidgets.QLineEdit

QLineEdit connected to a DataModel.

It allows to edit a float value which can be nonified (by the use of an empty string).

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

applyedWhenFocusOut

Apply the current edited value to the widget when it lose the focus. By default the previous value is displayed.

event(self, QEvent) → bool
focusInEvent(self, QFocusEvent)
getDisplayedUnit()
Return type:pyFAI.gui.units.Unit
getDisplayedUnitModel()
Return type:pyFAI.gui.model.DataModel.DataModel
getModelUnit()
Return type:pyFAI.gui.units.Unit
isApplyedWhenFocusOut()
keyPressEvent(self, QKeyEvent)
model()
setApplyedWhenFocusOut(isApplyed)
setDisplayedUnit(displayedUnit)

Set the displayed unit.

Parameters:displayedUnit (pyFAI.gui.units.Unit) – An unit
setDisplayedUnitModel(displayedUnitModel)

Set the displayed unit.

Parameters:displayedUnitModel (pyFAI.gui.units.Unit) – A model containing a unit
setModel(model)
setModelUnit(modelUnit)

Set the unit of the stroed data in the model.

Parameters:unit (pyFAI.gui.units.Unit) – An unit
sigValueAccepted

Emitted when a quantity was accepted.

In case the value is still the same, no signal is sent from the DataModel, but this signal is emitted.

pyFAI.gui.widgets.QuantityLabel module

class pyFAI.gui.widgets.QuantityLabel.QuantityLabel(parent=None)

Bases: PyQt5.QtWidgets.QLabel

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

getDisplayedUnitModel()
isUnitEditable()
mouseReleaseEvent(self, QMouseEvent)
setDisplayedUnit(unit)
setDisplayedUnitModel(model)

Set the model containing an unit.

Parameters:pyFAI.gui.model.DataUnit.DataUnit – Model containing the unit.
setElasticSize(useElasticSize)
setFloatFormatter(formatter)

Set a specific formatter for float.

If this formatter is None (default value) or the value is not a floatting point, the default formatter is used.

setFormatter(formatter)
setInternalUnit(unit)
setPrefix(prefix)
setUnitEditable(isUnitEditable)
setValue(value)
sizeHint(self) → QSize
usedUnit()

Returns the unit used to display the quantity

pyFAI.gui.widgets.UnitLabel module

class pyFAI.gui.widgets.UnitLabel.UnitLabel(parent)

Bases: PyQt5.QtWidgets.QLabel

QLabel displaying an unit.

__init__(parent)

Initialize self. See help(type(self)) for accurate signature.

getUnit()
Return type:pyFAI.gui.units.Unit
getUnitModel()
Return type:pyFAI.gui.model.DataUnit.DataUnit
isUnitEditable()
mouseReleaseEvent(self, QMouseEvent)
setUnit(unit)

Set the displayed unit.

Parameters:unit (pyFAI.gui.units.Unit) – An unit
setUnitEditable(isUnitEditable)
setUnitModel(model)

Set the model containing an unit.

Parameters:pyFAI.gui.model.DataUnit.DataUnit – Model containing the unit.

pyFAI.gui.widgets.UnitSelector module

class pyFAI.gui.widgets.UnitSelector.UnitSelector(parent=None)

Bases: PyQt5.QtWidgets.QComboBox

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

findUnit(unit)

Returns the first index containing the requested detector. Else return -1

model(self) → QAbstractItemModel
setModel(self, QAbstractItemModel)
setShortNameDisplay(shortName)
setUnits(units)
units()

pyFAI.gui.widgets.WorkerConfigurator module

Module containing a widget to configure pyFAI integration.

class pyFAI.gui.widgets.WorkerConfigurator.WorkerConfigurator(parent=None)

Bases: PyQt5.QtWidgets.QWidget

Frame displaying integration configuration which can be used as input param of the ~`pyFAI.worker.Worker`.

__init__(parent=None)

Initialize self. See help(type(self)) for accurate signature.

getConfig()

Read the configuration of the plugin and returns it as a dictionary

Returns:dict with all information.
getOpenFileName(title)

Display a dialog to select a filename and return it.

Returns None if nothing selected.

This code is compatible PyQt4/PyQt5 which is not the case for static functions provided by qt.QFileDialog.

loadFromJsonFile(filename)

Initialize the widget using a json file.

loadFromPoniFile(ponifile)
selectDetector()
selectGeometry()
selectMethod()
selectOpenclDevice()
set1dIntegrationOnly(only1d)

Enable only 1D integration for this widget.

setConfig(dico)

Setup the widget from its description

Parameters:dico (dict) – dictionary with description of the widget
setDetector(detector)

Module contents

Module containing generic widgets