model_descriptor_union: Union of ModelDescriptors

In mlr3torch: Deep Learning with 'mlr3'

Union of ModelDescriptors

Description

This is a mostly internal function that is used in PipeOpTorchs with multiple input channels.

It creates the union of multiple ModelDescriptors:

• graphs are combinded (if they are not identical to begin with). The first entry's graph is modified by reference.

• PipeOps with the same ID must be identical. No new input edges may be added to PipeOps.

• Drops pointer / pointer_shape entries.

• The new task is the feature union of the two incoming tasks.

• The optimizer and loss of both ModelDescriptors must be identical.

• Ingress tokens and callbacks are merged, where objects with the same "id" must be identical.

Usage

model_descriptor_union(md1, md2)

Arguments

md1	(ModelDescriptor) The first ModelDescriptor.
md2	(ModelDescriptor) The second ModelDescriptor.

Details

The requirement that no new input edgedes may be added to PipeOps is not theoretically necessary, but since we assume that ModelDescriptor is being built from beginning to end (i.e. PipeOps never get new ancestors) we can make this assumption and simplify things. Otherwise we'd need to treat "..."-inputs special.)

Value

ModelDescriptor

See Also

Other Graph Network: ModelDescriptor(), TorchIngressToken(), mlr_learners_torch_model, mlr_pipeops_module, mlr_pipeops_torch, mlr_pipeops_torch_ingress, mlr_pipeops_torch_ingress_categ, mlr_pipeops_torch_ingress_ltnsr, mlr_pipeops_torch_ingress_num, model_descriptor_to_learner(), model_descriptor_to_module(), nn_graph()

Other Model Configuration: ModelDescriptor(), mlr_pipeops_torch_callbacks, mlr_pipeops_torch_loss, mlr_pipeops_torch_optimizer

mlr3torch documentation built on Aug. 26, 2025, 5:09 p.m.