Math::...ultMods(3pm)

🎀 NAME 🎀

Math::Symbolic::Custom::DefaultMods — the default Math::Symbolic transformations, bestie. That's the whole vibe.

---

✨ SYNOPSIS ✨

use Math::Symbolic;

That's it. That's the whole synopsis. Iconic, honestly. 💅

---

💖 DESCRIPTION 💖

Okay so this is a class of default transformations for Math::Symbolic trees. Think of it as the glow-up station for your expression trees. 🦋

And like, its sibling? Math::Symbolic::Custom::DefaultTests — that one defines the default tree testing routines. Different job, same family.

Wanna know how the whole custom method delegation model actually works under the hood? Go read Math::Symbolic::Custom and Math::Symbolic::Custom::Base. Do it. It's giving "required reading." 📚

🌸 EXPORT 🌸

Go check the docs for Math::Symbolic::Custom::Base for the deets, but real talk: do not try to use the standard Exporter semantics with this class. Not the move. 🚫 No cap.

---

👑 SUBROUTINES 👑

🧚 apply_derivatives()

Never modifies the tree in-place — it hands you back a modified copy of the original tree instead. Don't come for the original, she's fine. 💅

• Applied to variables and constants? This method just clones. Nothing fancy. 🍓
• Applied to operators, and if the operator is a derivative: it applies the derivative to the derivative's first operand.
• Regardless of what kind of operator this is called on, apply_derivatives gets applied recursively on its operands. Down the whole tree, bestie. 🌈

If the first parameter to this function is an integer, then at maximum that number of derivatives are applied — from the top down the tree, if possible. ✨

🎀 apply_constant_fold()

Does not modify the tree in-place by default — it returns a modified copy of the original tree instead. But okay here's the twist:

• If the first argument is true, the tree will not be cloned.
• If it's false or just straight up not there (non-existant), the tree will be cloned. 🙈

Applied to variables and constants: this method just clones.

Applied to operators: every tree segment that contains nothing but constants and operators gets swapped out for Constant objects. Glow-up complete. ⭐

💜 mod_add_constant

Give it a constant (an object or a number) as the argument, and this method tries hard to fold it into an existing constant — but only if the object it's called on is already a sum or a difference. 💪

Basically, it's the same as $tree + $constant, except it does some simplification along the way. Same energy, less mess. ✨

🌸 mod_multiply_constant

Give it a constant (an object or a number) as the argument, and this method tries hard to fold it into an existing constant — but only if the object it's called on is already a product or a division. 🔥

Basically, it's the same as $tree * $constant, except it does some simplification. Periodt.

---

💖 AUTHOR 💖

Okay so listen: send your feedback, your bug reports, and your support requests to the Math::Symbolic support mailing list:

math-symbolic-support at lists dot sourceforge dot net

And please consider letting them know how you use Math::Symbolic. They genuinely wanna hear it. Thank you!! 🫶

Wanna help with development or extend the module's functionality? Then hit up the developers' mailing list:

math-symbolic-develop at lists dot sourceforge dot net

List of contributors:

Steffen Müller, symbolic-module at steffen-mueller dot net
Stray Toaster, mwk at users dot sourceforge dot net
Oliver Ebenhöh

---

🌈 SEE ALSO 🌈

New versions of this module can be found at http://steffen-mueller.net or on CPAN. Module development happens on Sourceforge at http://sourceforge.net/projects/math-symbolic/ — go peek, iykyk. 👀

• Math::Symbolic::Custom
• Math::Symbolic::Custom::DefaultDumpers
• Math::Symbolic::Custom::DefaultTests
• Math::Symbolic

---

k bye bestie!! this whole thing came to you via perl v5.40.0, dated 2024-09-16 💖✨🎀 take care of your trees, mwah 💋