Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sritchie/programming-2022
Talks at the <Programming> 2022 Conference in Porto, Portugal
https://github.com/sritchie/programming-2022
clojure clojurescript physics sicmutils webgl
Last synced: 24 days ago
JSON representation
Talks at the <Programming> 2022 Conference in Porto, Portugal
- Host: GitHub
- URL: https://github.com/sritchie/programming-2022
- Owner: sritchie
- Created: 2022-03-03T14:32:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-03-30T18:48:43.000Z (over 2 years ago)
- Last Synced: 2024-05-01T23:18:58.175Z (6 months ago)
- Topics: clojure, clojurescript, physics, sicmutils, webgl
- Language: HTML
- Homepage:
- Size: 18.4 MB
- Stars: 11
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# `` 2022
Hello! Welcome to the repository for my (Sam Ritchie's) talks from the 2022
European Lisp Symposium and `` conferences.
> If you find this work interesting, please consider sponsoring it via [Github
> Sponsors](https://github.com/sponsors/sritchie). Thank you!
Here you'll find:
- More information about [SICMUtils][SICMUTILS] and the projects I discussed in
the talks
- Working versions of the demos
- The `org-re-reveal`-generated slides from the presentations.
## Links
- [SICMUtils repository][SICMUTILS]
- The [Road to Reality Newsletter](https://roadtoreality.substack.com/)
- [Road to Reality Discord
Server](https://roadtoreality.substack.com/p/road-to-reality-discord-server?s=w)
- [Clerk][CLERK], the notebook rendering engine used by SICMUtils
- [In-progress executable version](https://github.com/sicmutils/fdg-book) of
_Functional Differential Geometry_ ([book link][FDG])
- [In-progress executable version](https://github.com/sicmutils/sicm-book) of
Sussman and Wisdom's _Structure and Interpretation of Classical Mechanics_
([book link][SICM])
- [Mathbox](https://gitgud.io/unconed/mathbox) by @unconed
- [mathbox-react](https://github.com/ChristopherChudzicki/mathbox-react) by
@ChristopherChudzicki
## Demo Instructions
The demos include both Clojure and Clojurescript code. Two environments means
two build tools, so you'll need to have these installed:
- [clj](https://clojure.org/guides/getting_started), for running the JVM side
- [shadow-cljs](https://shadow-cljs.github.io/docs/UsersGuide.html#_installation)
for building the JS bundle used by the demos. This is a lovely system that
will automatically rebuild the bundle any time you save a cljs file.
- You'll also need [node.js](https://nodejs.org/en/download/package-manager/)
installed, to install the initial `npm` dependencies.
When those are all set (the links include installation instructions),
Clone the repository:
```bash
git clone [email protected]:sritchie/programming-2022.git
cd programming-2022
```
Generate the JS bundle for the demos by running the following commands in one
terminal window:
```bash
npm install
shadow-cljs watch sicm-browser
```
In another tab, start a Clojure repl with `clj`. This REPL has the full
[SICMUtils
API](https://cljdoc.org/d/sicmutils/sicmutils/CURRENT/api/sicmutils.env)
available, so run some tests for fun:
```clojure
(->infix (((exp D) (literal-function 'f)) 'x))
;;=> "f(x) + Df(x) + 1/2 D²f(x) + 1/6 D³f(x) + ..."
```
Next, start a webserver for Clerk, (the literate programming viewer) by running
the following commands:
```clojure
;; point Clerk at our newly-generated JS bundle instead of its default:
(swap! clerk-config/!resource->url
assoc
"/js/viewer.js"
"http://localhost:9000/out/main.js")
;; Start the clerk server.
(clerk/serve!
{:browse? true :port 7777})
```
Now run `(clerk/show! )` to run any of the demos. Some
examples to try:
```clojure
;; intro:
(clerk/show! "src/demo.clj")
;; Mathbox basics:
(clerk/show! "src/cube_controls.clj")
;; functions:
(clerk/show! "src/functions.clj")
(clerk/show! "src/polar.clj")
;; symbolic physics:
(clerk/show! "src/einstein.clj")
;; vega, symbolic, double-pendulum
(clerk/show! "src/pendulum.clj")
;; mathbox physics:
(clerk/show! "src/oscillator.clj")
(clerk/show! "src/ellipsoid.clj")
(clerk/show! "src/double_ellipsoid.clj")
;; browser/client comms:
(clerk/show! "src/live_oscillator.clj")
```
> NOTE: Clojure is far more pleasant if you can get a REPL running from inside
> of your favorite code editor. I'll update this repo with links to a good
> "Getting Started" resource; but please open an issue if you're having trouble
> and I'll get you sorted.
If you're running a REPL from inside your editor, see the [Clerk
homepage](https://github.com/nextjournal/clerk#editor-workflow) for instructions
on how to trigger `clerk-show!` with a key command, making dynamic interaction
much more fun.
## Presentations
The presentations themselves live in `presentations/org/*.html`. see
`presentations/README.md` for more detail on how to:
- build these `html` files from their associated `org` files
- generate slides by executing Clojure code
- Serve these presentations in presenter mode
Enjoy!
[CLERK]: https://github.com/nextjournal/clerk
[SICMUTILS]: https://github.com/sicmutils/sicmutils
[SICM]: http://mitpress.mit.edu/books/structure-and-interpretation-classical-mechanics
[FDG]: http://mitpress.mit.edu/books/functional-differential-geometry