The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Types-PDL-0.04
River stage one • 4 direct dependents • 6 total dependents
/ Types::PDL

NAME

Types::PDL - PDL types using Type::Tiny

VERSION

version 0.04

SYNOPSIS

use Types::PDL -types;
use Type::Params qw[ validate ];
use PDL;

validate( [ pdl ], NDArray );

DESCRIPTION

This module provides Type::Tiny compatible types for PDL.

Types

Types which accept parameters (see "Parameters") will list them.

NDArray | Piddle (deprecated)

Allows an object blessed into the class PDL, e.g.

validate( [pdl], NDarray );

It accepts the following parameters:

null
empty
ndims
ndims_min
ndims_max
shape
type

NDArray0D | Piddle0D (deprecated)

Allows an object blessed into the class PDL with ndims = 0. It accepts the following parameters:

null
type

NDArray1D | Piddle1D (deprecated)

Allows an object blessed into the class PDL with ndims = 1. It accepts the following parameters:

null
empty
shape
type

NDArray2D | Piddle2D (deprecated)

Allows an object blessed into the class PDL with ndims = 2. It accepts the following parameters:

null
empty
shape
type

NDArray3D | Piddle3D (deprecated)

Allows an object blessed into the class PDL with ndims = 3. It accepts the following parameters:

null
empty
shape
type

Coercions

The following coercions are provided, and may be applied via a type object's "plus_coercions" in Type::Tiny or "plus_fallback_coercions" in Type::Tiny methods, e.g.

NDArray->plus_coercions( NDArrayFromAny );

NDArrayFromAny | PiddleFromAny (deprecated)

Uses "topdl" in PDL::Core to coerce the value into a PDL object.

Parameters

Some types take optional parameters which add additional constraints on the object. For example, to indicate that only empty PDL objects are accepted:

validate( [pdl], NDArray[ empty => 1 ] );

The available parameters are:

empty

This accepts a boolean value; if true the PDL object must be empty (i.e. the isempty method returns true), if false, it must not be empty.

null

This accepts a boolean value; if true the PDL object must be a null PDL object, if false, it must not be null.

ndims

This specifies a fixed number of dimensions which the PDL object must have. Don't mix use this with ndims_min or ndims_max.

ndims_min

The minimum number of dimensions the PDL object may have. Don't specify this with ndims.

ndims_max

The maximum number of dimensions the PDL object may have. Don't specify this with ndims.

shape

The shape of the PDL object.

The value is a list of specifications for dimensions, expressed either as elements in a Perl array or as comma-delimited fields in a string.

The specifications are reminiscent of regular expressions. A specification is composed of an extent size followed by an optional quantifier indicating the number of dimensions it should match.

Extent sizes may be

  1. A non-zero positive integer representing the extent of the dimension.

  2. The strings X or : indicating that any extent is accepted for that dimension

Quantifiers may be

*           Match 0 or more times
+           Match 1 or more times
?           Match 1 or 0 times
{n}         Match exactly n times
{n,}        Match at least n times
{n,m}       Match at least n but not more than m times

Here are some example specifications and the shapes they might match (in the match, X means any extent):

2,2     => (2,2)
3,3,3   => (3,3,3)
3{3}    => (3,3,3)
3{2,3}  => (3,3),  (3,3,3)
1,X     => (1,X)
1,X+    => (1,X), (1,X,X),  (1,X,X,X), ...
1,X{1,} => (1,X), (1,X,X),  (1,X,X,X), ...
1,X?,3   => (1,X,3), (1,3)
1,2,X*   => (1,2), (1,2,X),  (1,2,X,X), ...
1,2,3*,5   => (1,2,5), (1,2,3,5),  (1,2,3,3,5), ...

type

The type of the PDL object. The value may be a PDL::Type object or a string containing the name of a type (e.g., double). For a complete list of types, run this command:

perl -MPDL::Types=mapfld,ppdefs \
  -E 'say mapfld( $_ => 'ppsym' => 'ioname' )  for ppdefs'

SUPPORT

Bugs

Please report any bugs or feature requests to bug-types-pdl@rt.cpan.org or through the web interface at: https://rt.cpan.org/Public/Dist/Display.html?Name=Types-PDL

Source

Source is available at

https://gitlab.com/djerius/types-pdl

and may be cloned from

https://gitlab.com/djerius/types-pdl.git

SEE ALSO

Please see those modules/websites for more information related to this module.

AUTHOR

Diab Jerius <djerius@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2017 by Smithsonian Astrophysical Observatory.

This is free software, licensed under:

The GNU General Public License, Version 3, June 2007