Source code for spinn_front_end_common.interface.interface_functions.placements_provenance_gatherer

# Copyright (c) 2017-2019 The University of Manchester
#
# 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/>.

import logging
import traceback
from spinn_utilities.log import FormatAdapter
from spinn_utilities.progress_bar import ProgressBar
from spinn_front_end_common.interface.provenance import (
    AbstractProvidesProvenanceDataFromMachine)

logger = FormatAdapter(logging.getLogger(__name__))


[docs]class PlacementsProvenanceGatherer(object): """ Gets provenance information from vertices on the machine. """ __slots__ = []
[docs] def __call__(self, transceiver, placements): """ :param ~spinnman.transceiver.Transceiver transceiver: the SpiNNMan interface object :param ~pacman.model.placements.Placements placements: The placements of the vertices :rtype: list(ProvenanceDataItem) """ prov_items = list() errors = list() progress = ProgressBar( placements.n_placements, "Getting provenance data") # retrieve provenance data from any cores that provide data for placement in progress.over(placements.placements): prov_items.extend( self._add_placement_provenance(placement, transceiver, errors)) if errors: logger.warning("Errors found during provenance gathering:") for error in errors: logger.warning("{}", error) return prov_items
@staticmethod def _add_placement_provenance(placement, txrx, errors): """ :param ~.Placement placement: :param ~.Transceiver txrx: :param list(str) errors: :rtype: ~collections.abc.Iterable(ProvenanceDataItem) """ # retrieve provenance data from any cores that provide data if isinstance( placement.vertex, AbstractProvidesProvenanceDataFromMachine): # get data try: yield from placement.vertex.get_provenance_data_from_machine( txrx, placement) except Exception: # pylint: disable=broad-except errors.append(traceback.format_exc())