Goto Chapter: Top 1 2 3 4 5 6 7 8 Bib Ind
 [Top of Book]  [Contents]   [Previous Chapter]   [Next Chapter] 

6 Ordered partition stacks
 6.1 API

6 Ordered partition stacks

An ordered partition stack is an ordered partition which supports splitting a cell, and then later undoing a change, reverting the partition back to an earlier state.

6.1 API

6.1-1 PartitionStack
‣ PartitionStack( )( function )

Returns: A partition stack

Constructor for partition stacks.

6.1-2 IsPartitionStack
‣ IsPartitionStack( arg )( filter )

Returns: true or false

Category of partition stacks.

6.1-3 PS_Points
‣ PS_Points( PS )( operation )

Returns: A positive integer

Return the number of points on which the partition stack PS was originally defined.

6.1-4 PS_ExtendedPoints
‣ PS_ExtendedPoints( PS )( operation )

Returns: A positive integer

Return the number of points on which the partition stack PS is currently defined on (which includes extra points added during refinement)

6.1-5 PS_Extend
‣ PS_Extend( PS, NewPoints )( operation )

Returns: The label of the new cell

Adds NewPoints to PS, as a new cell at the end. Will be removed on backtracking.

6.1-6 PS_Cells
‣ PS_Cells( PS )( operation )

Returns: A positive integer

The number of cells in the current partition state of the partition stack PS.

6.1-7 PS_Fixed
‣ PS_Fixed( PS )( operation )

Returns: true or false

Return true if all the cells of the current partition state of the partition stack PS have size 1 and were in the 'original partition'.

6.1-8 PS_AsPartition
‣ PS_AsPartition( PS )( operation )

Returns: A list of lists of positive integers

Return the current partition state of the partition stack PS as a list of sets, in the correct order.

6.1-9 PS_CellLen
‣ PS_CellLen( PS, i )( operation )

Returns: A positive integer

The size of cell i in the current partition state of the partition stack PS. This requires that i is contained in [1..PS_Cells(PS)].

6.1-10 PS_CellSlice
‣ PS_CellSlice( PS, i )( operation )

Returns: An immutable list of positive integers

Return an immutable list containing the elements of cell i in the current partition state of the partition stack PS. This requires that i is contained in [1..PS_Cells(PS)].

6.1-11 PS_FixedCells
‣ PS_FixedCells( PS )( operation )

Returns: A list of 1-element lists of positive integers

Return a list of the 1-element cells of the current state of the partition stack PS which contain points from the original size of the partition, in the order in which the cells came to have size 1.

6.1-12 PS_FixedPoints
‣ PS_FixedPoints( PS )( operation )

Returns: A list of positive integers

Return a list of points in 1-element cells of the partition stack PS, in the order in which the cells came to have size 1. In other words, return Concatenation(PS_FixedCells(PS)).

6.1-13 PS_CellOfPoint
‣ PS_CellOfPoint( PS, i )( operation )

Returns: A positive integer

Return the index of the cell containing the value i in the current partition state of the partition stack PS. This requires that i is contained in [1..PS_ExtededPoints(PS)].

6.1-14 PS_RevertToCellCount
‣ PS_RevertToCellCount( PS, i )( operation )

Returns: Nothing

Revert the state of the partition stack PS to when there were i cells. This requires that i is contained in [1..PS_Cells(PS)].

6.1-15 PS_SplitCellByFunction
‣ PS_SplitCellByFunction( PS, t, i, f )( operation )

Returns: true or false

Split cell i of the current partition state of the partition stack PS according to the function f. The values in the cell are split so that those with different images under f are put into different cells. The second argument t should be a tracer.

6.1-16 PS_SplitCellsByFunction
‣ PS_SplitCellsByFunction( PS, t, f )( operation )

Returns: true or false

Apply PS_SplitCellByFunction to every active cell in the partition stack PS (ignoring points added after search starts).

6.1-17 PS_ExtendedSplitCellsByFunction
‣ PS_ExtendedSplitCellsByFunction( PS, t, f )( operation )

Returns: true or false

Apply PS_SplitCellByFunction to every active cell in the partition stack PS (including points added after search starts).

6.1-18 PS_SplitCellByUnorderedFunction
‣ PS_SplitCellByUnorderedFunction( PS, t, i, f )( operation )

Split cell i of the current partition state of the partition stack PS according to the function f. The values in the cell are split so that those with different images under f are put into different cells. The second argument t should be a tracer.

6.1-19 PS_SplitCellsByUnorderedFunction
‣ PS_SplitCellsByUnorderedFunction( PS, t, f )( operation )

Apply PS_SplitCellByUnorderedFunction to every active cell in the partition stack PS. The second argument t should be a tracer.

 [Top of Book]  [Contents]   [Previous Chapter]   [Next Chapter] 
Goto Chapter: Top 1 2 3 4 5 6 7 8 Bib Ind

generated by GAPDoc2HTML