spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models

Compound models for object parameter definitions and values. These models concatenate several ‘single’ models and one ‘empty’ model.

authors:

13. Marin (KTH)

date:

28.6.2019

Module Contents

Classes

CompoundParameterModel	A model that concatenates several single parameter models
CompoundObjectParameterMixin	Implements the interface for populating and filtering a compound object parameter model.
CompoundRelationshipParameterMixin	Implements the interface for populating and filtering a compound relationship parameter model.
CompoundParameterDefinitionMixin	Handles signals from db mngr for parameter_definition models.
CompoundParameterValueMixin	Handles signals from db mngr for parameter_value models.
CompoundObjectParameterDefinitionModel	A model that concatenates several single object parameter_definition models
CompoundRelationshipParameterDefinitionModel	A model that concatenates several single relationship parameter_definition models
CompoundObjectParameterValueModel	A model that concatenates several single object parameter_value models
CompoundRelationshipParameterValueModel	A model that concatenates several single relationship parameter_value models

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterModel(parent, db_mngr, *db_maps)

Bases: spinetoolbox.mvcmodels.compound_table_model.CompoundWithEmptyTableModel

A model that concatenates several single parameter models and one empty parameter model.

Initializes model.

Parameters:

• parent (SpineDBEditor) – the parent object
• db_mngr (SpineDBManager) – the database manager
• *db_maps (DiffDatabaseMapping) – the database maps included in the model

data_for_single_model_received

Emitted by the fetcher when there’s data for another single model.

entity_class_type

Returns the entity_class type, either ‘object_class’ or ‘relationship_class’.

Returns:str

item_type

Returns the parameter item type, either ‘parameter_definition’ or ‘parameter_value’.

Returns:str

_single_model_type

Returns a constructor for the single models.

Returns:SingleParameterModel

_empty_model_type

Returns a constructor for the empty model.

Returns:EmptyParameterModel

entity_class_id_key

Returns the key corresponding to the entity_class id (either “object_class_id” or “relationship_class_id”)

Returns:str

parameter_definition_id_key

_make_header(self)

init_model(self)

Initializes the model.

_make_auto_filter_menus(self)

Makes auto filter menus.

get_auto_filter_menu(self, logical_index)

Returns auto filter menu for given logical index from header view.

Parameters:logical_index (int) – Returns:ParameterViewFilterMenu

_modify_data_in_filter_menus(self, action, db_map, db_items)

Modifies data in filter menus.

Parameters:

• action (str) – either ‘add’, ‘remove’, or ‘update’
• db_map (DiffDatabaseMapping) –
• db_items (list(dict)) –

_do_add_data_to_filter_menus(self, db_map, db_items)

_do_update_data_in_filter_menus(self, db_map, db_items)

_do_remove_data_from_filter_menus(self, db_map, db_items)

headerData(self, section, orientation=Qt.Horizontal, role=Qt.DisplayRole)

Returns an italic font in case the given column has an autofilter installed.

_create_single_models(self)

Returns a list of single models for this compound model, one for each entity_class in each database.

Returns:list

_create_empty_model(self)

Returns the empty model for this compound model.

Returns:EmptyParameterModel

filter_accepts_model(self, model)

Returns a boolean indicating whether or not the given model passes the filter for compound model.

Parameters:model (SingleParameterModel, EmptyParameterModel) – Returns:bool

_class_filter_accepts_model(self, model)

_auto_filter_accepts_model(self, model)

accepted_single_models(self)

Returns a list of accepted single models by calling filter_accepts_model on each of them, just for convenience.

Returns:list

static _settattr_if_different(obj, attr, val)

Sets the given attribute of the given object to the given value if it’s different from the one currently stored. Used for updating filters.

Returns:True if the attributed was set, False otherwise Return type:bool

_invalidate_filter(self)

Sets the filter invalid.

_refresh_if_still_invalid(self)

set_filter_class_ids(self, class_ids)

set_filter_parameter_ids(self, parameter_ids)

set_auto_filter(self, field, auto_filter)

Updates and applies the auto filter.

Parameters:

• field (str) – the field name
• auto_filter (dict) – mapping db_map to entity_class id to accepted values for the field

set_compound_auto_filter(self, field, auto_filter)

Sets the auto filter for given column in the compound model.

Parameters:

• field (str) – the field name
• auto_filter (dict) – maps tuple (database map, entity_class id) to list of accepted ids for the field

set_single_auto_filter(self, model, field)

Sets the auto filter for given column in the given single model.

Parameters:

• model (SingleParameterModel) – the model
• field (str) – the field name

Returns:

True if the auto-filtered values were updated, None otherwise

Return type:

bool

_row_map_for_model(self, model)

Returns the row map for the given model. Reimplemented to take filter status into account.

Parameters:model (SingleParameterModel, EmptyParameterModel) – Returns:tuples (model, row number) for each accepted row Return type:list

