30:[] 2e:{"title":"MARGO framework","cells":[{"id":0,"value":"title","pinned":false,"hidden":false,"mode":"ojs"},{"id":7,"value":"md`---\n\n> This notebook defines the **MARGO API** as a reusable component.\n> \n> See [\\`@margo/plots\\`](https://observablehq.com/@margo/plots) for a demo!\n\n---`","pinned":false,"hidden":false,"mode":"ojs"},{"id":10,"value":"md`## Basic usage`","pinned":false,"hidden":false,"mode":"ojs"},{"id":11,"value":"md`We define our input parameters:`","pinned":false,"hidden":false,"mode":"ojs"},{"id":13,"value":"parameters = ({\n dt: 10,\n opt_parameters: {\n temp_goal: 2.0,\n temp_final: 2.0,\n max_deployment: {\n mitigate: 1,\n remove: 1,\n geoeng: 0,\n adapt: 0,\n }\n }\n })","pinned":false,"hidden":false,"mode":"ojs"},{"id":105,"value":"md`And we **get the optimized climate controls from the API**:`","pinned":false,"hidden":false,"mode":"ojs"},{"id":17,"value":"model = margo_client.sendreceive(\"opt_controls_temp\", parameters)","pinned":false,"hidden":false,"mode":"ojs"},{"id":23,"value":"md`_Try changing the parameters to see live updates!_`","pinned":false,"hidden":false,"mode":"ojs"},{"id":25,"value":"md`# How does it work?`","pinned":false,"hidden":false,"mode":"ojs"},{"id":27,"value":"md`A heroku server is running \\`ClimateMARGO.jl\\`, and a communication layer (based on \\`Pluto.jl\\`) makes Julia methods available in this JavaScript notebook.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":29,"value":"md`> The Julia + JS source code is available at [\\`fonsp/MargoAPI.jl\\`](https://github.com/fonsp/MargoAPI.jl).`","pinned":false,"hidden":false,"mode":"ojs"},{"id":31,"value":"md`**Here's a summary of the Julia code running on heroku**`","pinned":false,"hidden":false,"mode":"ojs"},{"id":33,"value":"julia`using ClimateMARGO\n\n# the main margo function\n# has only to parameters for now, but this will be _all parameters_ soon\n@expose function opt_controls_temp(;dt=20, opt_parameters)\n t = 2020.0:dt:2200.0\n model = ClimateModel(; t=collect(t), dt=step(t))\n\n optimize_controls!(model; opt_parameters...)\n\n return Dict(\n :model => model,\n :computed => extra_info(model)\n )\nend`","pinned":false,"hidden":false,"mode":"ojs"},{"id":35,"value":"md`**A summary of the JavaScript code running in your browser**`","pinned":false,"hidden":false,"mode":"ojs"},{"id":37,"value":"js`model = margo_client.sendreceive(\"opt_controls_temp\", {\n opt_parameters: {\n temp_goal: 2.0,\n },\n})`","pinned":false,"hidden":false,"mode":"ojs"},{"id":41,"value":"md`---\n\n# How to connect to the API:\n(It's public!)`","pinned":false,"hidden":false,"mode":"ojs"},{"id":42,"value":"md`**From another observable notebook:**`","pinned":false,"hidden":false,"mode":"ojs"},{"id":44,"value":"js`import { margo_client } from \"@olivier_plas/margo-web-api\" `","pinned":false,"hidden":false,"mode":"ojs"},{"id":46,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs"},{"id":48,"value":"margo_url = new URL(\"https://margo-api-test-1.herokuapp.com\")","pinned":true,"hidden":false,"mode":"ojs"},{"id":52,"value":"margo_url_ws = {\n const u = new URL(margo_url);\n u.protocol = u.protocol.replace(\"http\", \"ws\");\n return u;\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":54,"value":"md`import the API module for JS:`","pinned":false,"hidden":false,"mode":"ojs"},{"id":56,"value":"margo_api = import(new URL(\"/connection.mjs\", margo_url))","pinned":true,"hidden":false,"mode":"ojs"},{"id":58,"value":"md`open up a connection:`","pinned":false,"hidden":false,"mode":"ojs"},{"id":60,"value":"margo_client = margo_api.margo_client(margo_url_ws)","pinned":true,"hidden":false,"mode":"ojs"},{"id":62,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs"},{"id":64,"value":"md`### Syntax highlighting:`","pinned":false,"hidden":false,"mode":"ojs"},{"id":66,"value":"function julia(codes, ...fillers) {\n const formatted = hljs.highlight(\"Julia\", String.raw(codes, ...fillers))\n .value;\n return html`

${formatted}

`;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":68,"value":"function js(codes, ...fillers) {\n const formatted = hljs.highlight(\"Javascript\", String.raw(codes, ...fillers))\n .value;\n return html`

${formatted}

`;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":70,"value":"hljs = require('https://bundle.run/highlight.js@10.1.0')","pinned":false,"hidden":false,"mode":"ojs"},{"id":2,"value":"import {title} from \"@margo/introductions\"","pinned":true,"hidden":false,"mode":"ojs"}],"files":"$W30","stdlib":"1","titling":"auto"}