monochron

monochron is a lightweight React component library for visualizing arbitrary timeseries data in realtime.

It was initially created to power plum project (along with pogo).

Installation

npm install monochron

Usage

Documentation can be found here.

Examples

• Simple RealtimeChart
• GIF images in TimeseriesChart
• Nested rows in TimeseriesChart
• plum

TimeseriesChart

Realtime timeseries visualization (when you are receiving a bucketed timeseries data at a time) using TimeseriesChart component:

<TimeseriesChart
    newBucket={newBucket}
    options={{
        frameCycle: 20000,
    }}
    renderRow={(bucket, Row) => (
        <Row
            key={bucket.key}
            start={bucket.start}
            end={bucket.end}
            containerClassName="whitespace-nowrap overflow-hidden"
        >
            <img
                src={bucket.data.url}
                style={{
                    height: 120,
                    objectFit: "cover",
                }}
            />
        </Row>
    )}
/>

The chart gets an update every time you pass new data to the newBucket prop.

RealtimeChart

When you have more generic, per data entry (as opposed to per timeseries bucket), use RealtimeChart component (TimeseriesChart uses RealtimeChart under the hood):

<RealtimeChart
    width={1000}
    currentTime={time}
    rows={buckets}
    renderRow={(bucket, Row) => {
        return (
            <Row key={bucket.key} start={bucket.start} end={bucket.end}>
                {bucket.data}
            </Row>
        );
    }}
/>

The chart gets an update every time you pass new data to the rows prop.