configurable default params.yaml (or templating entire pipelines)

[tibor-mach]

Hi, I have a setup where I use a single pipeline (with several stages) for training multiple models which are almost the same, but use different training data and parameters.

I currently have a copy of a dvc.yaml pipeline in a folder with the respetice params.yaml file used for each model. It looks more or less like this

stages:
 train_test_split:
    wdir: ../../../..
    cmd: >-
      python modules/regression/train_test_split.py
      --params=${paths.params_file}
    deps: ...
    outs: ...
    params:
      - ${paths.params_file}: # needs to be set due to a different working directory
          - paths.data_all
          - train_test_split
  assemble_model: ...
  optimize_hyperparams: ...
  fit_model: ...
  evaluate: ...

This works (I then always run dvc repro -P) but I have to copy the pipeline file which makes versioning difficult. The only part that is not (since it cannot be AFAIK) templated is the default params file.

I would love to have a dvc.yaml file in the root folder of my project which can be run with several different params.yaml files from several locations. Kind of like foreach ... do but on the level of the entire pipeline.

Also, I believe I have to explicitly add the path to the params file under the params keyword when I am running the stage from a different working directory...Not sure if that is a bug or a feature :-)

Thanks a lot!

P.S.: I tried a similar setup with templating all the stages but there are limitations in the way templating and foreach do work right now and also I feel like this would be a more elegant way to do this. The pipelines and the overall architecture are the same, what is different are the training data and (some) parameters, so having an option like "for each params file in list reproduce a separate instance of the pipeline" would make a lot of sense to me (it would them make sense to have separate lock files as well)

[pmrowla]

Also, I believe I have to explicitly add the path to the params file under the params keyword when I am running the stage from a different working directory...Not sure if that is a bug or a feature :-)

The params path will be interpreted as relative to wdir the same way as deps and outs. So if you don't specify params path it would look for params.yaml in wdir.

[tibor-mach]

Also, I believe I have to explicitly add the path to the params file under the params keyword when I am running the stage from a different working directory...Not sure if that is a bug or a feature :-)

The params path will be interpreted as relative to wdir the same way as deps and outs. So if you don't specify params path it would look for params.yaml in wdir.

yeah, that makes sense. thanks.

Is it then possible to specify the params path on the entire pipeline level? I could them simply write a simple loop in a shell script to go through all the different params files and call dvc repro "on" each one of them. It would still be nicer to do that explicitly in the dvc.yaml but this would also work.

[pmrowla]

Is it then possible to specify the params path on the entire pipeline level? I could them simply write a simple loop in a shell script to go through all the different params files and call dvc repro "on" each one of them. It would still be nicer to do that explicitly in the dvc.yaml but this would also work.

No, not at the moment. Doing this via templating the way you have it set up now is probably still the best way to accomplish it.

[tibor-mach]

Is that something I could help with perhaps (in case this is a feature you'd like to include)? I am not very familiar with the inner workings of dvc at this level of detail but this (a configurable default params file) does not sound particularly complicated and it would definitely help me a lot so I'd love to help implementing that.

[tibor-mach]

Actually, I still don't quite get how the params path works. The thing is that I am referencing the path to the params file in the dvc.yaml like this

train_test_split:
  wdir: ../../../..
  cmd: >-
    python modules/estimation/train_test_split.py
    --params=${paths.params_file}
  deps: ...
  outs: ...
  params:
    - ${paths.params_file}: # needs to be set due to a different working directory
        - paths.data_all
        - train_test_split

I understand that first, dvc looks for the params.yaml file in the working directory. But how does it actually find it otherwise? I set the path via templating in params like this

    params:
      - ${paths.params_file}: # needs to be set due to a different working directory

but the paths keyword is already a part of the params.yaml file, the reference is kind of circular...So dvc somehow has to know where to look for the param.yaml, otherwise it could not use the templating reference. But if it does, why is it necessary to explicitly mention the path? I mean it works, but it seems a bit strange to me.

[daavoo]

@tibor-mach This answer might help you understand the differences between params and templating resolving: #7316 (comment)

[daavoo]

Is that something I could help with perhaps (in case this is a feature you'd like to include)? I am not very familiar with the inner workings of dvc at this level of detail but this (a configurable default params file) does not sound particularly complicated and it would definitely help me a lot so I'd love to help implementing that.

I think configuring a default params file could be a good simple feature to add.

The default path is defined here:

dvc/dvc/dependency/param.py

Line 38 in af649af

DEFAULT_PARAMS_FILE = "params.yaml"

And (I hope) that it is the single source of truth.

If you would like to make it configurable, you would need to first add a new config option (https://github.com/iterative/dvc/blob/af649af46276b662b4fa03fd6ab63c36521f28aa/dvc/config.py.

The way I would do it is by updating the DEFAULT_PARAMS_FILE behavior, probably converting it to a @property that checks if the config option is set, otherwise return params.yaml

[tibor-mach]

@tibor-mach This answer might help you understand the differences between params and templating resolving: #7316 (comment)

I see, that setup is a bit contraintuitive to me, but I gues I understand the behaviour better now :-)

Is that something I could help with perhaps (in case this is a feature you'd like to include)? I am not very familiar with the inner workings of dvc at this level of detail but this (a configurable default params file) does not sound particularly complicated and it would definitely help me a lot so I'd love to help implementing that.

I think configuring a default params file could be a good simple feature to add.

The default path is defined here:

dvc/dvc/dependency/param.py

Line 38 in af649af

DEFAULT_PARAMS_FILE = "params.yaml"

And (I hope) that it is the single source of truth.

If you would like to make it configurable, you would need to first add a new config option (https://github.com/iterative/dvc/blob/af649af46276b662b4fa03fd6ab63c36521f28aa/dvc/config.py.

The way I would do it is by updating the DEFAULT_PARAMS_FILE behavior, probably converting it to a @property that checks if the config option is set, otherwise return params.yaml

Cool, seems simple enough. I'll have a look at it, thanks!

[tibor-mach]

@daavoo Just one more thing...

How is this going to work with dvc.lock? Am I going to get a single huge dvc.lock file (say for 10 pipeline runs, each with different params.yaml) or will I get one dvc.lock for each pipeline (that would be desired, at least by me).