Skip to content

Latest commit

 

History

History
39 lines (36 loc) · 1.98 KB

README.md

File metadata and controls

39 lines (36 loc) · 1.98 KB
Raw

ahp_graph - Python Attributed Hierarchical Port Graph

AHP Graphs - https://arxiv.org/pdf/1802.06492.pdf

Requires Python3.9 at a minimum. There is a "noTyping" branch which works with older versions of Python (like 3.6)

Ubuntu apt packages:

apt install graphviz libgraphviz-dev

RHEL/CentOS yum packages:

yum install graphviz graphviz-devel

Python3 packages:

python3 -m pip install pygraphviz orjson

Useful Tips

  • Assembly names are automatically prefixed to the expanded devices names when the graph is flattened
  • Besides graph construction, the main features that ahp_graph provides are several outputs
    • SSTGraph.build() will immediately turn your graph into SST components and begin a simulation
    • SSTGraph.write_json() will output the graph along with parameters in JSON format
    • DeviceGraph.write_dot() will output the graph in DOT format and optionally draw SVGs with them
  • All output generated by ahp_graph goes into a folder called 'output'
    • This is for the SSTGraph.write_json() and DeviceGraph.write_dot() functions
  • SST global parameters are set by adding things to the DeviceGraph attr field
  • SST component parameters are set by adding things to the Device attr field
  • You can still do normal SST Python things (examples below):
    • sst.setProgramOption()
    • sst.setStatisticLoadLevel()
    • sst.setStatisticOutput()
  • SSTGraph.build() returns a dictionary of devices with their name as the key
    • You can use this to enable statistics for devices after they are created
  • If you plan to build the graph with ahp_graph partitioning and run with MPI, remember to include the --parallel-load=SINGLE flag to sst
    • --parallel-load by default will work with multiple unique files
    • ahp_graph can generate the graph for each rank using a single file, so it needs the value 'SINGLE'
  • By default sst grabs all command line parameters
    • You can pass parameters to the python script by putting -- before your script parameters