ngrams(3pm)

💖 ngrams 💖

okay bestie, welcome to the ngrams(3pm) page — it's one of the user-contributed Perl docs, and it's giving "small script, big brain" energy fr fr. Let's get into it ✨

---

🌸 NAME 🌸

ngrams — Compute the ngram frequencies and produce tables to the stdout. yes, stdout, that's the whole vibe 💅

---

🎀 SYNOPIS 🎀

(bestie the heading typo is canon, we don't fix it, we respect it 🙈)

  ngram [--version] [--help] [--n=3] [--normalize] [--type=TYPE]
        [--orderby=ORD] [--onlyfirst=N] [input files]

---

💅 DESCRIPTION 💅

This script produces n-grams tables of the input files to the standard output. that's it, that's the job, and it does it iconically 👑

🍓 Options:

• --normalize — Prints normalized n-gram frequencies; i.e., the n-gram counts divided by the total number of n-grams of the same size. so instead of raw counts you get the ✨proportions✨
• --onlyfirst=NUMBER — Prints only the first NUMBER n-grams for each n. See Text::Ngrams module. when you want a lil taste, not the whole meal 🍽️
• --limit=NUMBER — Limit the total number of distinct n-grams (for efficiency reasons, the counts may not be correct at the end). heads up bestie — efficiency mode means the numbers might be lowkey off at the finish line, that's a documented thing, not a bug you found 💀
• --version — Prints version. short king behavior, love that
• --help — Prints help. the classic, the legend 🫶
• --n=NUMBER — N-gram size, produces 3-grams by default. 3 is the default, so if you say nothing you're getting trigrams, no cap
• --orderby=frequency|ngram — The n-gram order. See Text::Ngrams module. pick your sorting slay: frequency or ngram
• --type=character|byte|word|utf8 — Type of n-grams produces. See Text::Ngrams module. your options are character, byte, word, or utf8 — pick your fighter 🌈

---

🦋 PREREQUISITES 🦋

• Text::Ngrams
• Getopt::Long

gotta have both, bestie, no shortcuts 💖

---

🌈 SCRIPT CATEGORIES 🌈

Text::Statistics

that's the category it lives under, cute right ✨

---

📖 README 📖

N-gram analysis for various kinds of n-grams (character, words, bytes, utf8, and user-defined). Based on Text::Ngrams module. user-defined?? obsessed. the range. the versatility. 👑

---

🔥 SEE ALSO 🔥

Text::Ngrams module.

go read it, it's where all the real details live iykyk 💜

---

💀 COPYRIGHT 💀

Copyright 2003-2017 Vlado Keselj http://web.cs.dal.ca/~vlado

This module is provided "as is" without expressed or implied warranty. This is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The latest version can be found at http://web.cs.dal.ca/~vlado/srcperl/.

real talk though: "as is", no warranty, expressed or implied — that's the actual legal vibe, don't come for anybody if it goes sideways 🙈

---

and that's the whole page bestie!! this one's brought to you by perl v5.34.0, dated 2022-06-28 — shoutout to the version and the date, they ate 💅✨ mwah, go compute some n-grams 🦋💖