Skip to main content

codeplot is a canvas designed for code-driven data exploration where you can plot graphs, data frames, markdown and much more using plain Python

Project description

codeplot-readme


codeplot is a dynamic spatial canvas for data exploration, offering an interactive environment for graphing and visualizing data with Python.

Created by @antl3x, read more about its inception.

Video Demo

Watch the video

Why Choose codeplot?

  • Dynamic Visualization: Break free from static images and rigid layouts. codeplot brings your data to life on an interactive canvas.

  • Easy Integration: Directly plot from your Python code or REPL into your canvas at codeplot.co.

  • Varied Visualizations: From basic charts to advanced widgets, codeplot supports a wide range of data representations.

  • Flexible Layouts: Arrange your visualizations to suit your workflow, with draggable and movable plots.

  • Open to Everyone: Designed for data scientists and enthusiasts alike, codeplot aims to enhance your data exploration experience.

Getting Started (IPython Extension)

To use codeplot in a IPython Notebook like Jupyter, Google Colab, etc, you can install the IPython Extension using pip:

pip install codeplot-ipython

After install you can load the extension and connect to a new room:

%load_ext codeplot-ipython
%cP_connect ws://your-ws-url/your-room-id

Now the output of your cells will be automatically plotted in the codeplot canvas! So you don't need to use the cP.plot function.

Thats all!

Getting Started (Python SDK)

If you want to use codeplot in a Python script, and have a more "fine-grained" control over the plots, you can use the Python SDK.

To get started with codeplot, you can install the package using pip:

pip install codeplot

Once installed, you can start using codeplot by importing the package and connectig to a new room:

import asyncio
import codeplot

async def main():
    cP = await codeplot.connect("ws://your-ws-url/your-room-id")

    # Now you can start plotting
    await cP.plot(df.describe())
    await cP.plot(df.head(10))
    await cP.plot(df)

asyncio.run(main())

You can use the public codeplot client & server to start plotting right away:

  1. Join the codeplot room at codeplot.co
  2. Use the room id to connect to the room using the code above

If you want to use codeplot in a Jupyter Notebook, you can use the following code:

import codeplot
cP = await codeplot.connect("ws://your-ws-url/your-room-id")

# Now you can start plotting
await cP.plot(df.describe())
await cP.plot(df.head(10))
await cP.plot(df)

Run Codeplot on Docker

Instead of using the public codeplot server, you can self-host and run codeplot on your local machine using Docker. To do so, you can use the following command:

curl -s https://raw.githubusercontent.com/codeplot-co/codeplot/master/minirepos/@codeplot-docker/docker-compose.yaml | docker-compose -f - up

Or if you are using docker-compose v2, you can use the following command instead

curl -s https://raw.githubusercontent.com/codeplot-co/codeplot/master/minirepos/@codeplot-docker/docker-compose.yaml | docker compose -f - up

This will start a codeplot server and a client on your local machine, and you can access it at:

Join the codeplot Community

Become part of a forward-thinking community dedicated to advancing data visualization. Connect, engage, and grow with peers on Discord. With codeplot, data visualization is a shared journey. Let's explore new insights together!

License and Pricing

Codeplot is crafted to support a wide range of users, from individuals exploring their personal projects to enterprises seeking to enhance their business processes. To accommodate this diversity, Codeplot adopts a dual-license approach.

Codeplot is free to use for personal and non-commercial purposes.

Only pay if you use Codeplot commercially.

Read more about License and Pricing here.

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

codeplot-0.4.3.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

codeplot-0.4.3-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file codeplot-0.4.3.tar.gz.

File metadata

  • Download URL: codeplot-0.4.3.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for codeplot-0.4.3.tar.gz
Algorithm Hash digest
SHA256 095bb3bf7c584a903b50019023faa9a810afca4b815b2bd0786c25b624af2e34
MD5 c17c31cc5bd9a32c27828ac5e3e61ac7
BLAKE2b-256 087c2690d446730a499f81993b764d144cf6e77a6b4016faf3296a694c2a2b40

See more details on using hashes here.

File details

Details for the file codeplot-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: codeplot-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 6.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for codeplot-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 96d85c47f7228b9c7cf28d39e32dc5b4cc14c9e6d654390a65afc63b4247f5fc
MD5 fefb256126f925ba674ea5510b80eb60
BLAKE2b-256 1f787901c56a1a8c0eec1a98f568503dafec951a00a2cc6b2e1d50635af315d1

See more details on using hashes here.

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