Skip to main content

An easy-to-use Python to Desmos graph HTML compiler via the Desmos API (with OEIS support).

Project description

We'll keep it simple. Desmos is one of the best online calculators. Python is one of the best programming languages. So why no Python API? Who knows. What we do know is that PyDesmos is the next best thing.

We've made it as easy as possible to interact with Desmos from python:

from PyDesmos import Graph
with Graph('my graph') as G:
    f, x = G.f, G.x
    f[x] = x ** 2

With just these four lines: an HTML file called "my graph.html" containing a Desmos graph with the expression "f(x)=x^2" already written, is compiled and then automatically opened in your favorite browser!

Magic? Yes. But that's not all. We've pushed Python's syntax to its limits to make your experience as simple as possible. Our flexible code incidentally allows many alternatives to f[x] = x ** 2, depending on your style / needs:

G.append('f(x)=x^2')
G.define('f(x)', x ** 2)  # 'f(x)' is also equivalent to f(x) (yes, without quotes)
G.eq(f(x), x ** 2)
G(f(x), '=', x ** 2)
G(f(x), x ** 2)
G[f(x)] = x ** 2

Many more things are made easy. For example, plotting tables:

G.new_table({x: [0, 1, 2], y: [2, 3, 5]})  # where x, y = G.x, G.y, OR
G(x=[0, 1, 2], y=[2, 3, 5])

Plotting python functions:

f = lambda x: int(str(x)[::-1])
G.plot_function(f, 0, 100)  # OR
G(f, min=0, max=100)

Since Desmos uses latex to generate expressions, all latex-friendly sympy expressions get automatically converted.

import sympy as sp
with Graph('my graph') as G:
    x, y = G.x, G.y
    G.le(sp.factorial(x + y), sp.sin(x - y))  # appends the expression "(x+y)! <= sin(x-y)"

Sliders and greek letter support:

G(alpha=0, min=0, max=2 * G.pi, step=G.pi / 2)  # appends the constant "α=0" with respective bounds

Yet another way to append expressions:

G | sympy.sin(2 * G.x)  # appends the expression "sin(2x)"

Points:

G(p=(0,0))  # appends the point "p=(0,0)"

Prime-notation:

G | (f^1)(x)  # appends the expression "f'(x)", where f, x = G.f, x.f

Subscript notation:

G(c[0], 42)  # appends the expression "c_{0}=42", where c = G.c

...

Alright, I'm sure you get it. PyDesmos is awesome. But one last thing. All of these methods have additional (optional) kwargs for absolute customization, such as color, line thickness, etc. You may read about them here, under "expression_state Name and Values". For example,

G(y=G.x ** 2, color='#FF0000')  # appends the expression "y=x^2" with color #FF0000.

Happy PyDesmos-ing!


New: To plot a sequence from the OEIS:

G.plot_oeis('A000001')  # optional max_terms parameter

Or to just get a dictionary:

A000001 = oeis('A000001')  # {0: 0, 1: 1, ...}

Change Log

0.0.1 (12/04/2023)

  • First Release

0.1.0 (12/04/2023)

  • Entered Alpha
  • Major code revisions
  • improved README.md

0.1.1 (13/04/2023)

  • Minor tweaks (mostly to README.md)
  • Fixed optional kwargs with tables

0.1.2 (13/04/2023)

  • Added simple OEIS integration
  • Added support for all greek letters

Project details


Download files

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

Source Distribution

PyDesmos-0.1.2.tar.gz (13.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page