Coverage for python/lsst/ctrl/mpexec/dotTools.py : 9%

# This file is part of ctrl_mpexec. 

# 

# Developed for the LSST Data Management System. 

# This product includes software developed by the LSST Project 

# (http://www.lsst.org). 

# See the COPYRIGHT file at the top-level directory of this distribution 

# for details of code ownership. 

# 

# This program is free software: you can redistribute it and/or modify 

# it under the terms of the GNU General Public License as published by 

# the Free Software Foundation, either version 3 of the License, or 

# (at your option) any later version. 

# 

# This program is distributed in the hope that it will be useful, 

# but WITHOUT ANY WARRANTY; without even the implied warranty of 

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 

# GNU General Public License for more details. 

# 

# You should have received a copy of the GNU General Public License 

# along with this program. If not, see <http://www.gnu.org/licenses/>. 

"""Module defining few methods to generate GraphViz diagrams from pipelines 

or quantum graphs. 

""" 

__all__ = ["graph2dot", "pipeline2dot"] 

# ------------------------------- 

# Imports of standard modules -- 

# ------------------------------- 

# ----------------------------- 

# Imports for other modules -- 

# ----------------------------- 

from lsst.daf.butler import DimensionUniverse 

from lsst.pipe.base import iterConnections 

# ---------------------------------- 

# Local non-exported definitions -- 

# ---------------------------------- 

def _loadTaskClass(taskDef, taskFactory): 

"""Import task class if necessary. 

Parameters 

---------- 

taskDef : `TaskDef` 

taskFactory : `TaskFactory` 

Raises 

------ 

`ImportError` is raised when task class cannot be imported. 

`MissingTaskFactoryError` is raised when TaskFactory is needed but not provided. 

""" 

taskClass = taskDef.taskClass 

if not taskClass: 

if not taskFactory: 

raise MissingTaskFactoryError("Task class is not defined but task " 

"factory instance is not provided") 

taskClass = taskFactory.loadTaskClass(taskDef.taskName) 

return taskClass 

def _renderTaskNode(nodeName, taskDef, file, idx=None): 

"""Render GV node for a task""" 

label = [taskDef.taskName.rpartition('.')[-1]] 

if idx is not None: 

label += ["index: {}".format(idx)] 

if taskDef.label: 

label += ["label: {}".format(taskDef.label)] 

label = r'\n'.join(label) 

attrib = dict(shape="box", 

style="filled,bold", 

fillcolor="gray70", 

label=label) 

attrib = ['{}="{}"'.format(key, val) for key, val in attrib.items()] 

print("{} [{}];".format(nodeName, ", ".join(attrib)), file=file) 

def _renderDSTypeNode(dsType, file): 

"""Render GV node for a dataset type""" 

label = [dsType.name] 

if dsType.dimensions: 

label += ["Dimensions: " + ", ".join(dsType.dimensions.names)] 

label = r'\n'.join(label) 

attrib = dict(shape="box", 

style="rounded,filled", 

fillcolor="gray90", 

label=label) 

attrib = ['{}="{}"'.format(key, val) for key, val in attrib.items()] 

print("{} [{}];".format(dsType.name, ", ".join(attrib)), file=file) 

def _renderDSNode(nodeName, dsRef, file): 

"""Render GV node for a dataset""" 

label = [dsRef.datasetType.name] 

for key in sorted(dsRef.dataId.keys()): 

label += [key + "=" + str(dsRef.dataId[key])] 

label = r'\n'.join(label) 

attrib = dict(shape="box", 

style="rounded,filled", 

fillcolor="gray90", 

label=label) 

attrib = ['{}="{}"'.format(key, val) for key, val in attrib.items()] 

print("{} [{}];".format(nodeName, ", ".join(attrib)), file=file) 

def _datasetRefId(dsRef): 

"""Make an idetifying string for given ref""" 

idStr = dsRef.datasetType.name 

for key in sorted(dsRef.dataId.keys()): 

idStr += ":" + key + "=" + str(dsRef.dataId[key]) 

return idStr 

def _makeDSNode(dsRef, allDatasetRefs, file): 

