v0.13.0-beta.3

New and improved features

• Improve performance of intervals track rendering
• Loading indicators are now added by default and can be used via the declarative layout api (no need to use panel.addBasicLoader imperatively after render). Loaders can be disabled via the new panel layout directive, show_loading_indicator.

Bugfixes

• Fix "link" behavior for clickable data elements
• Annotation (rug) track and chromatin accessibility track: fixes for position and hitarea behavior

Breaking changes

• Moved little-used forest plot to a new extension

v0.13.0-beta.2

• Fix display of LD reference variant when incomplete/non-standard variant format is used
• Fix warnings when using ES6 modules and newest webpack version
• Fix demo "offline mode" sample data to reflect updated payload structure of genes endpoint

v0.13.0-beta.1

Features

• Rendering performance improvements
  • Use fewer system resources/ listeners/ function calls to render each scatter plot point (cache computed values, event bubbling, etc)
• Provide an option to coalesce adjacent points in the scatter plot. This can reduce the number of points to render by 40-50% for a narrow region or noisy plot, and >90% for a GWAS with a few strong hits in a wide viewing region. (controlled by the new scatter layer option section, coalesce._)
  • Coalescing is turned on by default for association plots (only). You may wish to adjust this behavior and options if you use a different y-axis range for your plots (eg, user-selectable "toggle y-axis display" behaviors)
  • The final rendered result will appear almost indistinguishable from plots without coalescing. All significant points and "highlight matching points" behaviors will be preserved.

Deprecations:

• Remove shift-click "multiselect" from plots: few people seem to use this feature, and it adds complexity for limited gain

Bugfixes:

• Correctly remove old scatter plot labels on toggle/re-render
• Fix double-escaping issue with label display values

v0.12.2

• Improvements to event callbacks for responding to plot and user actions
  • Plot and panel event callbacks now receive event.target with reference to event originator (plot or panel instance)
  • subscribeToData callbacks now receive a second argument, plot
• Fixes for credible set calculations in regions with no variants

v0.12.1

Bugfixes:

• Re-implement a triangledown symbol shape (was removed by d3v4). Useful for showing direction of effect arrows.
• Better handle server errors in gnomAD graphQL API
• Fix an issue where responsive_resize = true was incorrectly still preserving aspect ratio. This should make LocusZoom plots look better on large screens.

v0.12.0

This version contains numerous breaking changes and new features. Although we have tried to keep most familiar aspects of using LocusZoom intact, please read carefully before upgrading.

If you are using LocusZoom via <script> tag, LocusZoom now requires D3v5. Check any other visualizations on your site for compatibility.

New features for users

Several new features are available and enabled by default.

• New "save as PNG" feature
• Fix "scroll to zoom" in Firefox (new "alt-scroll" keyboard shortcut)
• Better LD by default
  • Build 38 datasets will now use an improved LD panel based on deep WGS sequencing of 1000G.
  • The "select LD population" button has been added to the default layout for all association plot toolbars (this button must be used with the LDServer adapter)
• Improved genes track
  • Now hides pseudogenes by default.
  • A dropdown menu can be used to customize what is shown.
  • Visual tweaks: Genes track now shows more genes in the same amount of space (better for publications etc)
• Gene and GWAS catalog views refreshed with the newest data available (GENCODE v35 and GWAS catalog v1.0 e100)

New features for developers

LocusZoom is highly customizable. We have added a variety of internal improvements that make it easier to build truly dynamic visualizations.

• New "filters" mechanism lets users interactively choose which points are shown on scatter, arc, forest, and gene tracks, based on customizable criteria.
  • A new toolbar widget can be used to let users change filters interactively
• The "save as svg" button no longer relies on a hardcoded CSS file name. This should resolve issues where saved images did not look good on some sites.
• New region_changed plot-level event reports exact plot coordinates after pan, zoom, or region change
• New log10 transformation function (a complement to neglog10). Useful for creating, eg, loglog plots.
• New plot.destroy() cleanup method: helps to avoid memory leaks when using LocusZoom with single-page-application frameworks like Vue or React.
• More systematic way of registering and bundling LZ plugins (LocusZoom.use(function(LocusZoom, ...args) { /* plugin code*/ }))
• All registries (layouts, adapters, datasources, etc) are now more consistent in their behavior, exposing add, remove, has, get, and list methods. Efforts have been made to preserve method syntax for any existing usages.

