https://github.com/ctuavastlab/jsongrinder.jl

Machine learning with Mill.jl for JSON documents
https://github.com/ctuavastlab/jsongrinder.jl

flux hierarchical-data json julia machine-learning multi-instance-learning

Last synced: 6 days ago
JSON representation

Machine learning with Mill.jl for JSON documents

• Host: GitHub
• URL: https://github.com/ctuavastlab/jsongrinder.jl
• Owner: CTUAvastLab
• License: other
• Created: 2018-08-27T09:38:55.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-12-11T13:16:28.000Z (28 days ago)
• Last Synced: 2024-12-24T16:28:38.014Z (15 days ago)
• Topics: flux, hierarchical-data, json, julia, machine-learning, multi-instance-learning
• Language: Julia
• Homepage: https://ctuavastlab.github.io/JsonGrinder.jl/stable/
• Size: 35.4 MB
• Stars: 46
• Watchers: 4
• Forks: 9
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


  

  



---

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/CTUAvastLab/JsonGrinder.jl/blob/master/LICENSE.md)

[![Docs](https://img.shields.io/badge/docs-stable-blue.svg)](https://CTUAvastLab.github.io/JsonGrinder.jl/stable)

[![Build Status](https://github.com/CTUAvastLab/JsonGrinder.jl/actions/workflows/ci.yml/badge.svg)](https://github.com/CTUAvastLab/JsonGrinder.jl/actions/workflows/ci.yml)

[![codecov](https://codecov.io/gh/CTUAvastLab/JsonGrinder.jl/graph/badge.svg?token=krZzRJAm2c)](https://codecov.io/gh/CTUAvastLab/JsonGrinder.jl)

`JsonGrinder.jl` is a library that facilitates processing of JSON documents into

[`Mill.jl`](https://github.com/CTUAvastLab/Mill.jl) structures for machine learning. It provides

functionality for JSON schema inference, extraction of JSON documents to a suitable representation

for machine learning, and constructing a model operating on this data.

Watch our [introductory talk](https://www.youtube.com/watch?v=Bf0CvltIDbE) from JuliaCon 2021.

## Installation

Run the following in REPL:

```julia

] add JsonGrinder

```

## Getting Started

- [Documentation](https://ctuavastlab.github.io/JsonGrinder.jl/stable/)

- [API Reference](https://ctuavastlab.github.io/JsonGrinder.jl/stable/api/schema/)

- [Examples](https://ctuavastlab.github.io/JsonGrinder.jl/stable/examples/mutagenesis/mutagenesis/)

## Citation

Kindly cite our work with the following entries if you find it interesting, please:

* [*JsonGrinder.jl: automated differentiable neural architecture for embedding arbitrary JSON

  data*](https://jmlr.org/papers/v23/21-0174.html)

  ```

  @article{Mandlik2022,

   author = {Šimon Mandlík and Matěj Račinský and Viliam Lisý and Tomáš Pevný},

   issn = {1533-7928},

   issue = {298},

   journal = {Journal of Machine Learning Research},

   pages = {1-5},

   title = {JsonGrinder.jl: automated differentiable neural architecture for embedding arbitrary JSON data},

   volume = {23},

   url = {http://jmlr.org/papers/v23/21-0174.html},

   year = {2022},

  }

  ```

* [*Malicious Internet Entity Detection Using Local Graph

  Inference*](https://ieeexplore.ieee.org/document/10418120) (practical `Mill.jl` and

  `JsonGrinder.jl` application)

  ```

  @article{Mandlik2024,

    author  = {Mandlík, Šimon and Pevný, Tomáš and Šmídl, Václav and Bajer, Lukáš},

    journal = {IEEE Transactions on Information Forensics and Security},

    title   = {Malicious Internet Entity Detection Using Local Graph Inference},

    year    = {2024},

    volume  = {19},

    pages   = {3554-3566},

    doi     = {10.1109/TIFS.2024.3360867}

  }

  ```

* this implementation (fill in the used `version`)

  ```

  @software{JsonGrinder,

    author  = {Tomas Pevny and Matej Racinsky and Simon Mandlik},

    title   = {JsonGrinder.jl: a flexible library for automated feature engineering and conversion of JSONs to Mill.jl structures},

    url     = {https://github.com/CTUAvastLab/JsonGrinder.jl},

    version = {...},

  }

  ```

## Contribution guidelines

If you want to contribute to JsonGrinder.jl, be sure to review the

[contribution guidelines](CONTRIBUTING.md).

We use [GitHub issues](https://github.com/CTUAvastLab/JsonGrinder.jl/issues) for

tracking requests and bugs.