Reporters

Functions for printing channels. More...

Functions
void	reportKrausMap (KrausMap map)
void	reportSuperOp (SuperOp op)

Detailed Description

Functions for printing channels.

Function Documentation

reportKrausMap()

void reportKrausMap

(

KrausMap

map

)

Prints a KrausMap.

Example

KrausMap map = createInlineKrausMap(1, 3, {
    {{1,2},{3,4}},
    {{5,5},{6,6}},
    {{1i,2i},{-3i,-4i}}
});
reportKrausMap(map);

KrausMap (1 qubit, 3 2x2 matrices, 1 4x4 superoperator, 528 bytes):
    [matrix 0]
        1  2  
        3  4  
    [matrix 1]
        5  5  
        6  6  
    [matrix 2]
        i    2i   
        -3i  -4i  

Parameters

[in]

map

the KrausMap to print.

Exceptions

error

if map is uninitialised.

Author

Tyson Jones

Definition at line 471 of file channels.cpp.

                                             {
    validate_krausMapFields(map, __func__);
    validate_numReportedNewlinesAboveZero(__func__); // because trailing newline mandatory
 
    // pedantically demand that the map's SuperOP is GPU-synced,
    // even though only the CPU Kraus operators are printed
    validate_krausMapIsSynced(map, __func__);
 
    // determine memory costs (gauranteed not to overflow)
    bool isDense = true;
    int numNodes = 1;
    size_t krausMem = mem_getLocalMatrixMemoryRequired(map.numQubits, isDense, numNodes) * map.numMatrices;
    size_t superMem = mem_getLocalSuperOpMemoryRequired(map.superop.numQubits);
    size_t strucMem = sizeof(map);
 
    printer_sync();
 
    // gauranteed not to overflow
    size_t totalMem = krausMem + superMem + strucMem;
    print_header(map, totalMem);
    print_elems(map);
 
    // exclude mandatory newline above
    print_oneFewerNewlines();
    
    printer_sync();
}

reportSuperOp()

void reportSuperOp

(

SuperOp

op

)

Prints a SuperOp.

Example

SuperOp op = createInlineSuperOp(1, {
    {1,2,3,4},
    {5,-(10E-2)*3.14i,7,8},
    {9,10,11,12},
    {13,14,15,16+1.23i}
});
reportSuperOp(op);

SuperOp (1 qubit, 4x4 qcomps, 304 bytes):
    1   2        3   4         
    5   -0.314i  7   8         
    9   10       11  12        
    13  14       15  16+1.23i 

Parameters

[in]

op

the SuperOp to print.

Exceptions

error

if op is uninitialised.

Author

Tyson Jones

Definition at line 447 of file channels.cpp.

                                          {
    validate_superOpFields(op, __func__);
    validate_numReportedNewlinesAboveZero(__func__); // because trailing newline mandatory
 
    // demand that SuperOp is GPU-synced, since the
    // to-be-printed GPU elems will overwrite CPU
    validate_superOpIsSynced(op, __func__);
 
    // determine memory costs; heap memory and struct fields
    size_t elemMem = mem_getLocalSuperOpMemoryRequired(op.numQubits);
    size_t structMem = sizeof(op);
 
    printer_sync();
 
    print_header(op, elemMem + structMem);
    print_elems(op);
 
    // exclude mandatory newline above
    print_oneFewerNewlines();
 
    printer_sync();
}