Package adams.flow.sink
Class BoxPlot
-
- All Implemented Interfaces:
AdditionalInformationHandler,CleanUpHandler,Destroyable,GlobalInfoSupporter,LoggingLevelHandler,LoggingSupporter,OptionHandler,QuickInfoSupporter,ShallowCopySupporter<Actor>,SizeOfHandler,Stoppable,StoppableWithFeedback,VariablesInspectionHandler,VariableChangeListener,Actor,ClearableDisplay,DisplayTypeSupporter,ErrorHandler,FlowControlSubMenuSupporter,HeadlessExecutionSupporter,InputConsumer,ComponentSupplier,DisplayPanelProvider,MenuBarProvider,SendToActionSupporter,Serializable,Comparable
public class BoxPlot extends AbstractGraphicalDisplay implements DisplayPanelProvider
* Actor for displaying box plots.
*
* For more information, see:
* http://en.wikipedia.org/wiki/Box_plot *
Valid options are:
-D <int> (property: debugLevel) The greater the number the more additional info the scheme may output to the console (0 = off). default: 0 minimum: 0
-name <java.lang.String> (property: name) The name of the actor. default: BoxPlot
-annotation <adams.core.base.BaseText> (property: annotations) The annotations to attach to this actor. default:
-skip (property: skip) If set to true, transformation is skipped and the input token is just forwarded as it is.
-stop-flow-on-error (property: stopFlowOnError) If set to true, the flow gets stopped in case this actor encounters an error; useful for critical actors.
-short-title (property: shortTitle) If enabled uses just the name for the title instead of the actor's full name.
-width <int> (property: width) The width of the dialog. default: 1000 minimum: -1
-height <int> (property: height) The height of the dialog. default: 700 minimum: -1
-x <int> (property: x) The X position of the dialog (>=0: absolute, -1: left, -2: center, -3: right ). default: -1 minimum: -3
-y <int> (property: y) The Y position of the dialog (>=0: absolute, -1: top, -2: center, -3: bottom ). default: -1 minimum: -3
-writer <adams.gui.print.JComponentWriter> (property: writer) The writer to use for generating the graphics output. default: adams.gui.print.NullWriter
-width-plot <int> (property: widthPlot) Width of each box plot default: 200 minimum: 50 maximum: 500
-height-plot <int> (property: heightPlot) Height of each box plot default: 200 minimum: 50 maximum: 500
-width-ax <int> (property: widthAx) Width of box plot y axis default: 50 minimum: 20 maximum: 100
-num-horizontal <int> (property: numHorizontal) Number of box plots to display on each row, -1 and 0 aredefault and will display all the box plots in one row default: -1 minimum: -1
-fill-box (property: fillBox) Fill the box plots with color
-color <java.awt.Color> (property: color) Color to fill box plots default: #ff0000
-same-axis (property: sameAxis) Box plots have same axis
-attributes <adams.core.Range> (property: attributes) Attributes to display in box plots; A range is a comma-separated list of single 1-based indices or sub-ranges of indices ('start-end'); 'inv(...)' inverts the range '...'; the following placeholders can be used as well: first, second, third, last_2, last_1, last default: first-last- Version:
- $Revision$
- Author:
- msf8
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected Rangem_AttStringrange of box plots to display, in string formprotected BoxPlotManagerm_BoxPlotpanel to display on the actorprotected Colorm_ColorColor to fill the boxprotected booleanm_FillFill the box with colorprotected intm_HeightPlotheight of plots to be drawnprotected intm_NumHorizontalNumber of plots on each rowprotected booleanm_SameAxissame axis for each box plotprotected intm_WidthAxsame axis for each box plotprotected intm_WidthPlotwidth of plots to be drawn-
Fields inherited from class adams.flow.sink.AbstractGraphicalDisplay
m_GraphicFileChooser, m_MenuBar, m_MenuItemFileClear, m_MenuItemFileClose, m_MenuItemFileSaveAs, m_MenuItemFileSaveTextAs, m_MenuItemFlowPauseResume, m_MenuItemFlowStop, m_ShowFlowControlSubMenu, m_TextFileChooser, m_Writer
-
Fields inherited from class adams.flow.core.AbstractDisplay
BACKUP_INPUT, m_CreateFrame, m_DisplayType, m_Frame, m_Height, m_InputToken, m_KeepOpen, m_Panel, m_ResetGUIWaiting, m_ShortTitle, m_Updating, m_Width, m_X, m_Y
-
Fields inherited from class adams.flow.core.AbstractActor
m_Annotations, m_BackupState, m_DetectedObjectVariables, m_DetectedVariables, m_ErrorHandler, m_Executed, m_Executing, m_ExecutionListeningSupporter, m_FullName, m_LoggingPrefix, m_Name, m_Parent, m_ScopeHandler, m_Self, m_Silent, m_Skip, m_StopFlowOnError, m_StopMessage, m_Stopped, m_StorageHandler, m_VariablesUpdated
-
Fields inherited from class adams.core.option.AbstractOptionHandler
m_OptionManager
-
Fields inherited from class adams.core.logging.LoggingObject
m_Logger, m_LoggingIsEnabled, m_LoggingLevel
-
Fields inherited from interface adams.flow.core.Actor
FILE_EXTENSION, FILE_EXTENSION_GZ
-
-
Constructor Summary
Constructors Constructor Description BoxPlot()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Class[]accepts()Returns the class that the consumer accepts.StringattributesTipText()Tip text to display for the optionvoidclearPanel()Clears the content of the panel.StringcolorTipText()Tip text for the color propertyDisplayPanelcreateDisplayPanel(Token token)Creates a new display panel for the token.voiddefineOptions()Adds options to the internal list of operationsprotected voiddisplay(Token token)Displays the token (the panel and dialog have already been created at this stage).booleandisplayPanelRequiresScrollPane()Returns whether the created display panel requires a scroll pane or not.StringfillBoxTipText()Tip Text for the fill box propertyRangegetAttributes()get the attributes to be displayed initiallyColorgetColor()Get the color to fill the box plotsprotected intgetDefaultHeight()Returns the default height for the dialog.protected intgetDefaultWidth()Returns the default width for the dialog.booleangetFillBox()get whether the box should be filled with colorintgetHeightPlot()get the height of each box plotintgetNumHorizontal()Get the number of box plots to display on each rowStringgetQuickInfo()Returns a quick info about the actor, which will be displayed in the GUI.booleangetSameAxis()gets whether the box plots are drawn using the same axisintgetWidthAx()Get the width of the left axis of each box plotintgetWidthPlot()Get the width of each box plotStringglobalInfo()Returns a string describing the object.StringheightPlotTipText()Tip text to display for the optionprotected BasePanelnewPanel()Creates the panel to display in the dialog.StringnumHorizontalTipText()Return a tip text for the number of box plots on each row propertyStringsameAxisTipText()Returns the tip text for this propertyvoidsetAttributes(Range val)Set the attributes to be displayed initiallyvoidsetColor(Color val)Set the color to fill the box plotsvoidsetFillBox(boolean val)Set whether the box plots should be filled with colorvoidsetHeightPlot(int val)Set the height of each box plotvoidsetNumHorizontal(int val)Set the number of box plots to display on each rowvoidsetSameAxis(boolean val)Set whether the box plots use the same axis scalevoidsetWidthAx(int val)Set the width of the left axis for each box plotvoidsetWidthPlot(int val)Set the width of each box plotbooleansupportsClear()Whether "clear" is supported and shows up in the menu.StringwidthAxTipText()Tip text to display for the optionStringwidthPlotTipText()Tip text to display for the option-
Methods inherited from class adams.flow.sink.AbstractGraphicalDisplay
canPauseOrResume, cleanUpGUI, clear, close, createMenuBar, getGraphicFileChooser, getMenuBar, getSendToClasses, getSendToItem, getShowFlowControlSubMenu, getTextFileChooser, getWriter, hasPanel, hasSendToItem, isPaused, pauseResumeFlow, saveAs, saveTextAs, setShowFlowControlSubMenu, setWriter, showFlowControlSubMenuTipText, stopFlow, supplyComponent, updateMenu, wrapUp, writerTipText
-
Methods inherited from class adams.flow.sink.AbstractDisplay
newDisplayRunnable, postDisplay, preDisplay
-
Methods inherited from class adams.flow.core.AbstractDisplay
backupState, cleanUp, cleanUpGUIKeepOpen, closeDisplay, createFrame, createTitle, currentInput, deregisterInWrapUp, deregisterWindow, deregisterWithEditor, displayTypeTipText, doCreateFrame, doExecute, doExecuteHeadless, getCreateFrame, getDefaultDisplayType, getDefaultShortTitle, getDefaultX, getDefaultY, getDisplayType, getFrame, getFrameDefaultCloseOperation, getHeight, getKeepOpen, getPanel, getShortTitle, getWidth, getX, getY, hasInput, heightTipText, initialize, input, postCreateFrame, preCreateFrame, registerWindow, registerWithEditor, reset, restoreState, setCreateFrame, setDisplayType, setHeight, setKeepOpen, setShortTitle, setWidth, setX, setY, shortTitleTipText, stopExecution, supportsHeadlessExecution, widthTipText, xTipText, yTipText
-
Methods inherited from class adams.flow.core.AbstractActor
annotationsTipText, canInspectOptions, canPerformSetUpCheck, compareTo, configureLogger, destroy, equals, execute, finalUpdateVariables, findVariables, findVariables, forceVariables, forCommandLine, forName, forName, getAdditionalInformation, getAnnotations, getDefaultName, getDetectedVariables, getErrorHandler, getFlowActors, getFlowExecutionListeningSupporter, getFullName, getName, getNextSibling, getParent, getParentComponent, getPreviousSibling, getRoot, getScopeHandler, getSilent, getSkip, getStopFlowOnError, getStopMessage, getStorageHandler, getVariables, handleError, handleException, hasErrorHandler, hasStopMessage, index, isBackedUp, isExecuted, isExecuting, isFinished, isHeadless, isStopped, nameTipText, performSetUpChecks, performVariableChecks, postExecute, preExecute, pruneBackup, pruneBackup, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setUp, setVariables, shallowCopy, shallowCopy, silentTipText, sizeOf, skipTipText, stopExecution, stopFlowOnErrorTipText, updateDetectedVariables, updatePrefix, updateVariables, variableChanged
-
Methods inherited from class adams.core.option.AbstractOptionHandler
cleanUpOptions, finishInit, getDefaultLoggingLevel, getOptionManager, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString
-
Methods inherited from class adams.core.logging.LoggingObject
getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface adams.flow.core.Actor
cleanUp, compareTo, destroy, equals, execute, findVariables, getAnnotations, getDefaultName, getDetectedVariables, getErrorHandler, getFlowExecutionListeningSupporter, getFullName, getName, getNextSibling, getParent, getParentComponent, getPreviousSibling, getRoot, getScopeHandler, getSilent, getSkip, getStopFlowOnError, getStopMessage, getStorageHandler, getVariables, handleError, hasErrorHandler, hasStopMessage, index, isExecuted, isFinished, isHeadless, isStopped, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setUp, setVariables, shallowCopy, shallowCopy, sizeOf, stopExecution, stopExecution, toCommandLine, variableChanged, wrapUp
-
Methods inherited from interface adams.core.AdditionalInformationHandler
getAdditionalInformation
-
Methods inherited from interface adams.flow.core.InputConsumer
currentInput, hasInput, input
-
Methods inherited from interface adams.core.logging.LoggingLevelHandler
getLoggingLevel, setLoggingLevel
-
Methods inherited from interface adams.core.logging.LoggingSupporter
getLogger, isLoggingEnabled
-
Methods inherited from interface adams.core.option.OptionHandler
cleanUpOptions, getOptionManager
-
Methods inherited from interface adams.core.VariablesInspectionHandler
canInspectOptions
-
-
-
-
Field Detail
-
m_BoxPlot
protected BoxPlotManager m_BoxPlot
panel to display on the actor
-
m_SameAxis
protected boolean m_SameAxis
same axis for each box plot
-
m_AttString
protected Range m_AttString
range of box plots to display, in string form
-
m_WidthPlot
protected int m_WidthPlot
width of plots to be drawn
-
m_HeightPlot
protected int m_HeightPlot
height of plots to be drawn
-
m_WidthAx
protected int m_WidthAx
same axis for each box plot
-
m_NumHorizontal
protected int m_NumHorizontal
Number of plots on each row
-
m_Fill
protected boolean m_Fill
Fill the box with color
-
m_Color
protected Color m_Color
Color to fill the box
-
-
Method Detail
-
accepts
public Class[] accepts()
Description copied from interface:InputConsumerReturns the class that the consumer accepts.- Specified by:
acceptsin interfaceInputConsumer- Returns:
- the Class of objects that can be processed
-
supportsClear
public boolean supportsClear()
Whether "clear" is supported and shows up in the menu.- Specified by:
supportsClearin interfaceClearableDisplay- Overrides:
supportsClearin classAbstractGraphicalDisplay- Returns:
- true if supported
-
clearPanel
public void clearPanel()
Description copied from class:AbstractDisplayClears the content of the panel.- Specified by:
clearPanelin classAbstractDisplay
-
newPanel
protected BasePanel newPanel()
Description copied from class:AbstractDisplayCreates the panel to display in the dialog.- Specified by:
newPanelin classAbstractDisplay- Returns:
- the panel
-
display
protected void display(Token token)
Description copied from class:AbstractDisplayDisplays the token (the panel and dialog have already been created at this stage).- Specified by:
displayin classAbstractDisplay- Parameters:
token- the token to display
-
defineOptions
public void defineOptions()
Adds options to the internal list of operations- Specified by:
defineOptionsin interfaceOptionHandler- Overrides:
defineOptionsin classAbstractGraphicalDisplay
-
getQuickInfo
public String getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.- Specified by:
getQuickInfoin interfaceActor- Specified by:
getQuickInfoin interfaceQuickInfoSupporter- Overrides:
getQuickInfoin classAbstractDisplay- Returns:
- null if no info available, otherwise short string
-
setFillBox
public void setFillBox(boolean val)
Set whether the box plots should be filled with color- Parameters:
val- True if box should be filled in
-
getFillBox
public boolean getFillBox()
get whether the box should be filled with color- Returns:
-
fillBoxTipText
public String fillBoxTipText()
Tip Text for the fill box property- Returns:
- String to explain the property
-
setColor
public void setColor(Color val)
Set the color to fill the box plots- Parameters:
val- Color to fill plots
-
getColor
public Color getColor()
Get the color to fill the box plots- Returns:
- Color used to fill
-
colorTipText
public String colorTipText()
Tip text for the color property- Returns:
- String to explain the property
-
setWidthPlot
public void setWidthPlot(int val)
Set the width of each box plot- Parameters:
val- Width in pixels
-
getWidthPlot
public int getWidthPlot()
Get the width of each box plot- Returns:
- Width in pixels
-
widthPlotTipText
public String widthPlotTipText()
Tip text to display for the option- Returns:
- Message string
-
setHeightPlot
public void setHeightPlot(int val)
Set the height of each box plot- Parameters:
val- Height in pixels
-
getHeightPlot
public int getHeightPlot()
get the height of each box plot- Returns:
- Height in pixels
-
heightPlotTipText
public String heightPlotTipText()
Tip text to display for the option- Returns:
- Message string
-
setWidthAx
public void setWidthAx(int val)
Set the width of the left axis for each box plot- Parameters:
val- Width in pixels
-
getWidthAx
public int getWidthAx()
Get the width of the left axis of each box plot- Returns:
- Width in pixels
-
widthAxTipText
public String widthAxTipText()
Tip text to display for the option- Returns:
- Message string
-
setNumHorizontal
public void setNumHorizontal(int val)
Set the number of box plots to display on each row- Parameters:
val- Number on each row
-
getNumHorizontal
public int getNumHorizontal()
Get the number of box plots to display on each row- Returns:
- number on each row
-
numHorizontalTipText
public String numHorizontalTipText()
Return a tip text for the number of box plots on each row property- Returns:
- tip text for the property
-
globalInfo
public String globalInfo()
Description copied from class:AbstractOptionHandlerReturns a string describing the object.- Specified by:
globalInfoin interfaceGlobalInfoSupporter- Specified by:
globalInfoin classAbstractOptionHandler- Returns:
- a description suitable for displaying in the gui
-
getDefaultWidth
protected int getDefaultWidth()
Description copied from class:AbstractDisplayReturns the default width for the dialog.- Overrides:
getDefaultWidthin classAbstractDisplay- Returns:
- the default width
-
getDefaultHeight
protected int getDefaultHeight()
Description copied from class:AbstractDisplayReturns the default height for the dialog.- Overrides:
getDefaultHeightin classAbstractDisplay- Returns:
- the default height
-
setAttributes
public void setAttributes(Range val)
Set the attributes to be displayed initially- Parameters:
val- String to create the range object
-
getAttributes
public Range getAttributes()
get the attributes to be displayed initially- Returns:
- String to create the range object
-
attributesTipText
public String attributesTipText()
Tip text to display for the option- Returns:
- String to display
-
setSameAxis
public void setSameAxis(boolean val)
Set whether the box plots use the same axis scale- Parameters:
val- True if box plots use same axis
-
getSameAxis
public boolean getSameAxis()
gets whether the box plots are drawn using the same axis- Returns:
- true if box plots use the same axis scale
-
sameAxisTipText
public String sameAxisTipText()
Returns the tip text for this property- Returns:
- Tip text for this property
-
createDisplayPanel
public DisplayPanel createDisplayPanel(Token token)
Creates a new display panel for the token.- Specified by:
createDisplayPanelin interfaceDisplayPanelProvider- Parameters:
token- the token to display in a new panel, can be null- Returns:
- the generated panel
-
displayPanelRequiresScrollPane
public boolean displayPanelRequiresScrollPane()
Returns whether the created display panel requires a scroll pane or not.- Specified by:
displayPanelRequiresScrollPanein interfaceDisplayPanelProvider- Returns:
- true if the display panel requires a scroll pane
-
-