pygsti.layouts.termlayout
¶
Defines the TermCOPALayout class.
Module Contents¶
Classes¶
The atom ("atomic unit") for dividing up the element dimension in a 

A circuit outcome probability array (COPA) layout for circuit simulation by taylorterm path integration. 
 class pygsti.layouts.termlayout._TermCOPALayoutAtom(unique_complete_circuits, ds_circuits, group, model, dataset)¶
Bases:
pygsti.layouts.distlayout._DistributableAtom
The atom (“atomic unit”) for dividing up the element dimension in a
TermCOPALayout
.This class noteably holds the current “pathset” used to evaluate circuit probabilites, as well as compact representations of the polynomials for evaluating these probabilities.
 Parameters
unique_complete_circuits (list) – A list that contains all the “complete” circuits for the parent layout. This atom only owns a subset of these, as given by group below.
ds_circuits (list) – A parallel list of circuits as they should be accessed from dataset. This applies any aliases and removes implied SPAM elements relative to unique_complete_circuits.
group (set) – The set of uniquecircuit indices (i.e. indices into unique_complete_circuits) that this atom owns.
model (Model) – The model being used to construct this layout. Used for expanding instruments within the circuits.
dataset (DataSet) – The dataset, used to include only observed circuit outcomes in this atom and therefore the parent layout.
 property cache_size(self)¶
The cache size of this atom.
 class pygsti.layouts.termlayout.TermCOPALayout(circuits, model, dataset=None, num_sub_tables=None, num_table_processors=1, num_param_dimension_processors=(), param_dimensions=(), param_dimension_blk_sizes=(), resource_alloc=None, verbosity=0)¶
Bases:
pygsti.layouts.distlayout.DistributableCOPALayout
A circuit outcome probability array (COPA) layout for circuit simulation by taylorterm path integration.
A simple distributed layout that divides a list of circuits among available processors. This layout is designed for Taylorterm based calculations for which there is no straightforward caching/performanceenhancement mechanism. The pathintegral specific implementation is present in the atoms, which hold current path sets and compact polynomials for speeding the evaluation of circuit outcome probabilities.
 Parameters
circuits (list) – A list of:class:Circuit objects representing the circuits this layout will include.
model (Model) – The model that will be used to compute circuit outcome probabilities using this layout. This model is used to complete and expand the circuits in circuits.
dataset (DataSet, optional) – If not None, restrict the circuit outcomes stored by this layout to only the outcomes observed in this data set.
num_sub_tables (int, optional) – The number of groups (“subtables”) to divide the circuits into. This is the number of atoms for this layout.
num_table_processors (int, optional) – The number of atomprocessors, i.e. groups of processors that process subtables.
num_param_dimension_processors (tuple, optional) – A 1 or 2tuple of integers specifying how many parameterblock processors are used when dividing the physical processors into a grid. The first and second elements correspond to counts for the first and second parameter dimensions, respecively.
param_dimensions (tuple, optional) – The number of parameters along each parameter dimension. Can be an empty, 1, or 2tuple of integers which dictates how many parameter dimensions this layout supports.
param_dimension_blk_sizes (tuple, optional) – The parameter block sizes along each present parameter dimension, so this should be the same shape as param_dimensions. A block size of None means that there should be no division into blocks, and that each block processor computes all of its parameter indices at once.
resource_alloc (ResourceAllocation, optional) – The resources available for computing circuit outcome probabilities.
verbosity (int or VerbosityPrinter) – Determines how much output to send to stdout. 0 means no output, higher integers mean more output.
 property pathset(self)¶
This layout’s current path set.
 Returns
TermPathSet or None