{"_id":"58dd0c5d1f8bff1900b4bdb1","__v":0,"parentDoc":null,"githubsync":"","project":"5773dcfc255e820e00e1cd4d","user":"575e85ac41c8ba0e00259a44","category":{"_id":"577baf92451b1e0e006075ac","__v":0,"project":"5773dcfc255e820e00e1cd4d","version":"5773dcfc255e820e00e1cd50","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-05T13:01:06.540Z","from_sync":false,"order":6,"slug":"developer-hub","title":"Developer tools"},"version":{"_id":"5773dcfc255e820e00e1cd50","__v":26,"project":"5773dcfc255e820e00e1cd4d","createdAt":"2016-06-29T14:36:44.812Z","releaseDate":"2016-06-29T14:36:44.812Z","categories":["5773dcfc255e820e00e1cd51","5773df36904b0c0e00ef05ff","577baf92451b1e0e006075ac","577bb183b7ee4a0e007c4e8d","577ce77a1cf3cb0e0048e5ea","577d11865fd4de0e00cc3dab","578e62792c3c790e00937597","578f4fd98335ca0e006d5c84","578f5e5c3d04570e00976ebb","57bc35f7531e000e0075d118","57f801b3760f3a1700219ebb","5804d55d1642890f00803623","581c8d55c0dc651900aa9350","589dcf8ba8c63b3b00c3704f","594cebadd8a2f7001b0b53b2","59a562f46a5d8c00238e309a","5a2aa096e25025003c582b58","5a2e79566c771d003ca0acd4","5a3a5166142db90026f24007","5a3a52b5bcc254001c4bf152","5a3a574a2be213002675c6d2","5a3a66bb2be213002675cb73","5a3a6e4854faf60030b63159","5c8a68278e883901341de571","5cb9971e57bf020024523c7b","5cbf1683e2a36d01d5012ecd"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-30T13:47:09.430Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":17,"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Hint name\",\n    \"h-1\": \"Workflow level\",\n    \"h-2\": \"Node level\",\n    \"h-3\": \"Tool level\",\n    \"h-4\": \"Default\",\n    \"h-5\": \"Notes\",\n    \"h-6\": \"See also\",\n    \"0-0\": \"`sbg:CPURequirement`<sup>1</sup>\\nAllocates this many CPU cores for the execution of the tool.\",\n    \"1-2\": \":no-entry-sign:\",\n    \"0-3\": \":white-check-mark:\",\n    \"2-4\": \"Decided by the scheduling algorithm\",\n    \"2-5\": \":warning: The task will fail if the resources available on the instance are insufficient for any tool in the workflow.\",\n    \"0-2\": \":no-entry-sign:\",\n    \"0-1\": \":no-entry-sign:\",\n    \"0-4\": \"1\",\n    \"0-5\": \"Accepts dynamic expressions\",\n    \"0-6\": \"[Tool resource requirements](doc:about-tool-resource-requirements)\",\n    \"1-1\": \":no-entry-sign:\",\n    \"1-3\": \":white-check-mark:\",\n    \"2-1\": \":white-check-mark:\",\n    \"2-2\": \":white-check-mark:\",\n    \"2-3\": \":white-check-mark:\",\n    \"3-1\": \":white-check-mark:\",\n    \"4-3\": \":white-check-mark:\",\n    \"3-2\": \":no-entry-sign:\",\n    \"3-3\": \":no-entry-sign:\",\n    \"4-1\": \":no-entry-sign:\",\n    \"4-2\": \":no-entry-sign:\",\n    \"3-5\": \":warning:  If a step is an inner workflow, its `sbg:maxNumberOfParallelInstances` will be overridden with the value from the outer workflow, even if it has not been set explicitly (*i.e.* the default value takes precedence).\",\n    \"1-5\": \"Accepts dynamic expressions\",\n    \"1-4\": \"1024 [MB]\",\n    \"3-4\": \"1\",\n    \"4-4\": \"file name\",\n    \"1-0\": \"`sbg:MemRequirement`<sup>1</sup>\\nAllocates this much MB of RAM for the execution of the tool.\",\n    \"2-0\": \"`sbg:AWSInstanceType`\\nConfigures the type of all the AWS instances provisioned for this workflow/node/tool.\\nPriority: \\n*workflow > node > tool*\",\n    \"3-0\": \"`sbg:maxNumberOfParallelInstances`\\nSets the maximum number of instances that can run in parallel for workflow execution.\",\n    \"4-0\": \"`sbg:SaveLogs`\\nConfigures the additional files to preserve as logs inside the project\",\n    \"1-6\": \"[Tool resource requirements](doc:about-tool-resource-requirements)\",\n    \"2-6\": \"[AWS US East instances](doc:list-of-available-amazon-web-services-instances) \\n\\n[AWS EU instances](doc:list-of-available-amazon-web-services-eu-instances)\"\n  },\n  \"cols\": 7,\n  \"rows\": 5\n}\n[/block]\n<sup>1</sup> The hints prefixed with **sbg:** are specific for the Seven Bridges execution environment. CWL 1.0 introduces **coresMin** / **coresMax** (minimum and maximum number of CPU cores) and **ramMin** / **ramMax** (minimum and maximum amount of RAM) in [resource requirements](http://www.commonwl.org/v1.0/CommandLineTool.html#ResourceRequirement), which can be found on any level (**Workflow**, **Step**, **Tool**). If your CWL 1.0 app description contains only the **-Min** or the **-Max** value, the Seven Bridges execution environment will use the specified value as the number of cores or amount of RAM required for execution. If both the **-Min** and the **-Max** value are specified, the execution will ignore the **-Max** value and provide enough resources to accommodate the **-Min** requirement, in order to provide consistency in execution of apps described using either sbg:draft-2 or 1.0 version of CWL. Finally, if **sbg:CPURequirement** or **sbg:MemRequirement** are evaluated along with the corresponding CWL 1.0 **-Min** requirements (**coresMin** or **ramMin**), the execution will use the higher of these two values as the required number of cores or amount of RAM.\n\nDisk space requirements introduced in CWL 1.0 (**tmpdirMin** / **tmpdirMax** and **outdirMin** / **outdirMax**) are unfortunately not currently supported by Cavatica.","excerpt":"","slug":"list-of-execution-hints","type":"basic","title":"List of execution hints"}

Get started

Cavatica Projects

Find apps

Bring your private data

Set metadata associated with a file

Collaborate securely

Developer tools

Browse public datasets

Run an analysis

Review a task

Cavatica Datasets

SBFS (Beta)

Cavatica API

EDIT AN APP

BULK API ACTIONS

ASYNC BULK ACTIONS

CAVATICA DATASETS API (Advanced Access)

Video tutorials

Data Cruncher

SBFS (Beta)

SBFS Command reference

List of execution hints

[block:parameters] { "data": { "h-0": "Hint name", "h-1": "Workflow level", "h-2": "Node level", "h-3": "Tool level", "h-4": "Default", "h-5": "Notes", "h-6": "See also", "0-0": "`sbg:CPURequirement`<sup>1</sup>\nAllocates this many CPU cores for the execution of the tool.", "1-2": ":no-entry-sign:", "0-3": ":white-check-mark:", "2-4": "Decided by the scheduling algorithm", "2-5": ":warning: The task will fail if the resources available on the instance are insufficient for any tool in the workflow.", "0-2": ":no-entry-sign:", "0-1": ":no-entry-sign:", "0-4": "1", "0-5": "Accepts dynamic expressions", "0-6": "[Tool resource requirements](doc:about-tool-resource-requirements)", "1-1": ":no-entry-sign:", "1-3": ":white-check-mark:", "2-1": ":white-check-mark:", "2-2": ":white-check-mark:", "2-3": ":white-check-mark:", "3-1": ":white-check-mark:", "4-3": ":white-check-mark:", "3-2": ":no-entry-sign:", "3-3": ":no-entry-sign:", "4-1": ":no-entry-sign:", "4-2": ":no-entry-sign:", "3-5": ":warning: If a step is an inner workflow, its `sbg:maxNumberOfParallelInstances` will be overridden with the value from the outer workflow, even if it has not been set explicitly (*i.e.* the default value takes precedence).", "1-5": "Accepts dynamic expressions", "1-4": "1024 [MB]", "3-4": "1", "4-4": "file name", "1-0": "`sbg:MemRequirement`<sup>1</sup>\nAllocates this much MB of RAM for the execution of the tool.", "2-0": "`sbg:AWSInstanceType`\nConfigures the type of all the AWS instances provisioned for this workflow/node/tool.\nPriority: \n*workflow > node > tool*", "3-0": "`sbg:maxNumberOfParallelInstances`\nSets the maximum number of instances that can run in parallel for workflow execution.", "4-0": "`sbg:SaveLogs`\nConfigures the additional files to preserve as logs inside the project", "1-6": "[Tool resource requirements](doc:about-tool-resource-requirements)", "2-6": "[AWS US East instances](doc:list-of-available-amazon-web-services-instances) \n\n[AWS EU instances](doc:list-of-available-amazon-web-services-eu-instances)" }, "cols": 7, "rows": 5 } [/block] <sup>1</sup> The hints prefixed with **sbg:** are specific for the Seven Bridges execution environment. CWL 1.0 introduces **coresMin** / **coresMax** (minimum and maximum number of CPU cores) and **ramMin** / **ramMax** (minimum and maximum amount of RAM) in [resource requirements](http://www.commonwl.org/v1.0/CommandLineTool.html#ResourceRequirement), which can be found on any level (**Workflow**, **Step**, **Tool**). If your CWL 1.0 app description contains only the **-Min** or the **-Max** value, the Seven Bridges execution environment will use the specified value as the number of cores or amount of RAM required for execution. If both the **-Min** and the **-Max** value are specified, the execution will ignore the **-Max** value and provide enough resources to accommodate the **-Min** requirement, in order to provide consistency in execution of apps described using either sbg:draft-2 or 1.0 version of CWL. Finally, if **sbg:CPURequirement** or **sbg:MemRequirement** are evaluated along with the corresponding CWL 1.0 **-Min** requirements (**coresMin** or **ramMin**), the execution will use the higher of these two values as the required number of cores or amount of RAM. Disk space requirements introduced in CWL 1.0 (**tmpdirMin** / **tmpdirMax** and **outdirMin** / **outdirMax**) are unfortunately not currently supported by Cavatica.