Skip to content

🎈 Simple reactive notebooks for Julia

License

Notifications You must be signed in to change notification settings

code-relay-io/Pluto.jl

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Task #1

fonsp#1001 Remember your job is to make incremental progress, break the task into smaller tasks, or finish something in 15 minutes, then pass it along to the next contributor. No responsibility, only fun.

If you don't finish, add your next task to the readme.md. Oh and when you're done make a pull request to the this repo.

Email with questions

PlutoCon 2021 β€” April 8th-9th

To celebrate Pluto's 1 year anniversary, we are hosting a two day mini conference about.... Pluto! It will be a place to share your fun notebooks and to learn techniques from other Pluto users and from Pluto's designers. You can give a talk!



🎈 Pluto presentation (20 min) at Juliacon 2020 🎈



Pluto.jl

Writing a notebook is not just about writing the final document β€” Pluto empowers the experiments and discoveries that are essential to getting there.

Explore models and share results in a notebook that is

  • reactive - when changing a function or variable, Pluto automatically updates all affected cells.
  • lightweight - Pluto is written in pure Julia and is easy to install.
  • simple - no hidden workspace state; friendly UI.

reactivity screencap

🎈 Pluto demo inside your browser 🎈

Input

A Pluto notebook is made up of small blocks of Julia code (cells) and together they form a reactive notebook. When you change a variable, Pluto automatically re-runs the cells that refer to it. Cells can even be placed in arbitrary order - intelligent syntax analysis figures out the dependencies between them and takes care of execution.

Cells can contain arbitrary Julia code, and you can use external libraries. There are no code rewrites or wrappers, Pluto just looks at your code once before evaluation.

Output

Your notebooks are saved as pure Julia files (sample), which you can then import as if you had been programming in a regular editor all along. You can also export your notebook with cell outputs as attractive HTML and PDF documents. By reordering cells and hiding code, you have full control over how you tell your story.


Dynamic environment

Pluto offers an environment where changed code takes effect instantly and where deleted code leaves no trace. Unlike Jupyter or Matlab, there is no mutable workspace, but rather, an important guarantee:

At any instant, the program state is completely described by the code you see.
No hidden state, no hidden bugs.

Interactivity

Your programming environment becomes interactive by splitting your code into multiple cells! Changing one cell instantly shows effects on all other cells, giving you a fast and fun way to experiment with your model.

In the example below, changing the parameter A and running the first cell will directly re-evaluate the second cell and display the new plot.

plotting screencap


HTML interaction

Lastly, here's one more feature: Pluto notebooks have a @bind macro to create a live bond between an HTML object and a Julia variable. Combined with reactivity, this is a very powerful tool!

@bind macro screencap

notebook from vdplasthijs/julia_sir


You don't need to know HTML to use it! The PlutoUI package contains basic inputs like sliders and buttons.

But for those who want to dive deeper - you can use HTML, JavaScript and CSS to write your own widgets! Custom update events can be fired by dispatching a new CustomEvent("input"), making it compatible with the viewof operator of observablehq. Have a look at the sample notebooks inside Pluto to learn more!




Let's do it!

Ingredients

For one tasty notebook πŸ₯ž you will need:

  • Julia v1.0 or above, v1.5 is fastest
  • Linux, macOS or Windows, Linux and macOS will work best
  • Mozilla Firefox or Google Chrome, be sure to get the latest version

Installation

🎈 How to install Julia & Pluto (6 min) 🎈

Run Julia and add the package:

julia> ]
(v1.5) pkg> add Pluto

Using the package manager for the first time can take up to 15 minutes - hang in there!

To run the notebook server:

julia> import Pluto
julia> Pluto.run()

Pluto will open in your browser, and you can get started!

Questions? Have a look at the FAQ.


Interested in learning Julia, Pluto and applied mathematics? Join the open MIT course taught by Alan Edelman, David P. Sanders & Grant Sanderson (3blue1brown) (and a bit of me): Introduction to Computational Thinking, Spring 2021.


To developers

Follow these instructions to start working on the package.

License

Pluto.jl is open source! Specifically, it is MIT Licensed. The included sample notebooks have a more permissive license: the Unlicense. This means that you can use sample notebook code however you like - you do not need to credit us!

Pluto.jl is built by gluing together open source software:

Your notebook files are yours, you do not need to credit us. Have fun!

From the authors

The Pluto project is an ambition to rethink what a programming environment should be. We believe that scientific computing can be a lot simpler and more accessible. If you feel the same, give Pluto a try! We would love to hear what you think. 😊

You can chat with us

feedback screencap

Questions? Have a look at the FAQ.

Sponsors

Development of Pluto.jl is partially sponsored by

MIT logo The free online course Introduction to Computational Thinking at MIT uses Pluto notebooks to teach scientific computing in a new way. Homeworks react to the student in realtime, with live answer checks and visualizations while you solve problems.
QuEra logo QuEra Computing uses a Pluto notebook as an online dashboard to control their quantum computer!
Julia Computing logo JuliaHub by Julia Computing enables the creation and editing of Pluto notebooks on the cloud!
NumFOCUS logo The mission of NumFOCUS is to promote open practices in research, data, and scientific computing by serving as a fiscal sponsor for open source projects and organizing community-driven educational programs.

Created by Fons van der Plas and MikoΕ‚aj Bochenski. Inspired by Observable.

About

🎈 Simple reactive notebooks for Julia

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Julia 55.0%
  • JavaScript 35.2%
  • CSS 8.1%
  • HTML 1.7%