28:null 29:["$","title",null,{"children":"MARGO framework | MARGO Climate framework | Observable"}] 2e:[] 2c:{"id":"678b392146279fab","slug":"api","title":"MARGO framework","thumbnail":"97d87928c31eea7a302582b91892055598deacd6ac2e3601f9e89360299cea77","access_level":"public","create_time":"$D2020-08-07T14:56:08.832Z","update_time":"$D2020-08-18T12:35:49.919Z","view_time":null,"first_public_time":"$D2020-08-07T15:03:59.618Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"d50c1b9be1f36075","login":"margo","name":"MARGO Climate framework","avatar_url":"https://avatars-next.observableusercontent.com/8b992c689b5bb260e9385dac0fab6d33f5989a7d6e9db4a92a7b583d85e915b9","tier":"starter_2024"},"version":107,"publish_version":107,"role":null,"authored":false,"authors":[{"type":"individual","id":"6aca374b28a4bb6d","login":"olivier_plas_123456","name":"","avatar_url":null,"tier":null}],"members":[{"type":"team","id":"d50c1b9be1f36075","login":"margo","name":"MARGO Climate framework","avatar_url":"https://avatars-next.observableusercontent.com/8b992c689b5bb260e9385dac0fab6d33f5989a7d6e9db4a92a7b583d85e915b9","tier":"starter_2024","role":"editor"}],"comments":[{"id":"fec6c4f950bfe47b","reply_to_id":null,"content":"Hi! This seems to be broken, although the API is online.\nAny ideas why websocket appears to close before a response is received? (see console messages)\n\nThe testing page works: https://margo-api-test-1.herokuapp.com/index.html\nI've also tried a local MargoAPI instance, but I get the same results when I try to plug it into these notebooks.","create_time":"$D2022-01-08T14:00:34.787Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"fca367047a53a31f","login":"declann","name":"Declan Naughton","avatar_url":"https://avatars-next.observableusercontent.com/b36edfd0f90184ac4c0a8d8726969fe861a1d1fe9417e998413c8a47e6163983","tier":null}}],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":null,"type":"notebook","body":{"title":"MARGO framework","cells":[{"id":0,"value":"title","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":10,"value":"md`## Basic usage`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":11,"value":"md`We define our input parameters:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":105,"value":"md`And we **get the optimized climate controls from the API**:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"model = margo_client.sendreceive(\"opt_controls_temp\", parameters)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":23,"value":"md`_Try changing the parameters to see live updates!_`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"md`# How does it work?`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":31,"value":"md`**Here's a summary of the Julia code running on heroku**`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":35,"value":"md`**A summary of the JavaScript code running in your browser**`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":41,"value":"md`---\n\n# How to connect to the API:\n(It's public!)`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":42,"value":"md`**From another observable notebook:**`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":44,"value":"js`import { margo_client } from \"@olivier_plas/margo-web-api\" `","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":46,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":48,"value":"margo_url = new URL(\"https://margo-api-test-1.herokuapp.com\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":54,"value":"md`import the API module for JS:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":56,"value":"margo_api = import(new URL(\"/connection.mjs\", margo_url))","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":58,"value":"md`open up a connection:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":60,"value":"margo_client = margo_api.margo_client(margo_url_ws)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":62,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":64,"value":"md`### Syntax highlighting:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"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","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":70,"value":"hljs = require('https://bundle.run/highlight.js@10.1.0')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":2,"value":"import {title} from \"@margo/introductions\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W2e","stdlib":"1","titling":"auto"}} 2d:"$2c:body"