There is an ongoing outage on the primary CPAN mirror. It is possible to work around the issue by using MetaCPAN as a mirror.

 / 
PDL-VectorValued-1.0.23
River stage one • 2 direct dependents • 5 total dependents
/ Utils/utils.pd

NAME

PDL::VectorValued::Utils - Low-level utilities for vector-valued PDLs

SYNOPSIS

use PDL;
use PDL::VectorValued::Utils;

##---------------------------------------------------------------------
## ... stuff happens

Vector-Based Run-Length Encoding and Decoding

Routine for searching N-dimensional values - akin to vsearch() for vectors.

$found   = vsearchvec($find, $which);
$nearest = $which->dice_axis(1,$found);

Returns for each row-vector in $find the index along dimension N of the least row vector of $which greater or equal to it. $which should be sorted in increasing order. If the value of $find is larger than any member of $which, the index to the last element of $which is returned.

See also: PDL::Primitive::vsearch().

EOD );

##====================================================================== ## Vector Sorting and Comparison ##====================================================================== pp_addpm(<<'EOPM');

Vector-Valued Sorting and Comparison

The following functions are provided for lexicographic sorting of vectors, rsp. axis indices. As of PDL::VectorValued v1.0.12, vv_qsortvec() and vv_qsortveci() are just deprecated aliases for the builtin PDL functions of the same names. Older versions of this module used a dedicated implementation as a workaround for a bug in PDL-2.4.3, which has long since been fixed.

vv_qsortvec

Signature: (a(n,m); [o]b(n,m))

Deprecated alias for PDL::Ufunc::qsortvec(), which see for details.

vv_qsortveci

Signature: (a(n,m); indx [o]ix(m))

Deprecated alias for PDL::Ufunc::qsortveci(), which see for details.

Vector-Valued Set Operations

The following functions are provided for set operations on sorted vector-valued PDLs.

Sorted Vector Set Operations

The following functions are provided for set operations on flat sorted PDLs with unique values. They may be more efficient to compute than the corresponding implementations via PDL::Primitive::setops().

Miscellaneous Vector-Valued Operations

ACKNOWLEDGEMENTS

  • Perl by Larry Wall

  • PDL by Karl Glazebrook, Tuomas J. Lukka, Christian Soeller, and others.

  • Code for rlevec() and rldvec() derived from the PDL builtin functions rle() and rld() in $PDL_SRC_ROOT/Basic/Slices/slices.pd

KNOWN BUGS

Probably many.

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT

  • Code for qsortvec() copyright (C) Tuomas J. Lukka 1997. Contributions by Christian Soeller (c.soeller@auckland.ac.nz) and Karl Glazebrook (kgb@aaoepp.aao.gov.au). All rights reserved. There is no warranty. You are allowed to redistribute this software / documentation under certain conditions. For details, see the file COPYING in the PDL distribution. If this file is separated from the PDL distribution, the copyright notice should be included in the file.

  • All other parts copyright (c) 2007-2022, Bryan Jurish. All rights reserved.

    This package is free software, and entirely without warranty. You may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

perl(1), PDL(3perl)