npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

d3-glyphedge

v1.2.0

Published

A collection of different generators for complex edges with D3.

Downloads

5,473

Readme

d3-glyphedge

d3-glyphEdge

A bunch of different edge generators for you to use in any data visualization product where you need to graphically represent the connection of one thing to another, like a network diagram or dendrogram.

Examples of all the edges

Installing

If you use NPM, npm install d3-glyphedge. Otherwise, download the latest release.

You can install each type of edge separately by importing the particular function.

If you want to do it the old-fashioned way, just download d3-glyphEdge.js or d3-glyphEdge.min.js.

API Reference

There are three categories of edges with 10 types of edges available here:

d3_glyphEdge.d

These functions return drawing instructions for svg:path elements.

# lineArc(edge)

A simple arc edge. Unlike the rest of the edges, this is drawn as a line and cannot be filled and can only be styled using stroke and stroke-width.

# Ribbon(edge, width)

A very simple filled, straight edge drawn with the width specified.

# Arrowhead(edge, targetSize, arrowlineWidth, arrowheadSize)

An arrow drawn with a line thickness specified and arrowhead size specified that terminates at the edge of the target node (or wherever targetSize specified).

# halfArrow(edge, targetSize, arrowlineWidth, arrowheadSize)

Half an arrow drawn with a line thickness specified and arrowhead size specified that terminates at the edge of the target node (or wherever targetSize specified). This is useful for bidirectional graphs because the two edges join along a seam and indicate reciprocity in a graphically distinct way.

# Nail(edge, sourceSize)

A filled triangular edge drawn in such a way that the thick end of the triangle designates the source.

# Comet(edge, targetSize)

A filled triangular edge drawn in such a way that the thick end of the triangle designates the target.

# Taffy(edge, sourceSize, targetSize, midpointWidth)

An edge drawn so that it has fat edges at each node while tapering at the midpoint between the nodes to the width specified.

d3_glyphEdge.project

These functions return a new object of the traditional {source: {x, y}, source: {x, y}} format based on the object and parameters sent in. The object returned can be used to draw a simple svg:line or passed to one of the generator functions to actually draw the edge.

# Offset(edge, sourceSize, targetSize)

Offset Edges Example

Offset edges are drawn such that reciprocating edges will not overlap each other. This is for directed networks without parallel edges. For networks with parallel edges, use the next function.

# Parallel(edge, sourceSize, targetSize, edgeNumber)

Parallel Edges Example

Parallel edges require an edge number to also be passed along with the edge object, source size and target size. The edgeNumber is the ordinal value for that edge in the parallel edges associated with the same connection from source to target (so if there are five parallel edges from node A to node B, then each one would require an edgeNumber from 1 to 5);

d3_glyphEdge.mutate

These functions mutate the data sent to the function and as such typically require some kind of initial formatting of the object being sent.

# Particle(edge, pathNode, edgeWidth, speed)

Particle Edges Example

d3_glyphEdge.mutate.particle requires an edge sent to it with the standard source and target properties but also requires a particles property that should be an empty array and a frequency property with a number over 0. edge.particles will be populated with objects that have x and y coordinates for each particle, with the number of particles added to the array during every call equal to the number in edge.frequency. If edge.frequency is less than 1, then it is the percent chance that a particle will be added. During every tick, each particle's xy position will be updated to move it along the path of the edge at speed (in pixels). Once a particle has reached the end of the path, it will be dropped from the array. Particles are only added and updated when glyphEdge.mutate.particle is called on that edge, so you'll need to call it from a tick event (such as the d3.layout.force tick event or a similar tick event created with d3.timer or the like.) If you're dealing with a large number of particles, you will likely want to use canvas for rendering rather than SVG.