CurvesAppearanceChooser

class CurvesAppearanceChooser(parent=None, curvePropDict={}, showButtons=False, autoApply=False, designMode=False)

Bases: PyQt4.QtGui.QWidget

A widget for choosing plot appearance for one or more curves. The current curves properties are passed using the setCurves() method using a dictionary with the following structure:

curvePropDict={name1:prop1, name2:prop2,...}

where propX is an instance of CurveAppearanceProperties When applying, a signal is emitted and the chosen properties are made available in a similar dictionary.

CurveTitleEdited

NAME_ROLE = 32

controlChanged

curveAppearanceChanged

getSelectedCurveNames()

Returns the curve names for the curves selected at the curves list.

Note: The names may differ from the displayed text, which corresponds to the curve titles (this method is what you likely need if you want to get keys to use in curves or curveProp dicts).

Return type:string_list Returns:the names of the selected curves

getShownProperties()

Returns a copy of the currently shown properties and updates self._shownProp

Return type:CurveAppearanceProperties Returns:

loadUi(filename=None, path=None)

onApply()

Apply does 2 things:

• It updates self.curvePropDict using the current values choosen in the dialog
• It emits a curveAppearanceChanged signal that indicates the names of the curves that changed and the new properties. (The names and the properties are returned by the function as well)

Return type:tuple <CurveAppearanceProperties, list> Returns:a tuple containing the curve properties and a list of the selected curve names (as a list<str>)

onControlChanged(*args)

slot to be called whenever a control widget is changed. It emmits a ‘controlChanged signal and applies the change if in autoapply mode. It ignores any arguments passed

onItemChanged(item)

slot used when an item data has changed

onReset()

slot to be called when the reset action is triggered. It reverts to the original situation

onSelectedCurveChanged()

Updates the shown properties when the curve selection changes

setCurves(curvePropDict)

Populates the list of curves from the properties dictionary. It uses the curve title for display, and stores the curve name as the item data (with role=CurvesAppearanceChooser.NAME_ROLE)

Parameters:curvePropDict (dict) – a dictionary whith keys=curvenames and values= CurveAppearanceProperties object

showProperties(prop=None)

Updates the dialog to show the given properties.

Parameters:prop (CurveAppearanceProperties) – the properties object containing what should be shown. If a given property is set to None, the corresponding widget will show a “neutral” display

updateTitles(newTitlesDict=None)

Updates the titles of the curves that are displayed in the curves list.

Parameters:newTitlesDict (dict <str, str>) – dictionary with key=curve_name and value=title