_models_with_db_map(self, db_map)

Returns a collection of single models with given db_map.

Parameters:db_map (DiffDatabaseMapping) – Returns:list

receive_entity_classes_removed(self, db_map_data)

Runs when entity classes are removed from the dbs. Removes sub-models for the given entity classes and dbs.

Parameters:db_map_data (dict) – list of removed dict-items keyed by DiffDatabaseMapping

_items_per_class(self, items)

Returns a dict mapping entity_class ids to a set of items.

Parameters:items (list) – Returns:dict

receive_parameter_data_added(self, db_map_data)

Runs when either parameter definitions or values are added to the dbs. Adds necessary sub-models and initializes them with data. Also notifies the empty model so it can remove rows that are already in.

Parameters:db_map_data (dict) – list of removed dict-items keyed by DiffDatabaseMapping

create_and_append_single_model(self, db_map, entity_class_id, ids)

receive_parameter_data_updated(self, db_map_data)

Runs when either parameter definitions or values are updated in the dbs. Emits dataChanged so the parameter_name column is refreshed.

Parameters:db_map_data (dict) – list of updated dict-items keyed by DiffDatabaseMapping

receive_parameter_data_removed(self, db_map_data)

Runs when either parameter definitions or values are removed from the dbs. Removes the affected rows from the corresponding single models.

Parameters:db_map_data (dict) – list of removed dict-items keyed by DiffDatabaseMapping

_emit_data_changed_for_column(self, field)

Lazily emits data changed for an entire column.

Parameters:field (str) – the column header

db_item(self, index)

index_name(self, index)

get_set_data_delayed(self, index)

Returns a function that ParameterValueEditor can call to set data for the given index at any later time, even if the model changes.

Parameters:index (QModelIndex) – Returns:function

get_entity_class_id(self, index, db_map)

filter_by(self, rows_per_column)

filter_excluding(self, rows_per_column)

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundObjectParameterMixin

Implements the interface for populating and filtering a compound object parameter model.

entity_class_type

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundRelationshipParameterMixin

Implements the interface for populating and filtering a compound relationship parameter model.

entity_class_type

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterDefinitionMixin

Handles signals from db mngr for parameter_definition models.

item_type

receive_parameter_definition_tags_set(self, db_map_data)

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterValueMixin

Handles signals from db mngr for parameter_value models.

item_type

entity_type

Returns the entity type, either ‘object’ or ‘relationship’ Used by update_single_main_filter.

Returns:str

set_filter_entity_ids(self, entity_ids)

set_filter_alternative_ids(self, alternative_ids)

receive_alternatives_updated(self, db_map_data)

Updated alternative column

Parameters:db_map_data (dict) – list of updated dict-items keyed by DiffDatabaseMapping

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundObjectParameterDefinitionModel(parent, db_mngr, *db_maps)

Bases: spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundObjectParameterMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterDefinitionMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterModel

A model that concatenates several single object parameter_definition models and one empty object parameter_definition model.

Initializes model.

Parameters:

• parent (SpineDBEditor) – the parent object
• db_mngr (SpineDBManager) – the database manager
• *db_maps (DiffDatabaseMapping) – the database maps included in the model

_make_header(self)

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundRelationshipParameterDefinitionModel(parent, db_mngr, *db_maps)

Bases: spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundRelationshipParameterMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterDefinitionMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterModel

A model that concatenates several single relationship parameter_definition models and one empty relationship parameter_definition model.

Initializes model.

Parameters:

• parent (SpineDBEditor) – the parent object
• db_mngr (SpineDBManager) – the database manager
• *db_maps (DiffDatabaseMapping) – the database maps included in the model

_make_header(self)

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundObjectParameterValueModel(parent, db_mngr, *db_maps)

Bases: spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundObjectParameterMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterValueMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterModel

A model that concatenates several single object parameter_value models and one empty object parameter_value model.

Initializes model.

Parameters:

• parent (SpineDBEditor) – the parent object
• db_mngr (SpineDBManager) – the database manager
• *db_maps (DiffDatabaseMapping) – the database maps included in the model

entity_type

Returns the entity type, either ‘object’ or ‘relationship’ Used by update_single_main_filter.

Returns:str

_make_header(self)

class spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundRelationshipParameterValueModel(parent, db_mngr, *db_maps)

Bases: spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundRelationshipParameterMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterValueMixin, spinetoolbox.spine_db_editor.mvcmodels.compound_parameter_models.CompoundParameterModel

A model that concatenates several single relationship parameter_value models and one empty relationship parameter_value model.

Initializes model.

Parameters:

• parent (SpineDBEditor) – the parent object
• db_mngr (SpineDBManager) – the database manager
• *db_maps (DiffDatabaseMapping) – the database maps included in the model

entity_type

Returns the entity type, either ‘object’ or ‘relationship’ Used by update_single_main_filter.

Returns:str

_make_header(self)