3j%NSSKJr SSKJr SSKrSSKrSSKJr SSK J r SSK J r J r SSKJr SS KJrJr SS KJrJr SS KJrJrJrJr SS KJr S SKJr SSKJ r \"5(a SSK!J"s J#r$ Sr%OSr%\RL"\'5r(Sr)\"SS\55r*"SS\5r+g)) dataclass)AnyN)Image)tqdm) CLIPTextModel CLIPTokenizer)PipelineImageInput) AutoencoderKLUNet2DConditionModel) DDIMScheduler LCMScheduler) BaseOutputis_torch_xla_availableloggingreplace_example_docstring) randn_tensor)DiffusionPipeline)MarigoldImageProcessorTFa Examples: ```py >>> import diffusers >>> import torch >>> pipe = diffusers.MarigoldNormalsPipeline.from_pretrained( ... "prs-eth/marigold-normals-v1-1", variant="fp16", torch_dtype=torch.float16 ... ).to("cuda") >>> image = diffusers.utils.load_image("https://marigoldmonodepth.github.io/images/einstein.jpg") >>> normals = pipe(image) >>> vis = pipe.image_processor.visualize_normals(normals.prediction) >>> vis[0].save("einstein_normals.png") ``` c\rSrSr%Sr\R \R-\ S'S\R -\R-\ S'S\R-\ S'Sr g)MarigoldNormalsOutputMu7 Output class for Marigold monocular normals prediction pipeline. Args: prediction (`np.ndarray`, `torch.Tensor`): Predicted normals with values in the range [-1, 1]. The shape is `numimages × 3 × height × width` for `torch.Tensor` or `numimages × height × width × 3` for `np.ndarray`. uncertainty (`None`, `np.ndarray`, `torch.Tensor`): Uncertainty maps computed from the ensemble, with values in the range [0, 1]. The shape is `numimages × 1 × height × width` for `torch.Tensor` or `numimages × height × width × 1` for `np.ndarray`. latent (`None`, `torch.Tensor`): Latent features corresponding to the predictions, compatible with the `latents` argument of the pipeline. The shape is `numimages * numensemble × 4 × latentheight × latentwidth`. predictionN uncertaintylatent) __name__ __module__ __qualname____firstlineno____doc__npndarraytorchTensor__annotations____static_attributes__rp/home/wildlama/miniconda3/lib/python3.13/site-packages/diffusers/pipelines/marigold/pipeline_marigold_normals.pyrrMsC  U\\)) "U\\11 5<< r*rc!0^\rSrSrSrSrSrS,S\S\S\ \ -S \ S \ S \ S-S \S-S \S-S\S-4U4SjjjrS\S\S\S\S\ S\ S\S\\ \4S-S\R*S-S\R,\\R,-S-S\ S\S\4Sjr\R2R4S-Sj5r\R8"5\"\5S.S\S\S-S\S\S-S\S\ S\ S\S\\ \4S-S\R*\\R*-S-S\R,\\R,-S-S\ S\S \S!\4S"jj55rS\R*S\R*S-S\R,S-S\S\S\ \R*\R*44 S#jr!S$\R*S\R*4S%jr"\#S/S&\R*S'\$S\R*4S(jj5r%\#S0S&\R*S\S)\ S\ \R*\R*S-44S*jj5r&S+r'U=r($)1MarigoldNormalsPipelineca Pipeline for monocular normals estimation using the Marigold method: https://marigoldmonodepth.github.io. This model inherits from [`DiffusionPipeline`]. Check the superclass documentation for the generic methods the library implements for all the pipelines (such as downloading or saving, running on a particular device, etc.) Args: unet (`UNet2DConditionModel`): Conditional U-Net to denoise the normals latent, conditioned on image latent. vae (`AutoencoderKL`): Variational Auto-Encoder (VAE) Model to encode and decode images and predictions to and from latent representations. scheduler (`DDIMScheduler` or `LCMScheduler`): A scheduler to be used in combination with `unet` to denoise the encoded image latents. text_encoder (`CLIPTextModel`): Text-encoder, for empty text embedding. tokenizer (`CLIPTokenizer`): CLIP tokenizer. prediction_type (`str`, *optional*): Type of predictions made by the model. use_full_z_range (`bool`, *optional*): Whether the normals predicted by this model utilize the full range of the Z dimension, or only its positive half. default_denoising_steps (`int`, *optional*): The minimum number of denoising diffusion steps that are required to produce a prediction of reasonable quality with the given model. This value must be set in the model config. When the pipeline is called without explicitly setting `num_inference_steps`, the default value is used. This is required to ensure reasonable results with various model flavors compatible with the pipeline, such as those relying on very short denoising schedules (`LCMScheduler`) and those with full diffusion schedules (`DDIMScheduler`). default_processing_resolution (`int`, *optional*): The recommended value of the `processing_resolution` parameter of the pipeline. This value must be set in the model config. When the pipeline is called without explicitly setting `processing_resolution`, the default value is used. This is required to ensure reasonable results with various model flavors trained with varying optimal processing resolution values. ztext_encoder->unet->vae)normalsNunetvae scheduler text_encoder tokenizerprediction_typeuse_full_z_rangedefault_denoising_stepsdefault_processing_resolutionc >[T U]5 X`R;a&[R SUSURS35 UR UUUUUS9 UR UUUU S9 [USS5(a/S[URRR5S- -OS Ul Xpl XlXlSUl[#URS 9Ulg) Nz*Potentially unsupported `prediction_type='z&'`; values supported by the pipeline: .)r0r1r2r3r4)r5r6r7r8r1rr)vae_scale_factor)super__init__supported_prediction_typesloggerwarningregister_modulesregister_to_configgetattrlenr1configblock_out_channelsr<r6r7r8empty_text_embeddingrimage_processor) selfr0r1r2r3r4r5r6r7r8 __class__s r+r> MarigoldNormalsPipeline.__init__s  "A"A A NN<_$-J*$(!5tG\G\]r*imagenum_inference_steps ensemble_sizeprocessing_resolutionresample_method_inputresample_method_output batch_sizeensembling_kwargslatents generator output_typeoutput_uncertaintyreturnc H ^ S[URRR5S- -n XR:wa[ SURSU S35eUc [ S5eUS:a [ S5eUS:a [ S5eUS:Xa[ RS 5 US:XaU (a [ S 5eUc [ S 5eUS :a [ S 5eX@R-S :wa[ SURS35eUS;a [ S5eUS;a [ S5eUS:a [ S5eU S;a [ S5eU bT b [ S5eUb:[U[5(d [ S5eSU;aUSS;a [ S5eS nSunn[U[5(dU/n[U5GHunn[U[R5(d[R"U5(a`UR S;a[ SUSUR"S35eUR"SSunnSnUR S :XaUR"S nOL[U[$R$5(aUR&unnSnO[ S!US"[)U5S35eUcUUnnO"UU4UU4:wa[ S#US$UU4S%UU435eUU- nGM U Gb%[R"U 5(d [ S&5eU R+5S :wa[ S'U R"S35eUS :a=[-UU5nUU-U-nX-U-nUS :XdUS :Xa[ S(US)US*35eUUnnXR-S- UR-nUUR-S- UR-nX-URRR.UU4nU R"U:wa[ S+U R"S,US35eT b[T [5(aD[T 5X-:wa [ S-5e[1U 4S.jT 55(d [ S/5eU$[T [R25(d[ S0[)T 5S35eU$)1Nrrz/`vae_scale_factor` computed at initialization (z) differs from the actual one (z).zW`num_inference_steps` is not specified and could not be resolved from the model config.z'`num_inference_steps` must be positive.z!`ensemble_size` must be positive.zk`ensemble_size` == 2 results are similar to no ensembling (1); consider increasing the value to at least 3.zpComputing uncertainty by setting `output_uncertainty=True` also requires setting `ensemble_size` greater than 1.zY`processing_resolution` is not specified and could not be resolved from the model config.rzx`processing_resolution` must be non-negative: 0 for native resolution, or any positive value for downsampled processing.z.`processing_resolution` must be a multiple of r:)nearestz nearest-exactbilinearbicubicareazy`resample_method_input` takes string values compatible with PIL library: nearest, nearest-exact, bilinear, bicubic, area.zz`resample_method_output` takes string values compatible with PIL library: nearest, nearest-exact, bilinear, bicubic, area.z`batch_size` must be positive.)ptr$z*`output_type` must be one of `pt` or `np`.z2`latents` and `generator` cannot be used together.z)`ensembling_kwargs` must be a dictionary. reductionclosestmeanzG`ensembling_kwargs['reduction']` can be either `'closest'` or `'mean'`.)NN)rr z`image[z(]` has unsupported dimensions or shape: rdzUnsupported `image[z ]` type: z Input `image[z]` has incompatible dimensions z with the previous images z!`latents` must be a torch.Tensor.z/`latents` has unsupported dimensions or shape: z*Extreme aspect ratio of the input image: [z x ]z`latents` has unexpected shape=z expected=z^The number of generators must match the total number of ensemble members for all input images.c3># UH4oRRTSRR:Hv M6 g7f)rN)devicetype).0grVs r+ 7MarigoldNormalsPipeline.check_inputs..2s,Xi88==IaL,?,?,D,DDis=> > l *IJ J  9#8QR R  (/66 !LMM//4Ek4RZm4m !jkk 1%&&GE&FAs#rzz**eooc.B.B889,$wqc1YZ]ZcZcYdde%fgg99RS>S88q=))A,CC--88S #6qc49+Q!OPPyC11QC:% #A3&EsCj\Qkmnpqlrkst # J'',  ??7++ !DEE{{}! #RSZS`S`Raab!cdd$q(q!911X=1X=A:!$'QRSQTTWXYWZZ[%\]]e1***Q.43H3HHAT***Q.43H3HHA(8$((//:Y:Y[\^_`N}}. #B7==/Q[\j[kkl!mnn  )T**y>Z%??$xXiXXX$%bccY  5??;; #?Y?PPQ!RSSr*c[US5(d0UlOA[UR[5(d"[ S[ UR5S35e[S0URD6nUR SU5US'UR SU5US'Ub [U40UD6$Ub [SSU0UD6$[ S5e) N_progress_bar_configz=`self._progress_bar_config` should be of type `dict`, but is r:descleavetotalz/Either `total` or `iterable` has to be defined.r)hasattrrrorprnrigetr)rJiterablerrrprogress_bar_configs r+ progress_bar$MarigoldNormalsPipeline.progress_bar9st344(*D %D55t<<OPTUYUnUnPoOppqr #?T%>%>?&9&=&=fd&KF#':'>'>w'NG$  8$78 8  ;e;':; ;NO Or*match_input_resolution output_latent return_dictc~URnURnUc URnUc URnUR UUUUUUUU U U U U 5 nUR c]SnUR USUR RSSS9nURRU5nURU5SUlURRXUUU5unnnURXXU5unnAUR RUUS9RUS S 5n/nUR[!SUU-U5SS S 9HnUUUU-nUUUU-nUR"SnUSUn UR$R'UUS 9 URUR$R(S SS 9Hwn![*R,"UU/S S9n"UR/U"U!U S S9Sn#UR$R1U#U!UU S9R2n[4(dMb[6R8"5 My UR;U5 M [*R,"USS9nAAAAAA A"A#[*R,"[!SUR"SU5Vs/sHnUR=UUUU-5PM snSS9n$U(dSnURR?U$U5n$Sn%US :aU$R@"UU/U$R"S SQ76n$[!U5Vs/sH#nURB"U$UU 40U =(d 0D6PM% n$n[EU$6un$n%[*R,"U$SS9n$U (a[*R,"U%SS9n%OSn%U(aSURRGU$UUS S9n$URIU$5n$U%b#U (aURRGU%UUS S9n%U S:Xa@URRKU$5n$U%b"U (aURRKU%5n%URM5 U(dU$U%U4$[OU$U%US9$s snfs snf)a Function invoked when calling the pipeline. Args: image (`PIL.Image.Image`, `np.ndarray`, `torch.Tensor`, `list[PIL.Image.Image]`, `list[np.ndarray]`), `list[torch.Tensor]`: An input image or images used as an input for the normals estimation task. For arrays and tensors, the expected value range is between `[0, 1]`. Passing a batch of images is possible by providing a four-dimensional array or a tensor. Additionally, a list of images of two- or three-dimensional arrays or tensors can be passed. In the latter case, all list elements must have the same width and height. num_inference_steps (`int`, *optional*, defaults to `None`): Number of denoising diffusion steps during inference. The default value `None` results in automatic selection. ensemble_size (`int`, defaults to `1`): Number of ensemble predictions. Higher values result in measurable improvements and visual degradation. processing_resolution (`int`, *optional*, defaults to `None`): Effective processing resolution. When set to `0`, matches the larger input image dimension. This produces crisper predictions, but may also lead to the overall loss of global context. The default value `None` resolves to the optimal value from the model config. match_input_resolution (`bool`, *optional*, defaults to `True`): When enabled, the output prediction is resized to match the input dimensions. When disabled, the longer side of the output will equal to `processing_resolution`. resample_method_input (`str`, *optional*, defaults to `"bilinear"`): Resampling method used to resize input images to `processing_resolution`. The accepted values are: `"nearest"`, `"nearest-exact"`, `"bilinear"`, `"bicubic"`, or `"area"`. resample_method_output (`str`, *optional*, defaults to `"bilinear"`): Resampling method used to resize output predictions to match the input resolution. The accepted values are `"nearest"`, `"nearest-exact"`, `"bilinear"`, `"bicubic"`, or `"area"`. batch_size (`int`, *optional*, defaults to `1`): Batch size; only matters when setting `ensemble_size` or passing a tensor of images. ensembling_kwargs (`dict`, *optional*, defaults to `None`) Extra dictionary with arguments for precise ensembling control. The following options are available: - reduction (`str`, *optional*, defaults to `"closest"`): Defines the ensembling function applied in every pixel location, can be either `"closest"` or `"mean"`. latents (`torch.Tensor`, *optional*, defaults to `None`): Latent noise tensors to replace the random initialization. These can be taken from the previous function call's output. generator (`torch.Generator`, or `list[torch.Generator]`, *optional*, defaults to `None`): Random number generator object to ensure reproducibility. output_type (`str`, *optional*, defaults to `"np"`): Preferred format of the output's `prediction` and the optional `uncertainty` fields. The accepted values are: `"np"` (numpy array) or `"pt"` (torch tensor). output_uncertainty (`bool`, *optional*, defaults to `False`): When enabled, the output's `uncertainty` field contains the predictive uncertainty map, provided that the `ensemble_size` argument is set to a value above 2. output_latent (`bool`, *optional*, defaults to `False`): When enabled, the output's `latent` field contains the latent codes corresponding to the predictions within the ensemble. These codes can be saved, modified, and used for subsequent calls with the `latents` argument. return_dict (`bool`, *optional*, defaults to `True`): Whether or not to return a [`~pipelines.marigold.MarigoldNormalsOutput`] instead of a plain tuple. Examples: Returns: [`~pipelines.marigold.MarigoldNormalsOutput`] or `tuple`: If `return_dict` is `True`, [`~pipelines.marigold.MarigoldNormalsOutput`] is returned, otherwise a `tuple` is returned where the first element is the prediction, the second element is the uncertainty (or `None`), and the third is the latent (or `None`). N do_not_padTr_)padding max_length truncationreturn_tensorsr)rhdtyperzMarigold predictions...)rr)rhFzDiffusion steps...rw)encoder_hidden_statesr)rV)is_aar$)rrr)(_execution_devicerr7r8rrHr4model_max_length input_idstor3rI preprocessprepare_latentsrepeatrrangerur2 set_timesteps timestepsr&catr0step prev_sample XLA_AVAILABLExm mark_stepappenddecode_prediction unpad_imagereshapeensemble_normalszipresize_antialiasnormalize_normals pt_to_numpymaybe_free_model_hooksr)&rJrMrNrOrPrrQrRrSrTrUrVrWrXrrrhrr}prompt text_inputstext_input_idsroriginal_resolution image_latent pred_latentbatch_empty_text_embedding pred_latentsrbatch_image_latentbatch_pred_latenteffective_batch_sizetextt batch_latentnoiserrs& r+__call__ MarigoldNormalsPipeline.__call__Lsd''   &"&">">  ($($F$F !&&    ! ! "        "  $ $ ,F..$>>::# )K)2255f=N(,(9(9.(I!(LD %/3.B.B.M.M *?/ +w+%)$8$8 Ij% ! k %)%>%>%A%AW\%A%]%d%d 1& " "" !Z-/ -.C/CDD NN ( ()O)PVWX  ,[` abcd$(NN$7$71/9%8%+"!=LLNi    1 2' *ii !4    &      YYq+"3"3A"6 C CA&&{1q:~'FGC   K))55j'J  1 #++J ] HXHXYZY[H\]Jz**A%%jm5GeL]Lcace* '*:&6 #J :15J!#ii ; "  "-->>/1Gu?J// ;J&+="22CC!46LTYD $ --99*EJ&+="22>>{K  ##% [9 9$!#  w *s !P5*P:c Sn[R"[SURSU5Vs/sH(nU"URR XXu-55PM* snSS9nXRR R-nURUSS9nUn U c*[URUURURS9n X4$s snf)Nc[US5(aURR5$[US5(a UR$[ S5e)N latent_distrUz3Could not access latents of provided encoder_output)rrmoderUAttributeError)encoder_outputs r+retrieve_latentsAMarigoldNormalsPipeline.prepare_latents..retrieve_latents[sI~}55%11668833%---$%Z[[r*rr)rVrhr) r&rrrur1encoderFscaling_factorrepeat_interleaverrhr) rJrMrUrVrOrSrrrrs r+r'MarigoldNormalsPipeline.prepare_latentsSs \yyq%++a.*= =A!1>1J!KL=   $hhoo&D&DD #55m5K   &""##**"(( K((% s/C rcNUR5S:wd1URSURRR:wa:[ SURRRSURS35eURR XRRR- SS9Sn[R"US S 5nUR(d.USS2S SS2SS24==S -ss'USS2S SS2SS24==S - ss'URU5nU$) Nrdrz Expecting 4D tensor of shape [B,z ,H,W]; got r:F)rrgg?rg?) rwrur1rFryrndecoderr&clipr6r)rJrrs r+r)MarigoldNormalsPipeline.decode_predictionxs ??  ![%6%6q%9TXX__=\=\%\2488??3R3R2SS^_j_p_p^qqrs XX__[88??3Q3Q%Q_d_efgh ZZ D#6 $$ q!Qz "c ) " q!Qz "c ) "++J7 r*r/epscUR5S:wdURSS:wa[SURS35e[R"USSS9nXR US9-nU$) Nrdrr ,Expecting 4D tensor of shape [B,3,H,W]; got r:Trwkeepdim)min)rwrurnr&normclamp)r/rrs r+r)MarigoldNormalsPipeline.normalize_normalssd ;;=A q!1Q!6KGMM?Z[\] ]zz'q$7::#:&&r*r`cBUR5S:wdURSS:wa[SURS35eUS;a[SUS35eURSS S 9n[R U5nX0-R SS S 9nURS S5nS nU(a1UR5nURSS S 9[R- nUS :XaX54$URSS S 9nURSSSS5n[R"USU5nXu4$)a Ensembles the normals maps represented by the `normals` tensor with expected shape `(B, 3, H, W)`, where B is the number of ensemble members for a given prediction of size `(H x W)`. Args: normals (`torch.Tensor`): Input ensemble normals maps. output_uncertainty (`bool`, *optional*, defaults to `False`): Whether to output uncertainty map. reduction (`str`, *optional*, defaults to `"closest"`): Reduction method used to ensemble aligned predictions. The accepted values are: `"closest"` and `"mean"`. Returns: A tensor of aligned and ensembled normals maps with shape `(1, 3, H, W)` and optionally a tensor of uncertainties of shape `(1, 1, H, W)`. rdrr rr:razUnrecognized reduction method: rTrNrc)rwrurnrcr-rsumrarccosr$piargmaxrr&gather)r/rXr` mean_normalssim_cosrclosest_indicesclosest_normalss r+r(MarigoldNormalsPipeline.ensemble_normalss** ;;=A q!1Q!6KGMM?Z[\] ] / />ykKL L||4|8 .@@N )..1d.C--A& !..*K%**q$*?"%%GK  , ,!..Q.=)00Aq!<,,w?C++r*)rr7r8rHrIr6r<)NTNN)NNNT)NrNTr\r\rNNNr$FFT)gư>)rb))rr r!r"r#model_cpu_offload_seqr?r r r rrrstrboolintr>r rprr&r'r{rqrcompilerdisablerno_gradrEXAMPLE_DOC_STRINGrtuplerr staticmethodfloatrrr) __classcell__)rKs@r+r-r-cs"H6!-'+(,.248*^"*^*^!</ *^ $ *^ ! *^t*^+*^"%t*^(+Tz*^*^X@!@!@ @ # @ # @!$@@ S>D0@$@??T%//%::TA@@!@ @D ^^PP$ ]]_12+/,0'+%/&037<@DH#(# !B !B !4ZB  B #Tz B !% B  #B !$B B  S>D0B U\\ 22T9B ??T%//%::TAB B !B B !B 3B J#)||#)$#)??T) #)  #)  #) u||U\\) *#)JU\\ell$5<<eu||JS+,+,37+,DG+, u||U\\D00 1+,+,r*r-), dataclassesrtypingrnumpyr$r&PILr tqdm.autor transformersrrrIr modelsr r schedulersr rutilsrrrrutils.torch_utilsrpipeline_utilsrmarigold_image_processingrtorch_xla.core.xla_modelcore xla_modelrr get_loggerrr@rrr-rr*r+rs&" 51 ..=))MM   H %&  J   *] ,/] ,r*