Alien::Gnuplot(3pm)

✨ Alien::Gnuplot ✨

okay bestie, buckle UP 💖 this is the Perl module page for Alien::Gnuplot (that's the Alien::Gnuplot(3pm) situation), and its whole personality is: go find the gnuplot executable, poke it, make sure it's actually alive and functional. no cap.

---

🌸 NAME 🌸

Alien::Gnuplot — bestie's job is to find the gnuplot executable and verify it actually works. 🦋

---

💅 SYNOPSIS 💅

package MyGnuplotter;

use strict;

use Alien::Gnuplot;

$gnuplot = $Alien::Gnuplot::executable;

`$gnuplot < /tmp/plotfile`;

1;

look at her go 🫶

---

👑 DESCRIPTION 👑

So like. Alien::Gnuplot verifies that the external gnuplot application exists and is sane. that's the whole vibe check.

It declares exactly one access method, Alien::Gnuplot::load_gnuplot, and that one does all the actual work — it gets called automatically at load time, so you don't even have to ask. and to be super clear: Alien::Gnuplot does not have any actual plotting methods. finding and verifying gnuplot is the entire job. what you do with it after is between you and your client module. periodt. 💅

Using Alien::Gnuplot checks for the existence of the executable, verifies that it runs properly, and sets several global variables describing the gnuplot it found. iconic behavior, fr fr:

• $Alien::Gnuplot::executable — the path to the gnuplot executable. 📍
• $Alien::Gnuplot::version — the self-reported version number of the executable. 🔢
• $Alien::Gnuplot::pl — the self-reported patch level. 🩹
• @Alien::Gnuplot::terms — a list of the names of all supported terminal devices. 🖥️
• %Alien::Gnuplot::terms — a key for each supported terminal device; the values are the 1-line description straight from gnuplot. this one is so useful for testing whether a particular terminal is supported. ✅
• @Alien::Gnuplot::colors — a list of the names of all named colors this particular gnuplot recognizes. 🌈
• %Alien::Gnuplot::colors — a key for each named color, values are the "#RRGGBB" form of the color. perfect for decoding colors, or for checking whether a particular color name is recognized. also: all the color names are lowercase alphanumeric, no surprises. 🎀

---

You can point Alien::Gnuplot at a specific path for gnuplot by setting the environment variable GNUPLOT_BINARY to that path. if you don't, your path gets searched for the executable file (using File::Spec, the way it's done around here). 🧚

If there's no executable application in your path and nothing at the location GNUPLOT_BINARY points to? the module throws an exception. rude but fair. 💀

You can also double-check that it didn't complete successfully by looking at $Alien::Gnuplot::version — it's undef on failure, and it holds the gnuplot version string on success. lowkey the easiest check in the world.

If you think the global state of the gnuplot executable might have changed, you've got options: either reload the module, or explicitly call Alien::Gnuplot::load_gnuplot() to force a fresh inspection of the executable. main character energy, take control. ✨

---

🛠️ INSTALLATION STRATEGY 🛠️

When you install Alien::Gnuplot, it checks that gnuplot itself is installed too — because obviously. if it's not there, Alien::Gnuplot tries to use one of several common package managers to install gnuplot for you. bestie's got your back.

But if it can't find any of those package managers, it dies (and flat-out refuses to install), printing a friendly message about how to get gnuplot before throwing the error. so you at least know what went wrong. 🫶

In principle, gnuplot could be automagically downloaded and built — in principle — but it's distributed via Sourceforge, which obfuscates interior links, and that makes such tools surprisingly difficult to write. it's giving "we tried, okay?" 😭

---

🌈 CROSS-PLATFORM BEHAVIOR 🌈

On POSIX systems — Linux and MacOS included — Alien::Gnuplot uses fork/exec to invoke the gnuplot executable and asynchronously monitor it for hangs. very cunty of it, very robust. 💅

Microsoft Windows process control is more difficult, though. so if $^O contains MSWin32, a simpler system call is used instead — and that one is riskier, because it involves waiting for the unknown executable to complete. don't say we didn't warn you. ⚠️

---

🔗 REPOSITORIES 🔗

• Gnuplot's main home page lives at https://gnuplot.sourceforge.net/. 🏠
• Alien::Gnuplot development happens at https://github.com/drzowie/Alien-Gnuplot. 🌱
• A major client module for Alien::Gnuplot is PDL::Graphics::Gnuplot, which you can find at https://github.com/PDLPorters/PDL-Graphics-Gnuplot. and PDL itself is at https://pdl.perl.org/. 💜

---

✍️ AUTHOR ✍️

Craig DeForest <craig@deforest.org>

(with special thanks to Chris Marshall, Juergen Mueck, and Sisyphus for testing and debugging on the Microsoft platform 🫡)

---

📜 COPYRIGHT AND LICENSE 📜

Copyright (C) 2013 Craig DeForest

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, honestly. 💖

---

okay that's the whole page bestie, go forth and plot 🌸🎀🦋

this gorgeous little writeup is from perl v5.42.3, dated 2026-08-21, and it's the Alien::Gnuplot(3pm) page — mwah 💋