Math::Symbolic::Custom::Simplification - User defined simplification routines
package Math::Symbolic::Custom::MySimplification; use base 'Math::Symbolic::Custom::Simplification'; sub simplify { my $tree = shift; # ... simplify tree ... return $simplified; } 1; # Then, in another portion of your code. Math::Symbolic::Custom::MySimplification->register(); # Code that uses MySimplification: # $tree->simplify() invokes # Math::Symbolic::Custom::MySimplification::simplify($tree). Math::Symbolic::Custom::MySimplification->unregister(); # Code that uses the default simplification routines or whichever # simplification routines where registered before.
This module is an extension to the Math::Symbolic module. A basic familiarity with that module is required.
Math::Symbolic offers some builtin simplification routines. These, however, are not capable of complex simplifications. This extension offers facilities to override the default simplification routines through means of subclassing this module. A subclass of this module is required to define a simplify object method that implements a simplification of Math::Symbolic trees.
simplify
There are two class methods to inherit: register and unregister. Calling the register method on your subclass registers your class as providing the simplify method that is invoked whenever simplify() is called on a Math::Symbolic::Operator object.
register
simplify()
Calling unregister on your subclass restores whichever simplification routines where in place before.
unregister
Several subsequent register() and c<unregister()> calls on different subclasses can be used to localize simplification routines. The old routines are saved to a stack.
register()
If there are several subclasses of this module, say MySimplification and MyOtherSimplification, calling MySimplification-register()>, then MyOtherSimplification-register()> will finally provide the simplification routines of MyOtherSimplification. Unregistering MyOtherSimplification revert to the routine from MySimplification.
MySimplification
MyOtherSimplification
MySimplification-
MyOtherSimplification-
If you unregister out of order (i.e. in the above example if you unregistered MySimplification instead of MyOtherSimplification), all simplification routines up to and including the one you're unregistering are removed and the one that was in effect before MySimplification (here: the default simplify()) is restored.
This module does not export anything.
A class method to register the simplify() subroutine of the class as the new Math::Symbolic simplification rotuine.
A class method to unregister the aformentioned simplification routine.
New versions of this module can be found on http://steffen-mueller.net or CPAN.
Math::Symbolic
Math::Symbolic::Operator which contains the default simplification routines.
Math::Symbolic::Custom and Math::Symbolic::Custom::Base for details on enhancing Math::Symbolic.
Steffen Müller, <symbolic-module at steffen-mueller dot net<gt>
Copyright (C) 2005 by Steffen Müller
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.
1 POD Error
The following errors were encountered while parsing the POD:
Non-ASCII character seen before =encoding in 'Müller,'. Assuming CP1252
To install Math::Symbolic::Custom::Simplification, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Math::Symbolic::Custom::Simplification
CPAN shell
perl -MCPAN -e shell install Math::Symbolic::Custom::Simplification
For more information on module installation, please visit the detailed CPAN module installation guide.