Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A simple Markov chain modeller and generator for word and sentence generation.

Project Description

Originally a proof of concept, I’ve used this in enough projects that I’ve decided to publish it tomake it easier to import. The name is a play on words similar to Markup/Markdown. Hey, I’m funny sometimes,

Basic Use

Use the included from_sentences() and from_words() if your data already behaves nicely. These methods return a Markov object which is the workhorse of this whole thing. Your input sequences of words or sentences should be delimited by newlines. Use next_word() and next_sentence() to generate your desired forat of output.

Advanced Use

Instantiate with m = markoff.Markov(seeds) where seeds is an iterable of sub-iterables. That could be a list of lists of words or letters if you want to emulate the functionality of from_sentences() and from_words(). Each sub-iterable being a chain in the set of chains you want to model.

You can supply it with just one chain or many.

Then use m.generate(max_length=100) to produce a single chain limited to max_length automatically terminating at known ending state (usually a word ending with punctuation).

Examples

Don’t forget to begin with import pymarkoff ## Generating Sentences ##

Input

m = pymarkoff.from_sentences(
"""The quick brown fox jumped over the lazy dog.
Jack and Jill ran up the hill to fetch a pail of water.
Whenever the black fox jumped the squirrel gazed suspiciously."""
)

print([m.next_sentence() for i in range(10)])

Output

[
    'The quick brown fox jumped over the black fox jumped the lazy dog.',
    'The quick brown fox jumped the squirrel gazed suspiciously.',
    'Whenever the squirrel gazed suspiciously.',
    'Jack and Jill ran up the lazy dog.',
    'Jack and Jill ran up the hill to fetch a pail of water.',
    'Jack and Jill ran up the black fox jumped the hill to fetch a pail of water.',
    'Whenever the lazy dog.',
    'The quick brown fox jumped over the lazy dog.',
    'Jack and Jill ran up the hill to fetch a pail of water.',
    'Jack and Jill ran up the squirrel gazed suspiciously.'
 ]

Generating Words

Input

seeds = """Ana
Bastion
D.Va
Genji
Hanzo
Junkrat
Lúcio
McCree
Mei
Mercy
Pharah
Reaper
Reinhardt
Roadhog
Soldier: 76
Symmetra
Torbjörn
Tracer
Widowmaker
Winston
Zarya
Zenyatta"""

brain = pymarkoff.from_words(mystr)
print([brain.next_word() for i in range(10)])

Output

['Zen', 'D.Vaperein', 'Za', 'To', 'Merya', 'Metrdo', 'So', 'Junjör', 'Ph', 'Mera']

More advanced use

The Markov.feed() method can be used to add more data into the model of a Markov object. This lets you add sentences or words one at a time, if you want.

Notes

This module is still under development and is mostly for me to play around with and learn Markov Chains. Cheers.

Release History

Release History

This version
History Node

0.4.6

History Node

0.4.5

History Node

0.4.4

History Node

0.4.3

History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pymarkoff-0.4.6.tar.gz (6.2 kB) Copy SHA256 Checksum SHA256 Source Nov 18, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting