siliconcompiler 0.32.3__py3-none-any.whl → 0.33.1__py3-none-any.whl

siliconcompiler/scheduler/run_node.py

@@ -93,7 +93,8 @@ def main():
         chip.set('record', 'remoteid', args.remoteid)
 
     if args.unset_scheduler:
-        for vals, step, index in chip.schema._getvals('option', 'scheduler', 'name'):
+        for vals, step, index in chip.schema.get('option', 'scheduler', 'name',
+                                                 field=None).getvalues():
             chip.unset('option', 'scheduler', 'name', step=step, index=index)
 
     # Init logger to ensure consistent view

siliconcompiler/scheduler/send_messages.py

@@ -6,12 +6,12 @@ from email.mime.application import MIMEApplication
 import json
 import os
 from siliconcompiler import sc_open
-from siliconcompiler.schema import Schema
+from siliconcompiler import Schema
 from siliconcompiler.report import utils as report_utils
 import fastjsonschema
 from pathlib import Path
-from siliconcompiler.flowgraph import get_executed_nodes
 import uuid
+from siliconcompiler.flowgraph import RuntimeFlowgraph
 
 
 # Compile validation code for API request bodies.
@@ -25,7 +25,7 @@ with open(api_dir / 'email_credentials.json') as schema:
 def __load_config(chip):
     path = default_email_credentials_file()
     if not os.path.exists(path):
-        chip.logger.warn(f'Email credentials are not available: {path}')
+        chip.logger.warning(f'Email credentials are not available: {path}')
         return {}
 
     with open(path) as f:
@@ -91,9 +91,15 @@ def send(chip, msg_type, step, index):
                                           filename=os.path.basename(layout_img))
                     msg.attach(img_attach)
 
-            nodes_to_execute = get_executed_nodes(chip, flow)
+            runtime = RuntimeFlowgraph(
+                chip.schema.get("flowgraph", flow, field='schema'),
+                from_steps=chip.get('option', 'from'),
+                to_steps=chip.get('option', 'to'),
+                prune_nodes=chip.get('option', 'prune'))
+
             nodes, errors, metrics, metrics_unit, metrics_to_show, _ = \
