Perform a property update operation on all geo objects that satisfy the specified selection criteria Parameters ---------- patch: dict Dictionary of property updates to be applied to all geo objects that satisfy the selection criteria
(
self, patch=None, selector=None, overwrite=False, row=None, col=None, **kwargs
)
| 22582 | return self |
| 22583 | |
| 22584 | def update_geos( |
| 22585 | self, patch=None, selector=None, overwrite=False, row=None, col=None, **kwargs |
| 22586 | ) -> "FigureWidget": |
| 22587 | """ |
| 22588 | Perform a property update operation on all geo objects |
| 22589 | that satisfy the specified selection criteria |
| 22590 | |
| 22591 | Parameters |
| 22592 | ---------- |
| 22593 | patch: dict |
| 22594 | Dictionary of property updates to be applied to all |
| 22595 | geo objects that satisfy the selection criteria. |
| 22596 | selector: dict, function, or None (default None) |
| 22597 | Dict to use as selection criteria. |
| 22598 | geo objects will be selected if they contain |
| 22599 | properties corresponding to all of the dictionary's keys, with |
| 22600 | values that exactly match the supplied values. If None |
| 22601 | (the default), all geo objects are selected. If a |
| 22602 | function, it must be a function accepting a single argument and |
| 22603 | returning a boolean. The function will be called on each |
| 22604 | geo and those for which the function returned True will |
| 22605 | be in the selection. |
| 22606 | overwrite: bool |
| 22607 | If True, overwrite existing properties. If False, apply updates |
| 22608 | to existing properties recursively, preserving existing |
| 22609 | properties that are not specified in the update operation. |
| 22610 | row, col: int or None (default None) |
| 22611 | Subplot row and column index of geo objects to select. |
| 22612 | To select geo objects by row and column, the Figure |
| 22613 | must have been created using plotly.subplots.make_subplots. |
| 22614 | If None (the default), all geo objects are selected. |
| 22615 | **kwargs |
| 22616 | Additional property updates to apply to each selected |
| 22617 | geo object. If a property is specified in |
| 22618 | both patch and in **kwargs then the one in **kwargs |
| 22619 | takes precedence. |
| 22620 | Returns |
| 22621 | ------- |
| 22622 | self |
| 22623 | Returns the FigureWidget object that the method was called on |
| 22624 | """ |
| 22625 | for obj in self.select_geos(selector=selector, row=row, col=col): |
| 22626 | obj.update(patch, overwrite=overwrite, **kwargs) |
| 22627 | |
| 22628 | return self |
| 22629 | |
| 22630 | def select_legends(self, selector=None, row=None, col=None): |
| 22631 | """ |
nothing calls this directly
no test coverage detected