Interface CyGroupSettingsManager


public interface CyGroupSettingsManager
The CyGroupSettingsManager is responsible for providing an interface to all of the possible settings controlling CyGroups, including the default settings and group specific settings. This includes both view settings as well as the various aggregation settings.

Module: group-api

To use this in your app, include the following dependency in your POM:

<dependency>
    <groupId>org.cytoscape</groupId>
    <artifactId>group-api</artifactId>
</dependency>

Cytoscape Backwards Compatibility (API Interface): We expect that this interface will be used but not implemented by developers using this interface. As such, we reserve the right to add methods to the interface as part of minor version upgrades. We will not remove methods for any changes other than major version upgrades.
  • Method Details

    • getDoubleClickAction

      Get the current default CyGroupSettingsManager.DoubleClickAction. All new groups will utilize this action unless changed by a group-specific set.
      Returns:
      the current default DoubleClickAction
    • getDoubleClickAction

      Get the current CyGroupSettingsManager.DoubleClickAction for the specified group.
      Parameters:
      group - the CyGroup we're interested in
      Returns:
      the current DoubleClickAction for this group
    • setDoubleClickAction

      void setDoubleClickAction(CyGroupSettingsManager.DoubleClickAction action)
      Set the current default CyGroupSettingsManager.DoubleClickAction. All new groups will utilize this action unless changed by a group-specific set.
      Parameters:
      action - the CyGroupSettingsManager.DoubleClickAction to set as the default
    • setDoubleClickAction

      void setDoubleClickAction(CyGroup group, CyGroupSettingsManager.DoubleClickAction action)
      Set the CyGroupSettingsManager.DoubleClickAction for a specific group.
      Parameters:
      group - the CyGroup to set the value for
      action - the CyGroupSettingsManager.DoubleClickAction to set for this group
    • getGroupViewType

      Get the current default CyGroupSettingsManager.GroupViewType. All new groups will utilize this visualization unless overridden by a specific setting
      Returns:
      the current default CyGroupSettingsManager.GroupViewType to set
    • getGroupViewType

      Get the current CyGroupSettingsManager.GroupViewType for the specified group.
      Parameters:
      group - the CyGroup we're interested in
      Returns:
      the current CyGroupSettingsManager.GroupViewType for this group
    • setGroupViewType

      void setGroupViewType(CyGroupSettingsManager.GroupViewType action)
      Set the current default CyGroupSettingsManager.GroupViewType. All new groups will utilize this visualization unless changed by a group-specific set.
      Parameters:
      action - the CyGroupSettingsManager.GroupViewType to set as the default
    • setGroupViewType

      void setGroupViewType(CyGroup group, CyGroupSettingsManager.GroupViewType action)
      Set the CyGroupSettingsManager.GroupViewType for a specific group.
      Parameters:
      group - the CyGroup to set the value for
      action - the CyGroupSettingsManager.GroupViewType to set for this group
    • getUseNestedNetworks

      boolean getUseNestedNetworks()
      Get the default setting for whether or not to create a nested network view on collapsed nodes.
      Returns:
      use nested network image on collapsed nodes if true
    • getUseNestedNetworks

      boolean getUseNestedNetworks(CyGroup group)
      Get the setting for whether or not to create a nested network view on collapsed nodes for the specified CyGroup.
      Parameters:
      group - the CyGroup we want to get the nested network setting for
      Returns:
      use nested network image on collapsed nodes if true
    • setUseNestedNetworks

      void setUseNestedNetworks(boolean useNestedNetwork)
      Set the default setting for whether or not to create a nested network view on collapsed nodes.
      Parameters:
      useNestedNetwork - if true, create a nested network image by default
    • setUseNestedNetworks

      void setUseNestedNetworks(CyGroup group, boolean useNestedNetwork)
      Set the setting for whether or not to create a nested network view on collapsed nodes for a specific CyGroup.
      Parameters:
      group - the CyGroup we're setting
      useNestedNetwork - if true, create a nested network image by default
    • getEnableAttributeAggregation

      boolean getEnableAttributeAggregation()
      Get the setting for whether or not we're enabling aggregation. If the return value is true, then the values in the member nodes will be aggregated onto the corresponding column in the group node.
      Returns:
      true if we are aggregating values, false otherwise
    • getEnableAttributeAggregation

      boolean getEnableAttributeAggregation(CyGroup group)
      Get the setting for whether or not we're enabling aggregation for a specific group. If the return value is true, then the values in the member nodes will be aggregated onto the corresponding column in the group node.
      Parameters:
      group - the CyGroup we're interested in
      Returns:
      true if we are aggregating values, false otherwise
    • setEnableAttributeAggregation

      void setEnableAttributeAggregation(boolean aggregate)
      Set the setting for whether or not we're aggregating values from member nodes onto the group node.
      Parameters:
      aggregate - true if we are aggregating values, false otherwise
    • setEnableAttributeAggregation

      void setEnableAttributeAggregation(CyGroup group, boolean aggregate)
      Set the setting for whether or not we're aggregating values for member nodes onto the group node for a specific group.
      Parameters:
      group - the CyGroup we're interested in
      aggregate - true if we are aggregating values, false otherwise
    • getAggregator

      Aggregator<?> getAggregator(CyGroup group, CyColumn column)
      Get the Aggregator that will be used to aggregate the values in a specific CyColumn for all of the nodes in a group onto the corresponding column in the group node. The returned Aggregator will take into account any overrides and group-specific settings, if there are any.
      Parameters:
      group - the CyGroup to get the Aggregator for
      column - the CyColumn to get the Aggregator for
      Returns:
      the Aggregator for the specific group and column
    • getDefaultAggregation

      Aggregator<?> getDefaultAggregation(Class<?> ovClass)
      Get the default Aggregator for a specific column type as expressed as a java Class.
      Parameters:
      ovClass - the Class to get the default Aggregator for
      Returns:
      the default Aggregator for the specific Class
    • getDefaultListAggregation

      Aggregator<?> getDefaultListAggregation(Class<?> ovClass)
      Get the default Aggregator for a specific List column type as expressed as a java Class.
      Parameters:
      ovClass - the List Class to get the default Aggregator for
      Returns:
      the default Aggregator for the specific Class
    • setDefaultAggregation

      void setDefaultAggregation(Class<?> ovClass, Aggregator<?> agg)
      Set the default Aggregator for a specific column type as expressed as a java Class.
      Parameters:
      ovClass - the Class to get the default Aggregator for
      agg - the Aggregator to set as the default for the specified Class
    • setDefaultListAggregation

      void setDefaultListAggregation(Class<?> ovClass, Aggregator<?> agg)
      Set the default Aggregator for a specific List column type as expressed as a java Class.
      Parameters:
      ovClass - the List Class to set the default Aggregator for
      agg - the Aggregator to set as the default for the specified Class
    • getDefaultAggregation

      Aggregator<?> getDefaultAggregation(CyGroup group, Class<?> ovClass)
      Get the Aggregator for a specific column type as expressed as a java Class that will be used in the specified CyGroup.
      Parameters:
      group - the CyGroup to get the Aggregator for
      ovClass - the Class to get the Aggregator for
      Returns:
      the Aggregator for the specific Class in this CyGroup
    • getDefaultListAggregation

      Aggregator<?> getDefaultListAggregation(CyGroup group, Class<?> ovClass)
      Get the Aggregator for a specific List column type as expressed as a java Class that will be used in the specified CyGroup.
      Parameters:
      group - the CyGroup to get the Aggregator for
      ovClass - the Class to get the Aggregator for
      Returns:
      the Aggregator for the specific Class in this CyGroup
    • setDefaultAggregation

      void setDefaultAggregation(CyGroup group, Class<?> ovClass, Aggregator<?> agg)
      Set the Aggregator for a specific column type as expressed as a java Class that will be used in the specified CyGroup.
      Parameters:
      group - the CyGroup to get the Aggregator for
      ovClass - the Class to get the Aggregator for
      agg - the Aggregator to use for the specified Class in this CyGroup
    • setDefaultListAggregation

      void setDefaultListAggregation(CyGroup group, Class<?> ovClass, Aggregator<?> agg)
      Set the Aggregator for a specific List column type as expressed as a java Class that will be used in the specified CyGroup.
      Parameters:
      group - the CyGroup to set the Aggregator to
      ovClass - the Class to set the Aggregator to
      agg - the Aggregator to use for the specified Class in this CyGroup
    • setDefaultAggregation

      void setDefaultAggregation(CyGroup group, Class<?> ovClass, String aggName)
      Set the Aggregator for a specific column type as expressed as a java Class that will be used in the specified CyGroup.
      Parameters:
      group - the CyGroup to set the Aggregator to
      ovClass - the Class to et the Aggregator to
      aggName - the name of the Aggregator to use for the specified Class in this CyGroup
    • setDefaultListAggregation

      void setDefaultListAggregation(CyGroup group, Class<?> ovClass, String aggName)
      Set the Aggregator for a specific List column type as expressed as a java Class that will be used in the specified CyGroup.
      Parameters:
      group - the CyGroup to set the Aggregator to
      ovClass - the List Class to set the Aggregator to
      aggName - the name of the Aggregator to use for the specified Class in this CyGroup
    • getOverrideAggregation

      Aggregator<?> getOverrideAggregation(CyColumn column)
      Get the override aggregation setting for a column (if any). Override aggregation provides the ability to override the Aggregator used for a specific column. For example we may not want to aggregate the "shared node" column.
      Parameters:
      column - the CyColumn to get the default override for
      Returns:
      the Aggregator for this column, or null if no override was set
    • setOverrideAggregation

      void setOverrideAggregation(CyColumn column, Aggregator<?> agg)
      set the override aggregation setting for a column (if any). Override aggregation provides the ability to override the Aggregator used for a specific column. For example we may not want to aggregate the "shared node" column.
      Parameters:
      column - the CyColumn to set the default override for
      agg - the Aggregator for this column
    • getOverrideAggregation

      Aggregator<?> getOverrideAggregation(CyGroup group, CyColumn column)
      Get the override aggregation setting for a column (if any) in a specific group. Override aggregation provides the ability to override the Aggregator used for a specific column. For example we may not want to aggregate the "shared node" column.
      Parameters:
      group - the CyGroup to get the Aggregator for
      column - the CyColumn to get the override for
      Returns:
      the Aggregator for this column in this group, or null if no override was set
    • setOverrideAggregation

      void setOverrideAggregation(CyGroup group, CyColumn column, Aggregator<?> agg)
      set the override aggregation setting for a column in a group (if any). Override aggregation provides the ability to override the Aggregator used for a specific column. For example we may not want to aggregate the "shared node" column.
      Parameters:
      group - the CyGroup to set the Aggregator for
      column - the CyColumn to set the default override for
      agg - the Aggregator for this column in this group