-                report_utils._collect_data(chip, flow=flow, flowgraph_nodes=nodes_to_execute)
+                report_utils._collect_data(chip, flow=flow,
+                                           flowgraph_nodes=runtime.get_nodes())
 
             text_msg = get_file_template('email/summary.j2').render(
                 design=chip.design,

siliconcompiler/scheduler/slurm.py

@@ -2,13 +2,12 @@ import os
 import shlex
 import subprocess
 import stat
-import time
 import uuid
 import json
 import shutil
 from siliconcompiler import utils, SiliconCompilerError
-from siliconcompiler.flowgraph import nodes_to_execute, _get_flowgraph_entry_nodes
 from siliconcompiler.package import get_cache_path
+from siliconcompiler.flowgraph import RuntimeFlowgraph
 
 # Full list of Slurm states, split into 'active' and 'inactive' categories.
 # Many of these do not apply to a minimal configuration, but we'll track them all.
@@ -59,8 +58,15 @@ def init(chip):
 
     collect = False
     flow = chip.get('option', 'flow')
-    entry_nodes = _get_flowgraph_entry_nodes(chip, flow)
-    for (step, index) in nodes_to_execute(chip, flow):
+    entry_nodes = chip.schema.get("flowgraph", flow, field="schema").get_entry_nodes()
+
+    runtime = RuntimeFlowgraph(
+        chip.schema.get("flowgraph", flow, field='schema'),
+        from_steps=chip.get('option', 'from'),
+        to_steps=chip.get('option', 'to'),
+        prune_nodes=chip.get('option', 'prune'))
+
+    for (step, index) in runtime.get_nodes():
         if (step, index) in entry_nodes:
             collect = True
 
@@ -125,7 +131,7 @@ def _defernode(chip, step, index, replay):
     os.chmod(script_file,
              os.stat(script_file).st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
 
-    schedule_cmd = ['sbatch',
+    schedule_cmd = ['srun',
                     '--exclusive',
                     '--partition', partition,
                     '--chdir', chip.cwd,
@@ -149,45 +155,6 @@ def _defernode(chip, step, index, replay):
     # as it has closed its output stream. But if we don't call '.wait()',
     # the '.returncode' value will not be set correctly.
     step_result.wait()
-    result_msg = step_result.stdout.read().decode()
-    sbatch_id = result_msg.split(' ')[-1].strip()
-    retcode = 0
-
-    while True:
-        # Return early with an error if the batch ID is not an integer.
-        if not sbatch_id.isdigit():
-            retcode = 1
-            break
-
-        # Rate-limit the status checks to once every few seconds.
-        time.sleep(3.0)
-
-        # Check whether the job is still running.
-        jobcheck = subprocess.run(['scontrol', 'show', 'job', sbatch_id],
-                                  stdout=subprocess.PIPE,
-                                  stderr=subprocess.STDOUT)
-        jobout = jobcheck.stdout.decode()
-
-        # Jobs have a number of potential states that they can be in if they
-        # are still active in the Slurm scheduler.
-        if [state for state in SLURM_ACTIVE_STATES if state in jobout]:
-            pass
-        # 'COMPLETED' is a special case indicating successful job termination.
-        elif 'COMPLETED' in jobout:
-            break
-        elif 'Invalid job id specified' in jobout:
-            # May have already completed and been purged from active list.
-            break
-        # Jobs have a number of potential states that they can be in if they
-        # did not terminate successfully.
-        elif [state for state in SLURM_INACTIVE_STATES if state in jobout]:
-            # FAILED, TIMEOUT, etc.
-            retcode = 1
-            break
-
-    if retcode > 0:
-        chip.logger.error(f'srun command for {step} failed.')
-        chip.logger.error(f'srun output for {step}: {jobout}')
 
 
 def _get_slurm_partition():

siliconcompiler/scheduler/taskscheduler.py

@@ -0,0 +1,320 @@
+import multiprocessing
+import sys
+import time
+
+import os.path
+
+from logging.handlers import QueueListener
+
+from siliconcompiler import NodeStatus
+from siliconcompiler import SiliconCompilerError
+from siliconcompiler import utils
+from siliconcompiler.flowgraph import RuntimeFlowgraph
+
+from siliconcompiler.schema import JournalingSchema
+
+from siliconcompiler.scheduler import slurm
+from siliconcompiler.scheduler import docker_runner
+from siliconcompiler.tools._common import get_tool_task
+from siliconcompiler.utils.logging import SCBlankLoggerFormatter
+
+
+class TaskScheduler:
+    __callbacks = {
+        "pre_run": lambda chip: None,
+        "pre_node": lambda chip, step, index: None,
+        "post_node": lambda chip, step, index: None,
+        "post_run": lambda chip: None,
+    }
+
+    @staticmethod
+    def register_callback(hook, func):
+        if hook not in TaskScheduler.__callbacks:
+            raise ValueError(f"{hook} is not a valid callback")
+        TaskScheduler.__callbacks[hook] = func
+
+    def __init__(self, chip):
+        self.__chip = chip
+        self.__logger = self.__chip.logger
+        self.__schema = self.__chip.schema
+        self.__flow = self.__schema.get("flowgraph", self.__chip.get('option', 'flow'),
+                                        field="schema")
+        self.__record = self.__schema.get("record", field="schema")
+        self.__dashboard = chip._dash
+
+        self.__max_cores = utils.get_cores(chip)
+        self.__max_threads = utils.get_cores(chip)
+        self.__max_parallel_run = self.__chip.get('option', 'scheduler', 'maxnodes')
+        if not self.__max_parallel_run:
+            self.__max_parallel_run = utils.get_cores(chip)
+        # clip max parallel jobs to 1 <= jobs <= max_cores
+        self.__max_parallel_run = max(1, min(self.__max_parallel_run, self.__max_cores))
+
+        self.__log_queue = multiprocessing.Queue(-1)
+
+        self.__nodes = {}
+        self.__startTimes = {}
+        self.__dwellTime = 0.1
+
+        self.__create_nodes()
+
+    def __create_nodes(self):
+        from siliconcompiler.scheduler import _executenode, _runtask
+
+        runtime = RuntimeFlowgraph(
+            self.__flow,
+            from_steps=set([step for step, _ in self.__flow.get_entry_nodes()]),
+            prune_nodes=self.__chip.get('option', 'prune'))
+
+        init_funcs = set()
+
+        runtime_flow = RuntimeFlowgraph(
+            self.__flow,
+            from_steps=self.__chip.get('option', 'from'),
+            to_steps=self.__chip.get('option', 'to'),
+            prune_nodes=self.__chip.get('option', 'prune'))
+
+        for step, index in runtime_flow.get_nodes():
+            if self.__record.get('status', step=step, index=index) != NodeStatus.PENDING:
+                continue
+
+            tool_name, task_name = get_tool_task(self.__chip, step, index)
+            threads = self.__chip.get('tool', tool_name, 'task', task_name, 'threads',
+                                      step=step, index=index)
+            if not threads:
+                threads = self.__max_threads
+            threads = max(1, min(threads, self.__max_threads))
+
+            task = {
+                "name": f"{step}{index}",
+                "inputs": runtime.get_node_inputs(step, index, record=self.__record),
+                "proc": None,
+                "child_pipe": None,
+                "parent_pipe": None,
+                "local": False,
+                "tool": tool_name,
+                "task": task_name,
+                "threads": threads,
+                "running": False,
+                "manifest": os.path.join(self.__chip.getworkdir(step=step, index=index),
+                                         'outputs',
+                                         f'{self.__chip.design}.pkg.json')
+            }
+
+            exec_func = _executenode
+
+            node_scheduler = self.__chip.get('option', 'scheduler', 'name', step=step, index=index)
+            if node_scheduler == 'slurm':
+                # Defer job to compute node
+                # If the job is configured to run on a cluster, collect the schema
+                # and send it to a compute node for deferred execution.
+                init_funcs.add(slurm.init)
+                exec_func = slurm._defernode
+            elif node_scheduler == 'docker':
+                # Run job in docker
+                init_funcs.add(docker_runner.init)
+                exec_func = docker_runner.run
+                task["local"] = True
+            else:
+                task["local"] = True
+
+            task["parent_pipe"], task["child_pipe"] = multiprocessing.Pipe()
+            task["proc"] = multiprocessing.Process(
+                target=_runtask,
+                args=(self.__chip, self.__flow.name(), step, index, exec_func),
+                kwargs={"pipe": task["child_pipe"],
+                        "queue": self.__log_queue})
+
+            self.__nodes[(step, index)] = task
+
+        # Call preprocessing for schedulers
+        for init_func in init_funcs:
+            init_func(self.__chip)
+
+    def run(self):
+        # Call this in case this was invoked without __main__
+        multiprocessing.freeze_support()
+
+        # Handle logs across threads
+        log_listener = QueueListener(self.__log_queue, self.__logger._console)
+        console_format = self.__logger._console.formatter
+        self.__logger._console.setFormatter(SCBlankLoggerFormatter())
+        log_listener.start()
+
+        # Update dashboard before run begins
+        if self.__dashboard:
+            self.__dashboard.update_manifest()
+
+        TaskScheduler.__callbacks["pre_run"](self.__chip)
+
+        try:
+            self.__run_loop()
+        except KeyboardInterrupt:
+            # exit immediately
+            log_listener.stop()
+            sys.exit(0)
+
+        TaskScheduler.__callbacks["post_run"](self.__chip)
+
+        # Cleanup logger
+        log_listener.stop()
+        self.__logger._console.setFormatter(console_format)
+
+    def __run_loop(self):
+        self.__startTimes = {None: time.time()}
+
+        while len(self.get_nodes_waiting_to_run()) > 0 or len(self.get_running_nodes()) > 0:
+            changed = self.__process_completed_nodes()
+            changed |= self.__lanuch_nodes()
+
+            if changed and self.__dashboard:
+                # Update dashboard if the manifest changed
+                self.__dashboard.update_manifest(payload={"starttimes": self.__startTimes})
+
+            running_nodes = self.get_running_nodes()
+
+            # Check for situation where we have stuff left to run but don't
+            # have any nodes running. This shouldn't happen, but we will get
+            # stuck in an infinite loop if it does, so we want to break out
+            # with an explicit error.
+            if len(self.get_nodes_waiting_to_run()) > 0 and len(running_nodes) == 0:
+                raise SiliconCompilerError(
+                    'Nodes left to run, but no running nodes. From/to may be invalid.',
+                    chip=self.__chip)
+
+            if len(running_nodes) == 1:
+                # if there is only one node running, just join the thread
+                self.__nodes[running_nodes[0]]["proc"].join()
+            elif len(running_nodes) > 1:
+                # if there are more than 1, join the first with a timeout
+                self.__nodes[running_nodes[0]]["proc"].join(timeout=self.__dwellTime)
+
+    def get_nodes(self):
+        return sorted(self.__nodes.keys())
+
+    def get_running_nodes(self):
+        nodes = []
+        for node, info in self.__nodes.items():
+            if info["running"]:
+                nodes.append(node)
+        return sorted(nodes)
+
+    def get_nodes_waiting_to_run(self):
+        nodes = []
+        for node, info in self.__nodes.items():
+            if not info["running"] and info["proc"]:
+                nodes.append(node)
+        return sorted(nodes)
+
+    def __process_completed_nodes(self):
+        changed = False
+        for node in self.get_running_nodes():
+            info = self.__nodes[node]
+
+            if not info["proc"].is_alive():
+                manifest = info["manifest"]
+
+                self.__logger.debug(f'{info["name"]} is complete merging: {manifest}')
+
+                if os.path.exists(manifest):
+                    JournalingSchema(self.__schema).read_journal(manifest)
+
+                if info["parent_pipe"] and info["parent_pipe"].poll(1):
+                    try:
+                        packages = info["parent_pipe"].recv()
+                        if isinstance(packages, dict):
+                            self.__chip._packages.update(packages)
+                    except:  # noqa E722
+                        pass
+
+                step, index = node
+                if info["proc"].exitcode > 0:
+                    status = NodeStatus.ERROR
+                else:
+                    status = self.__record.get('status', step=step, index=index)
+                    if not status or status == NodeStatus.PENDING:
+                        status = NodeStatus.ERROR
+
+                self.__record.set('status', status, step=step, index=index)
+
+                info["running"] = False
+                info["proc"] = None
+
+                changed = True
+
+                TaskScheduler.__callbacks['post_node'](self.__chip, step, index)
+
+        return changed
+
+    def __allow_start(self, node):
+        info = self.__nodes[node]
+
+        if not info["local"]:
+            # using a different scheduler, so allow
+            return True
+
+        running_nodes = self.get_running_nodes()
+
+        if len(running_nodes) >= self.__max_parallel_run:
+            # exceeding machine resources
+            return False
+
+        current_threads = sum([self.__nodes[run_node]["threads"] for run_node in running_nodes])
+
+        if info["threads"] + current_threads > self.__max_cores:
+            # delay until there are enough core available
+            return False
+
+        # allow
+        return True
+
+    def __lanuch_nodes(self):
+        changed = False
+        for node in self.get_nodes_waiting_to_run():
+            # TODO: breakpoint logic:
+            # if node is breakpoint, then don't launch while len(running_nodes) > 0
+
+            info = self.__nodes[node]
+            step, index = node
+
+            ready = True
+            inputs = []
+            for in_step, in_index in info["inputs"]:
+                in_status = self.__record.get('status', step=in_step, index=in_index)
+                inputs.append(in_status)
+
+                if not NodeStatus.is_done(in_status):
+                    ready = False
+                    break
+                if NodeStatus.is_error(in_status) and info["tool"] != "builtin":
+                    # Fail if any dependency failed for non-builtin task
+                    self.__record.set("status", NodeStatus.ERROR, step=step, index=index)
+
+            # Fail if no dependency successfully finished for builtin task
+            if inputs:
+                any_success = any([status == NodeStatus.SUCCESS for status in inputs])
+            else:
+                any_success = True
+            if ready and info["tool"] == "builtin" and not any_success:
+                self.__record.set("status", NodeStatus.ERROR, step=step, index=index)
+
+            if self.__record.get('status', step=step, index=index) == NodeStatus.ERROR:
+                info["proc"] = None
+                continue
+
+            # If there are no dependencies left, launch this node and
+            # remove from nodes_to_run.
+            if ready and self.__allow_start(node):
+                self.__logger.debug(f'Launching {info["name"]}')
+
+                TaskScheduler.__callbacks['pre_node'](self.__chip, step, index)
+
+                self.__record.set('status', NodeStatus.RUNNING, step=step, index=index)
+                self.__startTimes[node] = time.time()
+                changed = True
+
+                # Start the process
+                info["running"] = True
+                info["proc"].start()
+
+        return changed

siliconcompiler/schema/__init__.py

@@ -1,7 +1,24 @@
+from .parameter import Parameter, Scope, PerNode
+from .safeschema import SafeSchema
+from .editableschema import EditableSchema
+from .baseschema import BaseSchema
+from .cmdlineschema import CommandLineSchema
+from .journalingschema import JournalingSchema
+from .namedschema import NamedSchema
+from .packageschema import PackageSchema
+
 from .schema_cfg import SCHEMA_VERSION
-from .schema_obj import Schema
 
 __all__ = [
     "SCHEMA_VERSION",
-    "Schema"
+    "BaseSchema",
+    "SafeSchema",
+    "EditableSchema",
+    "CommandLineSchema",
+    "JournalingSchema",
+    "NamedSchema",
+    "PackageSchema",
+    "Parameter",
+    "Scope",
+    "PerNode"
 ]