https://github.com/generateme/cljplot
JVM Clojure charting library
https://github.com/generateme/cljplot
Last synced: 9 months ago
JSON representation
JVM Clojure charting library
- Host: GitHub
- URL: https://github.com/generateme/cljplot
- Owner: generateme
- License: epl-2.0
- Created: 2019-03-28T18:03:45.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-04-26T13:46:39.000Z (about 3 years ago)
- Last Synced: 2024-08-07T01:47:58.312Z (almost 2 years ago)
- Language: Clojure
- Size: 69 MB
- Stars: 152
- Watchers: 10
- Forks: 7
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - CLJPLOT
README
# CLJPLOT
> **_INFO (2020-08-17):_** I'm preparing new version based on tech.ml.dataset as data input which is going to solve issues with data processing and labels. Also rethinking the way of better management of data dimensions and their representation through trellis/colors/axes etc. It happens very slowly, but happens. Stay tuned.
# clojure2d.charts
THIS IS WIP/POC
A "no web-based" pure JVM Clojure library for 2d charts, inspired by D3, Vega and R (ggplot2/lattice/facet).
## Current version
`[cljplot "0.0.3"]`
## NOTE about API
Please note that current way of creating charts is very low level. All of this nasty steps will be finally hidden from user perspective.
## Usage
Currently there are no easy to use functions nor data DSL (help needed here). Still everything is done manually.
See `sketches` folder for examples
### Examples
## Short term plan
* More chart types (`+` - easier; `-` - harder):
- ~~heatmaps (various grids)~~ (`+`)
- ~~point clouds (log and linear rendering)~~ (`+`)
- ~~contours (`-`), flow fields (`+`)~~
- categorical x categorical plots (scatter plot matrix (`+`)
- ~~stacked area/stream~~
- parallel / hive (`+`/`-`)
- radial charts, like pie (`+`), sunburst (`-`), radial tree (`-`)
- arc(?) (`+`)
- markers: line, text, etc...
* ~~Labels~~ / ~~legends~~ / gradients / palettes
* Higher level API
- single function for each chart type (easier)
- faceting/lattice (harder)
* cleaning configuration mess
## Long term plan / wishlist
* Enable other renderers (create dispatch layer)
* Data DSL(?)
* geo maps
* elements of UpSet
* signal processing / time series (partially done)
* annotations
* grid of charts / subplots (with independent axes)
* kind of interactivity
* chart styles (now everything is blueish)
## Known issues
* ~~grid, axes sometimes don't match (1-2px shift). This is due to rounding errors and axes rotations~~
* still ~~no labels~~, ~~no legends~~
* overlapping ticks (add some heuristics to use smaller fonts and smaller number of ticks)
* chart configuration needs to be reviewed, still not consistent
* no higher level functions/macros
* no DSL for data manipulation, and no plan to make it (task for others!)
* deep nesting is really nasty to configure and for data preparation :/ (lattice of stacked horizontally stacked bars...)
* merging nested extents is not working correctly (in lattice)
* true is, there are some labels for lattice, quick and dirty
* do not layer over histograms (bins mismatch)...
* still something is wrong with time scale
## Why?
So, why another chart library, when you can use _insert any name here_
In my case, the main obstacle was the ability to save hundreds of charts without using any display (web or java frame).
One can say: jfreechart! I can say: try to generate heatmaps... Every library I've found had some issues or produces ugly result or was web based or was notebook based or...
So I fell into the lisp curse and I'm writing my own.
## Contributing
YES! A lot of things to do:
* documentation
* configuration
* new charts
* testing, test-cases
Let's chat about this: https://clojurians.zulipchat.com/#narrow/stream/197967-cljplot-dev
## Marching squares algorithm
Source: https://udel.edu/~mm/code/marchingSquares/
## License
Copyright © 2019-2023
Distributed under the Eclipse Public License either version 1.0 or (at
your option) any later version.