Ph7 dZddlmZmZmZmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZddlmZmZddlmZddlmZddlmZgd Ze eZeeefZed Zeee eefZ erejBee efZ"n ejBZ"ed d Z#Gdd ejBZ$ dde e%de e%deee"gee$ffdZ&GddZ'GddZ(dejRddfdZ*y)z.The user interface to define skip connections.) TYPE_CHECKINGAnyCallableClassVarDict FrozenSet GeneratorIterableListOptionalSetSequenceTupleTypeTypeVarUnioncast)Tensornn)Batch) Namespace)current_skip_tracker) skippablestashpopverify_skippables)rrT Skippable)boundc ReZdZUdZeeeed<eee ed<eee ed<de de ddffd Z de fd Z d e de ee ffd Zdee ee ffd Zdee ee ffdZdddededeee defdZdee eegdfdee geeffdZdeee efdefdZxZS)r zThe base class for skippable modules. Do not use this class directly. Define a subclass by :func:`skippable` instead. module_clsstashable_namespoppable_namesargskwargsreturnNc^t||j|i||_i|_yN)super__init__r#module namespaces)selfr&r' __class__s yC:\Users\daisl\Desktop\realtime-object-detection\venv\Lib\site-packages\torch/distributed/pipeline/sync/skip/skippable.pyr,zSkippable.__init__?s, %doot6v6 02c"d|jdS)Nz @skippable())r-)r/s r1__repr__zSkippable.__repr__DsT[[M++r2namec`|jj|}tt|}||fS)z*Prepend namespace for the given skip name.)r.getrr)r/r6nss r1 namespacedzSkippable.namespacedGs, __  & )R Dzr2c#TK|jD]}|j|yw)z1Iterate over namespaced skip names to be stashed.N)r$r:r/r6s r1 stashablezSkippable.stashableMs%((D//$' ')&(c#TK|jD]}|j|yw)z0Iterate over namespaced skip names to be popped.N)r%r:r<s r1poppablezSkippable.poppableRs%''D//$' '(r>)onlyr/r9rAc||j|jz}n t|}|D]}||j|<|S)aIsolate a specified subset or the whole set of skip tensors. In a single sequential module, skip tensors with the same name are not allowed unless they are isolated by different namespaces. Here's an example using the same name for skip tensors twice. Each pair of ``Layer1`` and ``Layer2`` is isolated with its own namespace ``ns1`` and ``ns2``. There is no conflict anymore:: ns1 = Namespace() ns2 = Namespace() model = nn.Sequential( Layer1().isolate(ns1), Layer1().isolate(ns2), Layer2(), Layer3().isolate(ns2), Layer3().isolate(ns1), ) When `only` parameter is omitted, all skip tensors are isolated. You can isolate a subset of skip tensors by passing `only` parameter:: ns_alice = Namespace() ns_bob = Namespace() model = nn.Sequential( ... StashStashPop().isolate(ns_alice, only=['alice']) \ .isolate(ns_bob, only=['bob']), ... ) Args: ns (Namespace): namespace for isolation Keyword Args: only (iterable of strs): names of specific skip tensors to be isolated (omit this option to isolate all skip tensors declared in this module) Returns: this module itself )r$r%setr.)r/r9rAnamesr6s r1isolatezSkippable.isolateWsHb <((4+>+>>EIED$&DOOD ! r2 handle_stash handle_popc|j|}t|ts|}|S t|} t|tr)||j |j t|}:t|tr$||j }|j|}nt|d#t$r}|jd}|cYd}~Sd}~wwxYw)z}Dispatch :class:`stash` or :class:`pop` commands. The commands are generated by the module's ``forward()``. z! is not a command from @skippablerN) r- isinstancer nextrr6tensorrsend TypeError StopIterationr&) r/inputrFrG generatoroutputoprKstops r1dispatchzSkippable.dispatchsKK& )Y/FM iBb%( "))4iBb#&'0F"/B2&(I JKK YYq\FM sBB.. C7C C CrOct}iit|}jD]\}} |j||||<|j }dtdttddffd }dtdttffd }j|||} jjz } | r&d jd | D} t | d j} | r&d jd | D} t | d t| }jD]\}}|} |j||||  |j } | S#t$r}t d|d|d}~wwxYw)a Perform the forward propagation. :class:`stash` or :class:`pop` commands will be handled by portals silently. The portals won't be exposed to users. Raises: RuntimeError: illegal 'stash' or 'pop' is found. 'z' has not been stashedNr6rKr(cJ|jvrtd|d||<y)NrVz$' has not been declared as stashable)r$ RuntimeError)r6rKr/stashed_tensorss r1rFz'Skippable.forward..handle_stashs04///"Qtf,P#QRR$*OD !r2c`|jvrtd|dj|S)NrVz#' has not been declared as poppable)r%rXr)r6poppable_tensorsr/s r1rGz%Skippable.forward..handle_pops74..."Qtf,O#PQQ#''- -r2z, c3(K|] }d|d ywrVN.0ns r1 z$Skippable.forward..s#Bkas!Hkz must be stashed but have notc3(K|] }d|d ywr]r^r_s r1rbz$Skippable.forward..s#Ajas!Hjrcz must be popped but have not)rrr@loadKeyErrorrXvaluesstrr rrTr$keysjoinr=save)r/rO skip_trackerbatchr9r6erFrGrQ not_stashed comma_names not_poppedrKr[rYs` @@r1forwardzSkippable.forwards,- 79e  HB L)5):):5"d)K &(   +s +HV,< + +  .S .Xf%5 . ulJ?**_-A-A-CC ))#Bk#BBK+.KLM M%**, ))#Aj#AAK+.JKL Lf (HB$T*F   eRv 6) G L"Qtf,B#CD!K LsE(( F1FF)__name__ __module__ __qualname____doc__rrSkippableModule__annotations__rrhrr,r5rrr:r r=r@rr rErrrTrr TensorOrTensorsrr __classcell__)r0s@r1r r 3sAo.//in--Ys^,,3c3S3T3 ,#,suY^'< (8E)S.$9:( ((5C#89( LP9a9Y9(3-1H9TU9v#Xf%56<=#cUHV$445 #J7U49f#457/7r2rrr(cxt|t|dttdttffd }|S)aDefine a decorator to create :class:`nn.Module ` with skip connections. These decorated modules are called "skippable". This functionality works perfectly fine even when the module is not wrapped by :class:`~torch.distributed.pipeline.sync.Pipe`. Each skip tensor is managed by its name. Before manipulating skip tensors, a skippable module must statically declare the names for skip tensors by `stash` and/or `pop` parameters. Skip tensors with pre-declared name can be stashed by ``yield stash(name, tensor)`` or popped by ``tensor = yield pop(name)``. Here is an example with three layers. A skip tensor named "1to3" is stashed and popped at the first and last layer, respectively:: @skippable(stash=['1to3']) class Layer1(nn.Module): def forward(self, input): yield stash('1to3', input) return f1(input) class Layer2(nn.Module): def forward(self, input): return f2(input) @skippable(pop=['1to3']) class Layer3(nn.Module): def forward(self, input): skip_1to3 = yield pop('1to3') return f3(input) + skip_1to3 model = nn.Sequential(Layer1(), Layer2(), Layer3()) One skippable module can stash or pop multiple skip tensors:: @skippable(stash=['alice', 'bob'], pop=['carol']) class StashStashPop(nn.Module): def forward(self, input): yield stash('alice', f_alice(input)) yield stash('bob', f_bob(input)) carol = yield pop('carol') return input + carol Every skip tensor must be associated with exactly one pair of `stash` and `pop`. :class:`~torch.distributed.pipeline.sync.Pipe` checks this restriction automatically when wrapping a module. You can also check the restriction by :func:`verify_skippables` without :class:`~torch.distributed.pipeline.sync.Pipe`. r#r(cP|j}tf}|d}t|||S)N)r#r$r%)rsr type)r#r6basesattrsr%r$s r1extend_skippablez#skippable..extend_skippable)s1"" )oaopD%''r2) frozensetrrwr )rrrr%r$s @@r1rrs=h &Os^N(T/%:(tI( r2c.eZdZdZdZdedeeddfdZy)raThe command to stash a skip tensor. :: def forward(self, input): yield stash('name', input) return f(input) Args: name (str): name of skip tensor input (torch.Tensor or None): tensor to pass to the skip connection r6rKr6rKr(Nc ||_||_yr*r)r/r6rKs r1r,zstash.__init__Cs  r2) rsrtrurv __slots__rhr rr,r^r2r1rr2s- #IS(6*:tr2c$eZdZdZdZdeddfdZy)ra+The command to pop a skip tensor. :: def forward(self, input): skip = yield pop('name') return f(input) + skip Args: name (str): name of skip tensor Returns: the skip tensor previously stashed by another layer under the same name r6r6r(Nc||_yr*rr<s r1r,z pop.__init__[s  r2)rsrtrurvrrhr,r^r2r1rrHs! ISTr2r-Nc8t}t}g}|jD]&\}}t|ts|j|j zD]}d|d|d}|j ||jD]H\}}||j vr||f|vrd|d|d}|j |6|j||fJ|jD]i\}}||jvr||f|vrd|d|d}|j |6||f|vrd|d|d}|j |W|j||fk)||z D]\} }d|d }|j ||r$td d jd |Dzy )uVerify if the underlying skippable modules satisfy integrity. Every skip tensor must have only one pair of `stash` and `pop`. If there are one or more unmatched pairs, it will raise :exc:`TypeError` with the detailed messages. Here are a few failure cases. :func:`verify_skippables` will report failure for these cases:: # Layer1 stashes "1to3". # Layer3 pops "1to3". nn.Sequential(Layer1(), Layer2()) # └──── ? nn.Sequential(Layer2(), Layer3()) # ? ────┘ nn.Sequential(Layer1(), Layer2(), Layer3(), Layer3()) # └───────────────────┘ ^^^^^^ nn.Sequential(Layer1(), Layer1(), Layer2(), Layer3()) # ^^^^^^ └───────────────────┘ To use the same name for multiple skip tensors, they must be isolated by different namespaces. See :meth:`isolate() `. Raises: TypeError: one or more pairs of `stash` and `pop` are not matched. rVz ' declared 'z#' both as stashable and as poppablez' redeclared 'z,' as stashable but not isolated by namespacez+' as poppable but not isolated by namespacez$' as poppable but it was not stashedzno module declared 'z' as poppable but stashedz4one or more pairs of stash and pop do not match: %s c3&K|] }d|z yw)z* %sNr^)r`xs r1rbz$verify_skippables..sSmhlcdTZ]^T^hlsN) rCnamed_childrenrIr r$r%appendr=addr@rMrj) r-stashedpoppedmsgs layer_namelayerr6msgr9_s r1rr_sD+.%G),FD#224 E%+ ))E,@,@@Dj\dV3VWC KK A)HBu+++DzW$*^D69ef C  KKT #*(HBu,,,DzV#*^D69de C Dz(*\$7[\ C  JJDz ")'5Fv% D$TF*CD C&  G$))SmhlSmJm m   r2)r^r^)+rvtypingrrrrrrr r r r r rrrrrrtorchrr microbatchr namespacertrackerr__all__TensorsryStashPopStashPopGeneratorModulerwrr rhrrr Sequentialrr^r2r1rs$5( ) < 6 (  h(8/IJii&7&H IJOiiO C{#{ {@57= C==$,SM= tO$%tI67=@,.P bmmP P r2