wfcommons.wfbench

wfcommons.wfbench.bench

class wfcommons.wfbench.bench.WorkflowBenchmark(recipe: Type[WfChefWorkflowRecipe], num_tasks: int, logger: Logger | None = None)

Bases: object

Generate a workflow benchmark instance based on a workflow recipe (WfChefWorkflowRecipe)

Parameters:

recipe (Type[WfChefWorkflowRecipe]) – A workflow recipe.
num_tasks (int) – Total number of tasks in the benchmark workflow.
logger (Optional[Logger]) – The logger where to log information/warning or errors.

_add_input_files(output_files: Dict[str, Dict[str, str]], data: int | Dict[str, str]) → None

Add input files when input data was offered by the user.

Parameters:

output_files –
data (Union[int, Dict[str, str]]) –

_add_output_files(output_files: int | Dict[str, Dict[str, int]]) → None

Add output files when input data was offered by the user.

Parameters:: output_files –

_calculate_input_files(): Calculate total number of files needed. This mehtod is used if the user provides total datafootprint.

_generate_data_for_root_nodes(save_dir: Path, data: int | Dict[str, str]) → None

Generate workflow’s input data for root nodes based on user’s input.

Parameters:

save_dir (pathlib.Path) –
data (Dict[str, str]) –

_output_files(data: Dict[str, str]) → Dict[str, Dict[str, int]]

Calculate, for each task, total number of output files needed. This method is used when the user is specifying the input file sizes.

Parameters:: data (Dict[str, str]) –
Returns:
Return type:: Dict[str, Dict[str, int]]

Create a workflow benchmark.

Parameters:

save_dir (pathlib.Path) – Folder to generate the workflow benchmark JSON instance and input data files.
percent_cpu (Union[float, Dict[str, float]]) – The percentage of CPU threads.
cpu_work (Union[int, Dict[str, int]]) – CPU work per workflow task.
time (Optional[int]) – Time limit for running each task (in seconds).
data (Optional[Union[int, Dict[str, str]]]) – Dictionary of input size files per workflow task type or total workflow data footprint (in MB).
mem (Optional[float]) – Maximum amount of memory consumption per task (in MB).
lock_files_folder (Optional[pathlib.Path]) –
regenerate (Optional[bool]) – Whether to regenerate the workflow tasks

Returns:

The path to the workflow benchmark JSON instance.

Return type:

pathlib.Path

create_benchmark_from_input_file(save_dir: Path, input_file: Path, lock_files_folder: Path | None = None) → Path

Create a workflow benchmark.

Parameters:

save_dir (pathlib.Path) – Folder to generate the workflow benchmark JSON instance and input data files.
input_file (pathlib.Path) –
lock_files_folder (Optional[pathlib.Path]) –

Returns:

The path to the workflow benchmark JSON instance.

Return type:

pathlib.Path

generate_input_file(path: Path) → None

Generates input file where customization of cpu percentage, cpu work, gpu work, data size

Parameters:: path (pathlib.Path) –

run(json_path: Path, save_dir: Path) → None

Run the benchmark workflow locally (for test purposes only).

Parameters:: json_path (pathlib.Path) –
Param:: save_dir:

wfcommons.wfbench.bench.assigning_correct_files(task: Dict[str, str]) → List[str]

wfcommons.wfbench.bench.cleanup_sys_files() → None: Remove files already used

wfcommons.wfbench.bench.generate_sys_data(num_files: int, file_total_size: int, task_name: List[str], save_dir: Path) → None

Generate workflow’s input data

Parameters:

num_files (int) –
file_total_size (int) –
save_dir (pathlib.Path) – Folder to generate the workflow benchmark’s input data files.

wfcommons.wfbench.translator.pegasus

class wfcommons.wfbench.translator.pegasus.PegasusTranslator(workflow: Workflow | Path, logger: Logger | None = None)

Bases: Translator

A WfFormat parser for creating Pegasus workflow applications.

Parameters:

workflow (Union[Workflow, pathlib.Path],) – Workflow benchmark object or path to the workflow benchmark JSON instance.
logger (Logger) – The logger where to log information/warning or errors (optional).

_abc_impl = <_abc._abc_data object>

_add_task(task_name: str, parent_task: str | None = None, tasks_priorities: Dict[str, int] | None = None) → None

Add a task and its dependencies to the workflow.

Parameters:

task_name (str) – name of the task
parent_task (Optional[str]) – name of the parent task
tasks_priorities (Optional[Dict[str, int]]) – Priorities to be assigned to tasks.

translate(output_file_name: Path, tasks_priorities: Dict[str, int] | None = None) → None

Translate a workflow benchmark description (WfFormat) into a Pegasus workflow application.

Parameters:

output_file_name (pathlib.Path) – The name of the output file (e.g., workflow.py).
tasks_priorities (Optional[Dict[str, int]]) – Priorities to be assigned to tasks.

wfcommons.wfbench.translator.swift_t

class wfcommons.wfbench.translator.swift_t.SwiftTTranslator(workflow: Workflow | Path, work_dir: Path, stress_path: Path = PosixPath('stress-ng'), logger: Logger | None = None)

Bases: Translator

A WfFormat parser for creating Swift/T workflow applications.

Parameters:

workflow (Union[Workflow, pathlib.Path]) – Workflow benchmark object or path to the workflow benchmark JSON instance.
work_dir (pathlib.Path) – Path to the workflow working directory.
stress_path (pathlib.Path) – Path to the stress-ng command.
logger (Logger) – The logger where to log information/warning or errors (optional).

_abc_impl = <_abc._abc_data object>

_add_tasks(category: str) → None

Add all tasks for a specific category.

Parameters:: category (str) – category name

_find_categories_list(task_name: str, parent_task: str | None = None) → None

” Find list of task categories ordered by task dependencies.

Parameters:

task_name (str) – name of the task
parent_task (Optional[str]) – name of the parent task

translate(output_file_path: Path) → None

Translate a workflow benchmark description (WfFormat) into a Swift/T workflow application.

Parameters:: output_file_path (pathlib.Path) – The path of the output file (e.g., workflow.swift).