TUTORIALS(1)

📦 version 2.78.0, in epel 9

okay so bestie, welcome to TUTORIALS(1), from the User Contributed Perl Documentation shelf. This whole page is PDL::Tutorials — A guide to PDL's tutorial documentation — and I'm gonna give you the full tour, no skips, no “I’ll read it later” energy. 🫶

✨ NAME ✨

PDL::Tutorials — A guide to PDL's tutorial documentation.

🌈 MIGRATION 🌈

These are our migration guides for users familiar with other types of numerical analysis software. Periodt. 💅

🌸 PDL::MATLAB

Migration guide for MATLAB users. This page explains the key differences between MATLAB and PDL from the point of view of a MATLAB user.

🦋 PDL::Scilab

Migration guide for Scilab users. This page explains the key differences between Scilab and PDL from the point of view of a Scilab user.

🧚 FOUNDATION 🧚

💜 PDL::Philosophy

Why did we write PDL? This document explains some of the history and motivation behind the Perl Data Language. It is an attempt to answer the question "Why PDL?". Lowkey iconic origin-story vibes. 🎀

🎀 PDL::QuickStart

Quick introduction to PDL features. A hands-on guide suitable for complete beginners. This page assumes no previous knowledge of Perl or PDL. No cap: zero prerequisites, you can absolutely start here. 🌱

🌈 PDL::Indexing

After you have read the QuickStart guide, you should follow up with this document. This guide goes more deeply into the concepts of "indexing" and "slicing" and how they form the core of numerical analysis with PDL. It’s giving “level up” energy fr fr. 🔥

🔥 INTERMEDIATE 🔥

⭐ PDL::Broadcasting

Broadcasting is one of PDL's most powerful features. If you know MATLAB, you've heard of "vectorizing". Well, broadcasting is like "vectorizing on steroids". It lets you make very fast and compact code by avoiding nested loops. All vector-based languages do this, but PDL generalizes the technique to all sorts of applications.

This tutorial introduces PDL's broadcasting feature, and it shows an example implementing Conway's Game of Life in 10 lines and 80 times faster than a classical implementation. Not me being obsessed with the 10 lines and 80 times faster thing. 😭👑

🍓 PDL::BadValues

Sometimes it is useful to specify that a certain value is "bad" or "missing". Scientific instruments some times include portions of invalid data. For example, a CCD camera might produce an image with over-exposed pixels. PDL's "bad values" feature gives you an easy way to deal with this sort of imperfect data. Honestly? A vibe check for imperfect data. 💅

🧚 PDL::Tips

Tips and suggestions for using PDL. This page is an assorted collection of programming tidbits that some PDL users have found useful. Some of these tips might be of help when you write your programs. Little snack-sized help, iykyk. 🍓

👑 ADVANCED 👑

💀 PDL::PP

PDL's Pre-Processor is one of PDL's most powerful features. You write a function definition in special markup and the preprocessor generates real C code which can be compiled. With PDL:PP you get the full speed of native C code without having to deal with the full complexity of the C language. It’s giving “write markup, get C, feel powerful.” 🫶

🦋 PDL::API

A simple cookbook explaining how to create ndarray manually, either from Perl or from C/XS code. This page covers the PDL core routines that comprise the PDL API. If you need to access ndarrays from C/XS, this is the document for you. C/XS besties, this one’s your main character moment. 🌟

💜 PDL::Internals

Description of the inner workings of the PDL module. Very few people need to see this. This page is mainly for PDL developers, or people interested in debugging PDL or changing the internals of PDL. If you can read this document and understand all of it, and you additionally understand PDL::PP, you will be awarded the title of "PDL Guru". That’s not a drill, bestie — it’s the final boss title. 👑💀

Copyright 2010 Daniel Carrera (dcarrera@gmail.com). You can distribute and/or modify this document under the same terms as the current Perl license.

See: http://dev.perl.org/licenses/

mwah 💋 — that’s the whole page, bestie. This is TUTORIALS(1) from perl v5.32.1, dated 2022-04-11. Now go read the tutorials and slay. 💖✨

📦 where this page comes from