[Feature Request]: need a documentation for fireworks.core.launchpad.LaunchPad.update_spec()

[jinlhr542]

Problem

Dear developers,

I am new in FIREWORKS and I recently need to code a project using queue adapters to submit jobs through different computing resources (with different number of cores, tasks etc.). I am trying to use fireworks.core.launchpad.LaunchPad.update_spec() to achieve flexibility in queue submission. However, I have reviewed the document but have not found a detailed tutorial or reference for how to setting queue adapter parameters. It would be greatly appreciated if a parameter reference can be provided here. For instance I tried to use lpad.update_spec(fw_ids, {'$set' : 'ntasks_per_node' : 26}) to specify the number of tasks per node, but it turns out that this modification did not work and the queue adapter still used the default settings by the config file my_qadapter.yaml.

Proposed Solution

Provide a detailed documentation or parameter reference on how to modify queue adapter parameters using lpad.update_spec()

Alternatives

No response

[ikondov]

The documentation of Launchpad.update_spec() can be found in the docs here. The quadapter parameters are documented here. The actually depend on the queuing system and the relevant template but this all is described there. Further docs can be found in the API reference.

But reading what you actually want to do I would recommend to read this tutorial.

If you need to modify already existing _queueadapter key in the spec dictionary or create the key, then indeed you have to use update_spec but then the command should be lpad.update_spec(fw_ids, {'_queueadapter.ntasks_per_node': 26}) (I haven't tested but written from experience).

Generally, for a quicker response, it is recommended to ask questions in the forum.