+hbSSKJr SSKJrJrJrJrJrJr SSK r SSK r SSK J r SSKJr SSKJrJr SSKJr SS KJrJr SS KJrJr SS KJrJrJrJr SS K J!r! S SK"J#r# SSK$J%r% \"5(a SSK&J's J(r) Sr*OSr*\RV"\,5r-Sr.\"SS\55r/"SS\#5r0g)) dataclass)AnyDictListOptionalTupleUnionN)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\R4\ S'\S\R\R4\ S'\S\R4\ S'Sr g)MarigoldNormalsOutputMa 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 imes 3 imes height imes width$ for `torch.Tensor` or $numimages imes height imes width imes 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 imes 1 imes height imes width$ for `torch.Tensor` or $numimages imes height imes width imes 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 imes 4 imes latentheight imes latentwidth$. predictionN uncertaintylatent) __name__ __module__ __qualname____firstlineno____doc__r npndarraytorchTensor__annotations____static_attributes__r#p/home/james-whalen/.local/lib/python3.13/site-packages/diffusers/pipelines/marigold/pipeline_marigold_normals.pyrrMsO bjj%,,.//tRZZ566 $ $ %%r/rc!@^\rSrSrSrSrSrS+S\S\S\ \ \ 4S\ S \ S \\S \\S \\S \\4U4SjjjrS\S\S\S\S\S\S\S\\\\4S\\R.S\\ \R0\\R04S\S\S\4Sjr\R6R8S,Sj5r\R<"5\"\ 5S-S\S\\S\S\\S\S\S\S\S\\\\4S\\ \R.\\R.4S\\ \R0\\R04S\S\S\S \4S!jj55r!S\R.S\\R.S\\R0S\S\S\"\R.\R.44 S"jr#S#\R.S\R.4S$jr$\%S.S%\R.S&\&S\R.4S'jj5r'\%S/S%\R.S\S(\S\"\R.\\R.44S)jj5r(S*r)U=r*$)0MarigoldNormalsPipelineda 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)normalsunetvae 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: .)r5r6r7r8r9)r:r;r<r=r6rr)vae_scale_factor)super__init__supported_prediction_typesloggerwarningregister_modulesregister_to_configgetattrlenr6configblock_out_channelsrAr;r<r=empty_text_embeddingrimage_processor) selfr5r6r7r8r9r:r;r<r= __class__s r0rC 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)rrz`image[z(]` has unsupported dimensions or shape: rizUnsupported `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).0gr[s r0 7MarigoldNormalsPipeline.check_inputs..3s,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#)hasattrrrtrursrngetr )rOiterablerrrprogress_bar_configs r0 progress_bar$MarigoldNormalsPipeline.progress_bar:st344(*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_padTrd)padding max_length truncationreturn_tensorsr)rmdtyperzMarigold predictions...)rr)rmFzDiffusion steps...r|)encoder_hidden_statesr)r[)is_aar))r r!r")(_execution_devicerr<r=rrMr9model_max_length input_idstor8rN preprocessprepare_latentsrepeatrrangerzr7 set_timesteps timestepsr+catr5step prev_sample XLA_AVAILABLExm mark_stepappenddecode_prediction unpad_imagereshapeensemble_normalszipresize_antialiasnormalize_normals pt_to_numpymaybe_free_model_hooksr)&rOrRrSrTrUrrVrWrXrYrZr[r\r]rrrmrrprompt text_inputstext_input_idsroriginal_resolution image_latent pred_latentbatch_empty_text_embedding pred_latentsrbatch_image_latentbatch_pred_latenteffective_batch_sizetextt batch_latentnoiser r!s& r0__call__ MarigoldNormalsPipeline.__call__Msd''   &"&">">  ($($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_distrZz3Could not access latents of provided encoder_output)rrmoderZAttributeError)encoder_outputs r0retrieve_latentsAMarigoldNormalsPipeline.prepare_latents..retrieve_latents\sI~}55%11668833%---$%Z[[r/rr)r[rmr) r+rrrzr6encoderKscaling_factorrepeat_interleaverrmr) rOrRrZr[rTrXrrrrs r0r'MarigoldNormalsPipeline.prepare_latentsTs \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$) Nrirz Expecting 4D tensor of shape [B,z ,H,W]; got r?F)rrgg?rg?) r|rzr6rKr~rsdecoderr+clipr;r)rOrr s r0r)MarigoldNormalsPipeline.decode_predictionys ??  ![%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/r4epscUR5S:wdURSS:wa[SURS35e[R"USSS9nXR US9-nU$) Nrirr,Expecting 4D tensor of shape [B,3,H,W]; got r?Tr|keepdim)min)r|rzrsr+normclamp)r4rrs r0r)MarigoldNormalsPipeline.normalize_normalssd ;;=A q!1Q!6KGMM?Z[\] ]zz'q$7::#:&&r/recBUR5S: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)`. rirrrr?rfzUnrecognized reduction method: rTrNrh)r|rzrsrhr2rsumrarccosr)piargmaxrr+gather)r4r]re mean_normalssim_cosr!closest_indicesclosest_normalss r0r(MarigoldNormalsPipeline.ensemble_normalss** ;;=A q!1Q!6KGMM?Z[\] ] / />ykKL L||4|8 .@@N )..1d.C--A& !..*K%**q$*?"%%GK  , ,!..Q.=)00Aq!<,,w?C++r/)rr<r=rMrNr;rA)NTNN)NNNT)NrNTrararNNNr)FFT)gư>)rg)+r$r%r&r'r(model_cpu_offload_seqrDrrr rrr r rstrboolintrCrrrr+r,rrrcompilerdisablerno_gradrEXAMPLE_DOC_STRINGrrrr staticmethodfloatrrr. __classcell__)rPs@r0r2r2ds"H6!-*.+/157;*^"*^*^ 45 *^ $ *^ ! *^"#*^#4.*^"*#*^(0}*^*^X@!@!@ @ # @ # @!$@@$DcN3@%,,'@E%//43H"HIJ@@!@ @D ^^PP$ ]]_12.2/3'+%/&06:EIMQ#(# !B !B &c]B  B (} B !% B  #B !$B B $DcN3B % d5<<.@ @ABB E%//43H"HIJB B !B B !B 3B J#)||#)%,,'#)EOO, #)  #)  #) u||U\\) *#)JU\\ell$5<<eu||JS+,+,37+,DG+, u||Xell33 4+,+,r/r2)1 dataclassesrtypingrrrrrr numpyr)r+PILr tqdm.autor transformersr r rNrmodelsrr schedulersrrutilsrrrrutils.torch_utilsrpipeline_utilsrmarigold_image_processingrtorch_xla.core.xla_modelcore xla_modelrr get_loggerr$rErrr2r#r/r0rs&":: 51 ..=))MM   H %& &J& &,] ,/] ,r/