Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yohasebe/rubyfca
Command line tool for Formal Concept Analysis written in Ruby
https://github.com/yohasebe/rubyfca
fca formal-concept-analysis ruby visualization
Last synced: 8 days ago
JSON representation
Command line tool for Formal Concept Analysis written in Ruby
- Host: GitHub
- URL: https://github.com/yohasebe/rubyfca
- Owner: yohasebe
- License: gpl-3.0
- Created: 2009-09-04T07:09:22.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2023-06-19T08:38:14.000Z (over 1 year ago)
- Last Synced: 2024-10-07T02:37:42.477Z (about 1 month ago)
- Topics: fca, formal-concept-analysis, ruby, visualization
- Language: Ruby
- Homepage: http://github.com/yohasebe/rubyfca
- Size: 1.46 MB
- Stars: 7
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 💠RubyFCA
Command line tool for Formal Concept Analysis (FCA) written in Ruby.
## Change Log
- More test cases added [June 19, 2023]
- Microsoft Excel `.xlsx` files supported [June 18, 2023]
## Features
* Converts data in XLSX (Microsoft Excel), CSV (comma-separated values), or CXT ([Conexp](https://github.com/fcatools)) and generate a Graphviz DOT file, a SVG/EPS vector image file, or /a PNG/JPG bitmap file.
* Adopts the Ganter algorithm (with reference to its Perl implementation of [Fcastone](https://upriss.github.io/fcastone) by Uta Priss).
## Dependencies
- [Graphviz](https://graphviz.org/)
To install Graphviz using Homebrew on MacOS, for example, execute the following command:
brew install graphviz
For installation instructions for other platforms, see the [Graphviz download page](https://graphviz.org/download/).
## Installation
Install the gem:
gem install rubyfca
## How to Use
RubuFCA converts Conexp CXT data to Graphviz dot format.
Usage:
rubyfca [options]
where:
".xlsx", ".csv" ,".cxt"
".svg", ".png", ".jpg", ".eps", or ".dot"
[options]:
--full, -f: Do not contract concept labels
--coloring, -c : Color concept nodes [0 = none (default), 1 =
lightblue/pink, 2 = monochrome] (default: 0)
--straight, -s: Straighten edges (available when output format is
either png, jpg, svg, pdf, or eps)
--nodesep, -n : Size of separation between sister nodes (from 0.1 to
5.0) (default: 0.4)
--ranksep, -r : Size of separation between ranks (from 0.1 to 5.0)
(default: 0.2)
--legend, -l: Print the legend of concept nodes (available only when
using circle node shape)
--circle, -i: Use circle shaped concept nodes
--version, -v: Print version and exit
--help, -h: Show this message
## Examples
### Input Data
#### XLSX (Excel)
#### CSV
```
, Ostrich , Sparrow , Eagle , Lion , Bonobo , Human being
bird , X , X , X , , ,
mammal , , , , X , X , X
ape , , , , , X , X
flying , , X , X , , ,
preying , , , X , X , ,
talking , , , , , , X
```
#### CXT
```
B
6
6
Ostrich
Sparrow
Eagle
Lion
Bonobo
Human being
bird
mammal
ape
flying
preying
talking
XXX...
...XXX
....XX
.XX...
..XX..
.....X
```
### Output
`rubyfca input_file output_file --coloring 1 --full --nodesep 0.8 --ranksep 0.3 --straight`
`rubyfca input_file output_file --coloring 2 --nodesep 0.5 --ranksep 0.3`
`rubyfca input_file output_file --circle --legend --coloring 1 --full --nodesep 0.8 --ranksep 0.3 --straight`
**N.B.** The arrangement of elements in the right-hand side of the image above has been a little modified for better visibility.
### Miscellaneous
#### RGB Color Model
#### Natural numbers
## References
Yoichiro Hasebe and Kow Kuroda. 2009. [Extraction of English Ditransitive Constructions Using Formal Concept Analysis](https://aclanthology.org/Y09-2028/). In *Proceedings of the 23rd Pacific Asia Conference on Language, Information and Computation*, Volume 2, pages 678–685, Hong Kong. City University of Hong Kong.
## Authors
- [Yoichiro Hasebe](https://github.com/yohasebe)
- [Kow Kuroda](https://github.com/kow-k)
## License
See LICENSE for details.