accelforge.mapper package

Subpackages

• accelforge.mapper.FFM package
  • Submodules
  • accelforge.mapper.FFM.data module
    • ActionDataFrame
    • ResultDataFrame
      • ResultDataFrame.actions
      • ResultDataFrame.actions_df
      • ResultDataFrame.energy
    • VerboseActionDataFrame
  • accelforge.mapper.FFM.main module
    • join_pmappings()
    • make_pmappings()
    • map_workload_to_arch()
  • accelforge.mapper.FFM.mappings module
    • Mappings
      • Mappings.__init__()
      • Mappings.access()
      • Mappings.actions()
      • Mappings.columns
      • Mappings.drop()
      • Mappings.drop_zeros()
      • Mappings.energy()
      • Mappings.items()
      • Mappings.latency()
      • Mappings.mapping()
      • Mappings.num_computes()
      • Mappings.per_compute()
      • Mappings.per_tensor_size()
      • Mappings.render()
      • Mappings.resource_usage()
      • Mappings.sum()
      • Mappings.to_dict()
  • accelforge.mapper.FFM.pmappings module
    • MultiEinsumPmappings
      • MultiEinsumPmappings.__init__()
      • MultiEinsumPmappings.drop_einsums()
      • MultiEinsumPmappings.n_evaluated_pmappings()
      • MultiEinsumPmappings.n_pareto_optimal_pmappings()
      • MultiEinsumPmappings.n_pmapping_string()
      • MultiEinsumPmappings.n_total_pmappings()
      • MultiEinsumPmappings.n_valid_pmappings()
      • MultiEinsumPmappings.pmapping_keep_rates()
  • Module contents
    • Mappings
      • Mappings.__init__()
      • Mappings.access()
      • Mappings.actions()
      • Mappings.columns
      • Mappings.drop()
      • Mappings.drop_zeros()
      • Mappings.energy()
      • Mappings.items()
      • Mappings.latency()
      • Mappings.mapping()
      • Mappings.num_computes()
      • Mappings.per_compute()
      • Mappings.per_tensor_size()
      • Mappings.render()
      • Mappings.resource_usage()
      • Mappings.sum()
      • Mappings.to_dict()
    • Metrics
      • Metrics.ACTIONS
      • Metrics.DETAILED_MEMORY_USAGE
      • Metrics.DYNAMIC_ENERGY
      • Metrics.ENERGY
      • Metrics.LATENCY
      • Metrics.LEAK_ENERGY
      • Metrics.RESOURCE_USAGE
      • Metrics.__new__()
      • Metrics.all_metrics()
      • Metrics.includes_dynamic_energy()
      • Metrics.includes_leak_energy()
    • MultiEinsumPmappings
      • MultiEinsumPmappings.__init__()
      • MultiEinsumPmappings.drop_einsums()
      • MultiEinsumPmappings.n_evaluated_pmappings()
      • MultiEinsumPmappings.n_pareto_optimal_pmappings()
      • MultiEinsumPmappings.n_pmapping_string()
      • MultiEinsumPmappings.n_total_pmappings()
      • MultiEinsumPmappings.n_valid_pmappings()
      • MultiEinsumPmappings.pmapping_keep_rates()
    • PmappingGroup
      • PmappingGroup.__init__()
      • PmappingGroup.combine_combineable()
      • PmappingGroup.compatibility_str()
      • PmappingGroup.concat()
      • PmappingGroup.copy()
      • PmappingGroup.filter_by_tensors()
      • PmappingGroup.get_shared_loop_index()
      • PmappingGroup.group()
      • PmappingGroup.left_consolidate()
      • PmappingGroup.merge_next()
      • PmappingGroup.remove_dead_tensors()
      • PmappingGroup.rename_compatibility()
      • PmappingGroup.right_consolidate()
      • PmappingGroup.tensor_names
    • join_pmappings()
    • make_pmappings()
    • map_workload_to_arch()

Module contents

class accelforge.mapper.Metrics

Bases: Flag

Metrics used to optimize mappings or reported by model.

ACTIONS = 32

Action counts.

DETAILED_MEMORY_USAGE = 64

Memory usage broken down by tensor and Einsum.

DYNAMIC_ENERGY = 4

The amount of dynamic energy consumed by the workload.

ENERGY = 2

The amount of energy consumed by the workload.

LATENCY = 1

The amount of time taken to execute the workload.

LEAK_ENERGY = 8

The amount of leak energy consumed by the workload.

RESOURCE_USAGE = 16

The amount of resources used by the workload.

When used as a mapper objective, this objective is multivariate, and must consider every resource available to the hardware.

__new__(value)

classmethod all_metrics()

includes_dynamic_energy()

Returns True if the metrics include dynamic energy, either alone or as part of total energy. False otherwise.

Return type:

bool

includes_leak_energy()

Returns True if the metrics include leak energy, either alone or as part of total energy. False otherwise.

Return type:

bool