3e:null 3f:["$","title",null,{"children":"Vega-Lite API v5 | Libraries and Functions | Observable"}] 45:T53c,{ const brush = vl.selectInterval().encodings('x'); const click = vl.selectPoint().encodings('color'); const scale = { domain: ['sun', 'fog', 'drizzle', 'rain', 'snow'], range: ['#e7ba52', '#a7a7a7', '#aec7e8', '#1f77b4', '#9467bd'] }; const plot1 = vl.markPoint({filled: true}) .encode( vl.color().value('lightgray') .if(brush, vl.color().fieldN('weather').scale(scale).title('Weather')), vl.size().fieldQ('precipitation').scale({domain: [-1, 50], range: [10, 500]}).title('Precipitation'), vl.order().fieldQ('precipitation').sort('descending'), vl.x().timeMD('date').axis({title: 'Date', format: '%b'}), vl.y().fieldQ('temp_max').scale({domain: [-5, 40]}).axis({title: 'Maximum Daily Temperature (°C)'}) ) .width(width) .height(300) .params(brush) .transform(vl.filter(click)); const plot2 = vl.markBar() .encode( vl.color().if(click, vl.color().fieldN('weather')).value('lightgray') .scale(scale).title('Weather'), vl.x().count(), vl.y().fieldN('weather').scale({domain: scale.domain}).title('Weather') ) .width(width) .params(click) .transform(vl.filter(brush)); return vl.vconcat(plot1, plot2) .data('data/seattle-weather.csv') .autosize({type: 'fit-x', contains: 'padding'}) .render(); }46:T677,{ const domain = [ 'Beak Length (mm)', 'Beak Depth (mm)', 'Flipper Length (mm)', 'Body Mass (g)' ]; const scale = { type: 'point', padding: 0 }; const axis = { domain: false, ticks: false, title: false, grid: true, gridColor: '#888', labelAngle: 0, labelPadding: 8, labelFontWeight: 'bold' }; const lines = vl.markLine({ strokeWidth: 1.5, opacity: 0.5 }) .encode( vl.color().fieldN('Species').sort('descending'), vl.detail().fieldN('index'), vl.x().fieldO('key').scale(scale).axis(axis), vl.y().fieldQ('fraction').axis(null) ); const labels = vl.markText({ dx: -2, align: 'right', baseline: 'middle' }) .transform( vl.groupby('key').aggregate(vl.min('value').as('min'), vl.max('value').as('max')), vl.fold('min', 'max').as('op', 'value'), vl.groupby('key').window(vl.percent_rank('value').as('fraction')) ) .encode( vl.x().fieldN('key'), vl.y().fieldQ('fraction').axis(null), vl.text().field('value').format(',') ); const plot = vl.layer(lines, labels) .data('data/penguins.json') .transform( vl.filter('datum["Beak Length (mm)"] != null'), vl.window(vl.row_number().as('index')), vl.fold(domain).as('key', 'value'), vl.groupby('key').join(vl.min('value').as('min'), vl.max('value').as('max')), vl.calculate('(datum.value - datum.min) / (datum.max - datum.min)').as('fraction') ) .width(width) .height(300) .autosize({type: 'fit-x', contains: 'padding'}) return plot.render({renderer: 'svg'}); }47:T840,standalone_use = md`

## Stand-Alone Usage in a Web Browser To use the Vega-Lite API in the browser outside of Observable, you need to include all the dependencies, set the default configuration, and then register the Vega libraries. Here is some starting code to build from: ~~~html

~~~`48:[] 43:{"id":"960fdd963edb4490","slug":null,"title":"Vega-Lite API v5","thumbnail":"362ba0eab4e49b8a83fef1035035f81638858e14356e93fe565f42f2a54e1444","access_level":"public","create_time":"$D2023-10-26T19:12:34.102Z","update_time":"$D2023-10-26T19:12:34.102Z","view_time":null,"first_public_time":"$D2023-10-26T19:12:34.102Z","has_unpublished_edits":null,"fork":{"id":"26670360aa6f343b","slug":"vega-lite-api-v5","title":"Vega-Lite API v5","owner":{"id":"faa3d64559fbe807","login":"vega","name":"Vega"}},"stars":0,"starred":false,"owner":{"type":"team","id":"cc62ca71f10761fe","login":"pbiqueryous-repo","name":"Libraries and Functions","avatar_url":"https://avatars-next.observableusercontent.com/3af165f0f88c264d557f44ea2c0bd231e7f3838a766690f9c147869f3f6c2c0d","tier":"starter_2024","bio":"","following":false},"version":209,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"095ccf69e3466ab9","login":"pbi-queryous","name":"PBI Queryous","avatar_url":"https://avatars-next.observableusercontent.com/0e362e0326315a8b72bf30cfe2bf107a47fb597d0f8798eeb7f6330b2bbb725a","tier":null,"bio":"","following":false}],"members":[{"type":"individual","id":"095ccf69e3466ab9","login":"pbi-queryous","name":"PBI Queryous","avatar_url":"https://avatars-next.observableusercontent.com/0e362e0326315a8b72bf30cfe2bf107a47fb597d0f8798eeb7f6330b2bbb725a","tier":null,"role":"editor"},{"type":"team","id":"cc62ca71f10761fe","login":"pbiqueryous-repo","name":"Libraries and Functions","avatar_url":"https://avatars-next.observableusercontent.com/3af165f0f88c264d557f44ea2c0bd231e7f3838a766690f9c147869f3f6c2c0d","tier":"starter_2024","role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Vega-Lite API v5","cells":[{"id":0,"value":"md`# Vega-Lite API v5`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":5,"value":"md`The [Vega-Lite JavaScript API](https://github.com/vega/vega-lite-api/) provides a convenient way to write [Vega-Lite](https://vega.github.io/vega-lite) specifications in a programmatic fashion. Scroll down for some usage examples, or browse the [Vega-Lite API example collection](https://observablehq.com/collection/@vega/vega-lite-api)! \n\n_This notebook uses **version 5** of Vega-Lite and the corresponding Vega-Lite API v5._ To see what's new in version 5, [have a look at the changelog](https://github.com/vega/vega-lite/releases/tag/v5.0.0). To use Vega-Lite version 4, see the [Vega-Lite API v4 notebook](https://observablehq.com/@vega/vega-lite-api) instead.\n\nWant to learn more about data visualization and how to use the Vega-Lite API? Read the [introduction to Vega-Lite](https://observablehq.com/@uwdata/introduction-to-vega-lite) and the [data visualization curriculum](https://observablehq.com/@uwdata/data-visualization-curriculum?collection=@uwdata/visualization-curriculum).`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":10,"value":"md`\nThe cell below imports the Vega-Lite API and registers the desired versions of Vega and Vega-Lite, along with default [Vega View options](https://vega.github.io/vega/docs/api/view/#view) and [Vega-Lite configuration](https://vega.github.io/vega-lite/docs/config.html):\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":13,"value":"vl = {\n const [vega, vegalite, api, tooltip] = await Promise.all([\n `vega@${vegaVersion}`,\n `vega-lite@${vlVersion}`,\n `vega-lite-api@${apiVersion}`,\n `vega-tooltip@${tooltipVersion}`\n ].map(module => require(module)));\n\n const options = {\n config: {\n // vega-lite default configuration\n config: {\n view: {continuousWidth: 400, continuousHeight: 300},\n mark: {tooltip: null}\n }\n },\n init: view => {\n // initialize tooltip handler\n view.tooltip(new tooltip.Handler().call);\n // enable horizontal scrolling for large plots\n if (view.container()) view.container().style['overflow-x'] = 'auto';\n },\n view: {\n // view constructor options\n loader: vega.loader({baseURL: 'https://cdn.jsdelivr.net/npm/vega-datasets@2/'}),\n renderer: 'canvas'\n }\n };\n \n return api.register(vega, vegalite, options);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":46,"value":"apiVersion = '5.6.0'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":190,"value":"vlVersion = '5.6.0'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":193,"value":"vegaVersion = '5.23.0'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":196,"value":"tooltipVersion = '0.30.0'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":16,"value":"md`To use the same setup in your own notebooks, add a cell with the following code:\n~~~ js\nimport {vl} from '@vega/vega-lite-api-v5'\n~~~\nTo use the API outside of Observable, see the [stand-alone usage instructions](#standalone_use) below.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":21,"value":"zip_codes = md`

\n## Zip Codes\n\nA dot for each zip code in the United States, colored by the first digit.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":24,"value":"vl.markSquare({size: 2, opacity: 1})\n .data('data/zipcodes.csv')\n .transform(vl.calculate('substring(datum.zip_code, 0, 1)').as('digit'))\n .project(\n vl.projection('albersUsa')\n )\n .encode(\n vl.longitude().fieldQ('longitude'),\n vl.latitude().fieldQ('latitude'),\n vl.color().fieldN('digit')\n )\n .width(width)\n .height(Math.floor(width / 1.75))\n .autosize({type: 'fit-x', contains: 'padding'})\n .config({view: {stroke: null}})\n .render()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":26,"value":"interactive_weather = md`

\n## Interactive Seattle Weather 2012-2015\n\nA scatter plot and summary histogram with linked selections between plots to perform cross-filtering and configure conditional color encodings.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":29,"value":"$45","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":119,"value":"population_pyramid = md`

\n## Population Pyramid\n\nA [population pyramid](https://en.wikipedia.org/wiki/Population_pyramid) shows the distribution of age groups in a population. Drag the slider to see the U.S. change over time, but watch out for [missing data in 1890!](https://www.census.gov/history/www/faqs/genealogy_faqs/why_cant_i_find_1890_census_records.html) The slider is generated internally by binding the \\`Year\\` parameter using \\`vl.slider()\\`.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":86,"value":"vl.markBar({ opacity: 0.4 })\n .params(\n vl.param('Year').value(2000).bind(vl.slider(1850, 2000, 10))\n )\n .data('data/population.json')\n .transform(\n vl.calculate('datum.sex === 1 ? \"Male\" : \"Female\"').as('sex'),\n vl.filter('datum.year === Year')\n )\n .encode(\n vl.x().sum('people').scale({ domain: [0, 12e6] }).stack(null).title('People'),\n vl.y().fieldO('age').sort('descending').title('Age'),\n vl.color().fieldN('sex').scale({ range: ['#675193', '#ca8861'] }).title('Sex')\n )\n .height(300) // fix the height to keep stability over missing data\n .render()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":153,"value":"bind_external = md`### Bind Parameters to External Inputs\n\nAs an alternative to having Vega-Lite generate its own input widgets (as with \\`vl.slider()\\` above), we can also directly bind a Vega-Lite parameter to an existing widget, such as Observable's \\`Range\\` component:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":141,"value":"import {Range} from '@observablehq/inputs'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":146,"value":"viewof year = Range([1850, 2000], { step: 10, value: 2000 })","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":144,"value":"vl.markBar({ opacity: 0.4 })\n .params(\n // use viewof to bind to the input element (the view), not the numeric year value\n vl.param('Year').bind(viewof year)\n )\n .data('data/population.json')\n .transform(\n vl.calculate('datum.sex === 1 ? \"Male\" : \"Female\"').as('sex'),\n vl.filter('datum.year === Year')\n )\n .encode(\n vl.x().sum('people').scale({ domain: [0, 12e6] }).stack(null).title('People'),\n vl.y().fieldO('age').sort('descending').title('Age'),\n vl.color().fieldN('sex').scale({ range: ['#675193', '#ca8861'] }).title('Sex')\n )\n .height(300)\n .render()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":69,"value":"dynamic_scatter = md`

\n## Dynamic Query Scatter Plot\n\nA scatter plot of automobile mileage and horsepower. (Shift-)Click the legend and drag the slider to filter by Origin and Year.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":53,"value":"{\n const isOrigin = vl.selectPoint('isOrigin')\n .fields('Origin')\n .bind('legend'); // bind to legend interactions\n \n const isYear = vl.selectPoint('isYear')\n .fields('Year').value(1970)\n .bind(vl.slider(1970, 1980, 1).name('Year')); // bind to slider\n \n const show = vl.and(isOrigin, isYear); // combine selections\n\n return vl.markCircle()\n .data('data/cars.json')\n .transform(\n vl.calculate('year(datum.Year)').as('Year')\n )\n .params(isOrigin, isYear) // add selections to plot\n .encode(\n vl.x().fieldQ('Horsepower'),\n vl.y().fieldQ('Miles_per_Gallon'),\n vl.color().if(show, vl.color().fieldN('Origin')).value('grey'),\n vl.opacity().if(show, vl.value(1.0)).value(0.2)\n )\n .render();\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":36,"value":"parallel_coordinats = md`

\n## Parallel Coordinates\n\nA [parallel coordinates plot](https://en.wikipedia.org/wiki/Parallel_coordinates) that uses \\`window\\` and \\`fold\\` transforms to convert the four dimensions of penguin measurements into normalized coordinates that can be visualized as \\`line\\` marks. The graphic includes an additional layer with custom \\`text\\` mark labels for the parallel axis grid lines. We render the plot as SVG by passing \\`{renderer:'svg'}\\` to the \\`render\\` method.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":39,"value":"$46","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":42,"value":"$47","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W48","stdlib":"1"}} 44:"$43:body"