How-to guides

How-to guides are task-oriented instructions for solving specific problems with Taurus. They assume some familiarity with Taurus and focus on getting a particular job done.

User interface

Work with the main Taurus widgets, visualization tools, and GUI applications.

• Use Taurus forms
  • Launch a TaurusForm application
  • Change the contents of a form
  • Use drag and drop
  • Use compact mode
  • Write attribute values
• Create a basic SVG synoptic
  • Install the requirements
  • Create the synoptic widget
  • Associate SVG elements with Taurus models
  • Style live values with CSS
  • Customize interactions
  • Further training
• Organize models in a TaurusGrid
  • Create a grid
  • Define rows and columns
  • Set the models
  • Matching rules
  • Show or hide attribute labels
  • See also
• Select models with TaurusModelChooser
• Edit arrays
• Use device panels
  • TaurusDevicePanel as a standalone application
  • TaurusPanel as a standalone application
• Work with TaurusPlot
  • Launch TaurusPlot as a standalone application
  • Use the TaurusPlot context menu
  • Zoom and pan
  • Configure the plot
  • Choose what is plotted
  • Save and restore the current configuration
  • Inspect plotted values
  • Export and print data
  • Customize curve titles
  • Use date/time values on the X axis
• Work with Taurus trends
  • Launch TaurusTrend as a standalone application
  • Use a fixed X-axis range
  • Plot a spectrum as separate scalar trends
  • Force periodic attribute reads
  • Trend a Tango State attribute
  • Launch a 2D trend
  • Access archived values
• Display an image attribute
  • Launch TaurusImageDialog as a standalone application
• Work with TaurusGUI applications
  • Launch TaurusGUI
  • Rearrange panels
  • Create custom panels
  • Save and load perspectives
  • Add a synoptic panel
  • Add external application launchers
  • Configure Sardana integration
  • Troubleshooting floating panels
• Troubleshoot Taurus widgets in Qt Designer
  • Missing Taurus widgets with Conda and PyQt5 >= 5.15.4
• Browse Taurus configurations
  • Launch the configuration browser
• Monitor Taurus logs
  • Use the console monitor
  • Use the graphical monitor
• Inspect a running Taurus GUI
  • Open the diagnostics window
  • Inspect process information
  • Inspect devices
  • Inspect attributes
  • Understand listeners and subscriptions
  • Event statistics and performance
• Create custom Taurus widgets
  • Create a single-model widget
  • Add support for multiple models
  • Handle a list of models
  • Delegate models to child widgets

Models and data

Work with Taurus models and derived values.

• Work with evaluated models
  • Use a Python expression
  • Use values from other Taurus models
  • Access Python modules
  • Use a custom evaluation device
  • Further examples
  • See also
• Create a custom Taurus scheme
  • Design the model URI
  • Implement name validators
  • Provide a factory
  • Expose diagnostic information
  • Implement the models
  • Register the scheme plugin
  • Test the installed scheme
  • See also

Configuration

Configure runtime behavior and user-level Taurus settings.

• Change the Tango event subscription mode
  • Change the default mode with Custom Settings
  • Change the mode from the command line

Development

Contribute to Taurus and work with its development conventions and tools.

• Development guides
  • Contributing to Taurus
  • Writing Taurus documentation
  • Taurus coding guide
  • Qt programming guidelines
  • Releasing Taurus

Migration

Guides for adapting code when moving between Taurus versions.

• Migration guides
  • Taurus 3.x to Taurus 4.x migration guide

If you need background on why Taurus behaves in a certain way, see Explanation. For exact API and configuration information, see Reference.