h ~SSKJr SSKJrJrJrJr SSKJrJ r \(a SSK J r SSK J r SS Sjjrg) ) annotations)IterableHashable TYPE_CHECKINGOptional) DXFValueErrorDXFAttributeError) DXFEntity)KeyFuncNcF^[TU45(a [S5eTS:waU4SjnUc [S5e[5nUHGnUR(dMU"U5nUcM$UR U/5nUR U5 MI U$![a MZf=f)a Groups a sequence of DXF entities by a DXF attribute like ``'layer'``, returns a dict with `dxfattrib` values as key and a list of entities matching this `dxfattrib`. A `key` function can be used to combine some DXF attributes (e.g. layer and color) and should return a hashable data type like a tuple of strings, integers or floats, `key` function example:: def group_key(entity: DXFEntity): return entity.dxf.layer, entity.dxf.color For not suitable DXF entities return ``None`` to exclude this entity, in this case it's not required, because :func:`groupby` catches :class:`DXFAttributeError` exceptions to exclude entities, which do not provide layer and/or color attributes, automatically. Result dict for `dxfattrib` = ``'layer'`` may look like this:: { '0': [ ... list of entities ], 'ExampleLayer1': [ ... ], 'ExampleLayer2': [ ... ], ... } Result dict for `key` = `group_key`, which returns a ``(layer, color)`` tuple, may look like this:: { ('0', 1): [ ... list of entities ], ('0', 3): [ ... ], ('0', 7): [ ... ], ('ExampleLayer1', 1): [ ... ], ('ExampleLayer1', 2): [ ... ], ('ExampleLayer1', 5): [ ... ], ('ExampleLayer2', 7): [ ... ], ... } All entity containers (modelspace, paperspace layouts and blocks) and the :class:`~ezdxf.query.EntityQuery` object have a dedicated :meth:`groupby` method. Args: entities: sequence of DXF entities to group by a DXF attribute or a `key` function dxfattrib: grouping DXF attribute like ``'layer'`` key: key function, which accepts a :class:`DXFEntity` as argument and returns a hashable grouping key or ``None`` to ignore this entity z4Specify a dxfattrib or a key function, but not both.c:>URRT5$)N)dxf get_default)entity dxfattribs ?/var/www/html/env/lib/python3.13/site-packages/ezdxf/groupby.pygroupby..KsVZZ33I>zMno valid argument found, specify a dxfattrib or a key function, but not both.)allrdictis_aliver setdefaultappend)entitiesrkeyresult dxf_entity group_keygroups ` rgroupbyr"sp Is  B  B> {   /3fF ""  JI  %%i4E LL $ M !   sB B B )r N)rzIterable[DXFEntity]rstrrzOptional[KeyFunc]returnzdict[Hashable, list[DXFEntity]]) __future__rtypingrrrrezdxf.lldxf.constrr ezdxf.entitiesr ezdxf.eztypesr r"rrr+sR#>>>(% !P!PP P% Pr