Important breaking changes

The code was heavily reorganized. Unused features were removed, and some improvements were made to make the library more approachable for new developers.

Overview

• LocusZoom is now based on D3v5. If you are using the library via a script tag, you will need to update the D3 version used. We no longer provide a vendor.js bundle.
• Some breakages may occur due to D3 changes. For example, triangle-up is now triangle, and triangle-down was removed from the library.
• All extensible "plugin" features are now based on ES6 classes, making it easier to customize small pieces of functionality (like new data layers)
• The codebase is now based on ES6 modules. Many "private" features have been moved out of the global namespace, to avoid overwhelming developers with functions they don't need.
  • LocusZoom will only be exposed as a global variable if you load it via <script> tag.
  • If your code uses ES6 modules, import LocusZoom from 'locuszoom'; will continue to work. But you should update how you import extensions for best results: use locuszoom/esm/ext/... instead of locuszoom/dist/ext/...

Renamed features

To support doc/instruction improvements, several things have been renamed.

• Three different things had "data source" in their names and all were available globally. This was unnecessarily confusing.
  • LocusZoom.KnownDataSources -> LocusZoom.Adapters
  • Data.Source has been renamed to BaseApiAdapter and is no longer available as a global.
    • Users of modern ES6 may import it from locuszoom/data to create true ES6 subclasses.
    • If using via a <script> tag, the shortcut for creating and registering a new class will be almost the same as old versions: LocusZoom.Adapters.extend('BaseApiAdapter', 'MySourceName', {}) .
  • The helper used to assign data for a specific plot (LocusZoom.DataSources) was left unchanged.
• dashboards are now called toolbars , and Dashboard.Components -> Widgets.
  • This rename will affect layouts: eg dashboard.components should be changed to toolbar.widgets and Layouts.get('dashboard'...) -> Layouts.get('toolbar'...).

New/improved defaults

• Plots now handle resizing differently. The old responsive_resize: both mode has been removed. The default option (true) will now trigger resize only for width.
  • Preserving aspect ratio sometimes caused odd behavior on re-render. Many sites that use LZ have already migrated to the new default.
• Most usages of the genes datalayer should now use genes_filtered instead. This is intended to work best with the new "hide pseudogenes by default" behavior used by the default genes panel.
• Layouts (such as annotation tracks) that used filters now have a new unified syntax, where each filter is represented as an object with {field, operator, value} keys. This extends and standardizes the quasi-public implementation of track filters from previous releases.
  • Some old layouts represented each filter in an array form and will need to be updated.

Removals

• Any methods previously marked as deprecated in prior releases have been removed. In previous versions, these were usually indicated by warning messages on the JS console.
• The LocusZoom.createCORSPromise method has been removed. Internal usages have been replaced with the standard JS fetch function; we recommend doing the same with your own code.
• The old LDLZ data source (adapter) has been completely removed, because it referenced an old server. Prior LocusZoom versions had already introduced its replacement, LDLZ2 (also known as LDServer).
• Data.Source.extend has been removed, in favor of true ES6 classes.
• Removed setElementStatusByFilters and largely unused methods.
• Remove datalayer.addField method, due to limited utility. It is better to know what fields are required before requesting the data.
• Removed "transition" option from layouts, which was poorly supported and largely unused.

Other

If you are testing experimental LocusZoom features, we have changed the build scripts. Gulp has been removed and replaced with new commands: npm run dev and npm run build. The unit tests now support test coverage.

The build process and modules work on all currently supported node LTS versions: 10.x or above. Old versions of Ubuntu tend to ship with very old versions of nodeJS, so this is something to check if your modified locuszoom code refuses to build.

If you modify the code, we welcome open source contributions! Please share your improvements or suggestions.

v0.12.0-beta.5

• Intervals track now supports basic display filters
• Bugfix for missing tooltips on intervals track at first render
• Improve default plot-level toolbar

v0.12.0-beta.4

• Genes layer is now filtered to a curated subset of gene types by default
• Update gene and gwas catalog datasets to use newest releases in portaldev api

v0.12.0-beta.3

• Support all active nodeLTS when using as ESM
• Build and minor display issues

v0.12.0-beta.2

• Bugfixes: pan/zoom, axis label display, event cleanup
• New filtering widget + UI
• Better default LD panel for GRCh38 datasets