"""Make new node for dataset if it does not exist. 

Returns node name. 

""" 

dsRefId = _datasetRefId(dsRef) 

nodeName = allDatasetRefs.get(dsRefId) 

if nodeName is None: 

idx = len(allDatasetRefs) 

nodeName = "dsref_{}".format(idx) 

allDatasetRefs[dsRefId] = nodeName 

_renderDSNode(nodeName, dsRef, file) 

return nodeName 

# ------------------------ 

# Exported definitions -- 

# ------------------------ 

class MissingTaskFactoryError(Exception): 

"""Exception raised when client fails to provide TaskFactory instance. 

""" 

pass 

def graph2dot(qgraph, file): 

"""Convert QuantumGraph into GraphViz digraph. 

This method is mostly for documentation/presentation purposes. 

Parameters 

---------- 

qgraph: `pipe.base.QuantumGraph` 

QuantumGraph instance. 

file : str or file object 

File where GraphViz graph (DOT language) is written, can be a file name 

or file object. 

Raises 

------ 

`OSError` is raised when output file cannot be open. 

`ImportError` is raised when task class cannot be imported. 

""" 

# open a file if needed 

close = False 

if not hasattr(file, "write"): 

file = open(file, "w") 

close = True 

print("digraph QuantumGraph {", file=file) 

allDatasetRefs = {} 

for taskId, nodes in enumerate(qgraph): 

taskDef = nodes.taskDef 

for qId, quantum in enumerate(nodes.quanta): 

# node for a task 

taskNodeName = "task_{}_{}".format(taskId, qId) 

_renderTaskNode(taskNodeName, taskDef, file) 

# quantum inputs 

for dsRefs in quantum.predictedInputs.values(): 

for dsRef in dsRefs: 

nodeName = _makeDSNode(dsRef, allDatasetRefs, file) 

print("{} -> {};".format(nodeName, taskNodeName), file=file) 

# quantum outputs 

for dsRefs in quantum.outputs.values(): 

for dsRef in dsRefs: 

nodeName = _makeDSNode(dsRef, allDatasetRefs, file) 

print("{} -> {};".format(taskNodeName, nodeName), file=file) 

print("}", file=file) 

if close: 

file.close() 

def pipeline2dot(pipeline, file, taskFactory=None): 

"""Convert Pipeline into GraphViz digraph. 

This method is mostly for documentation/presentation purposes. 

Unlike other methods this method does not validate graph consistency. 

Parameters 

---------- 

pipeline : `pipe.base.Pipeline` 

Pipeline description. 

file : str or file object 

File where GraphViz graph (DOT language) is written, can be a file name 

or file object. 

taskFactory: `pipe.base.TaskFactory`, optional 

Instance of an object which knows how to import task classes. It is only 

used if pipeline task definitions do not define task classes. 

Raises 

------ 

`OSError` is raised when output file cannot be open. 

`ImportError` is raised when task class cannot be imported. 

`MissingTaskFactoryError` is raised when TaskFactory is needed but not 

provided. 

""" 

universe = DimensionUniverse.fromConfig() 

# open a file if needed 

close = False 

if not hasattr(file, "write"): 

file = open(file, "w") 

close = True 

print("digraph Pipeline {", file=file) 

allDatasets = set() 

for idx, taskDef in enumerate(pipeline): 

# node for a task 

taskNodeName = "task{}".format(idx) 

_renderTaskNode(taskNodeName, taskDef, file, idx) 

for attr in iterConnections(taskDef.connections, 'inputs'): 

dsType = attr.makeDatasetType(universe) 

if dsType.name not in allDatasets: 

_renderDSTypeNode(dsType, file) 

allDatasets.add(dsType.name) 

print("{} -> {};".format(dsType.name, taskNodeName), file=file) 

for name in taskDef.connections.outputs: 

attr = getattr(taskDef.connections, name) 

dsType = attr.makeDatasetType(universe) 

if dsType.name not in allDatasets: 

_renderDSTypeNode(dsType, file) 

allDatasets.add(dsType.name) 

print("{} -> {};".format(taskNodeName, dsType.name), file=file) 

print("}", file=file) 

if close: 

file.close()