BishBosh.Input.PieceSquareTable

AUTHOR

Dr. Alistair Ward

DESCRIPTION

• Defines the value for each type of piece, of occupying different squares.
• This module is used to parse the user's configuration, which may involve reflecting their configuration to generate values for the RHS of the board.
• This metric includes aspects of both control of the centre, & material advantage, in that a side's score can increase either by occupying squares of greater value, or simply by having more pieces.
• N.B.: the evaluation of fitness by material COULD be entirely built into these tables, so that the average value for a Queen is ~9 times that for a Pawn, but under these circumstances a non-zero material value for a King must be arbitrarily chosen.
• N.B. The normal & end-game phases are typically represented by independent instances. CAVEAT: any normalisation is performed on each of these instances independently, using their respective minimum & maximum values, rather than using the global minimum & maximum.

Types

Type-synonyms

type IOFormat = Double

The format of the values when read or written.

type Assocs rank pieceSquareValue = [(rank, [pieceSquareValue])]

Type-synonym.

Data-types

data PieceSquareTable pieceSquareValue

Defines the value for each type of piece, of occupying each square.

Instances

Eq pieceSquareValue => Eq (PieceSquareTable pieceSquareValue)

Defined in BishBosh.Input.PieceSquareTable

Methods

(==) :: PieceSquareTable pieceSquareValue -> PieceSquareTable pieceSquareValue -> Bool

(/=) :: PieceSquareTable pieceSquareValue -> PieceSquareTable pieceSquareValue -> Bool

Show pieceSquareValue => Show (PieceSquareTable pieceSquareValue)

Defined in BishBosh.Input.PieceSquareTable

Methods

showsPrec :: Int -> PieceSquareTable pieceSquareValue -> ShowS

show :: PieceSquareTable pieceSquareValue -> String

showList :: [PieceSquareTable pieceSquareValue] -> ShowS

Default (PieceSquareTable pieceSquareValue)

Defined in BishBosh.Input.PieceSquareTable

Methods

def :: PieceSquareTable pieceSquareValue

(Fractional pieceSquareValue, Ord pieceSquareValue, Real pieceSquareValue, Show pieceSquareValue) => XmlPickler (PieceSquareTable pieceSquareValue)

Defined in BishBosh.Input.PieceSquareTable

Methods

xpickle :: PU (PieceSquareTable pieceSquareValue)

(Real pieceSquareValue, Show pieceSquareValue) => ShowFloat (PieceSquareTable pieceSquareValue)

Defined in BishBosh.Input.PieceSquareTable

Methods

showsFloat :: (Double -> ShowS) -> PieceSquareTable pieceSquareValue -> ShowS

Constants

tag :: String

Used to qualify XML.

reflectOnYTag :: String

Used to qualify XML.

Functions

normaliseToUnitInterval :: (Fractional pieceSquareValue, Ord pieceSquareValue) => Assocs rank pieceSquareValue -> Assocs rank pieceSquareValue

Map the range of values onto the Closed Unit Interval.

mirror :: Show pieceSquareValue => [pieceSquareValue] -> [pieceSquareValue]

Generates a mirror-symmetric RHS, to build a complete description.

unmirror :: Show pieceSquareValue => [pieceSquareValue] -> [pieceSquareValue]

Removes the mirror-symmetric RHS, for a concise description.

findUndefinedRanks :: PieceSquareTable pieceSquareValue -> Set Rank

Identify any rank lacking a definition.

dereference :: Rank -> PieceSquareTable pieceSquareValue -> Maybe (ArrayByCoordinates pieceSquareValue)

Lookup the values for all coordinates, corresponding to the specified rank.

Constructors

mkPieceSquareTable

Arguments

:: (Fractional pieceSquareValue, Ord pieceSquareValue, Show pieceSquareValue)

=> Normalise

Whether to normalise the specified values into the closed unit interval.

-> ReflectOnY

Whether values for the RHS of the board are inferred by reflection about the y-axis.

-> Assocs Rank pieceSquareValue

-> PieceSquareTable pieceSquareValue

Smart constructor.

Predicates

inClosedUnitInterval :: (Num pieceSquareValue, Ord pieceSquareValue) => Assocs rank pieceSquareValue -> Bool

Check that the range of values is in the Closed Unit Interval.