CSV Wrangling

Build Status DOI

This is the repository for reproducing the experiments in the paper:

Wrangling Messy CSV files by Detecting Row and Type Patterns (PDF)

by G.J.J. van den Burg, A. Nazabal and C. Sutton.

For an implementation of the method developed in the paper, see the CleverCSV repository.

If you use this paper or this code in your own work, please cite the paper using for instance the following BibTeX citation:

@article{van2019wrangling,
  title = {Wrangling Messy {CSV} Files by Detecting Row and Type Patterns},
  author = {{van den Burg}, G. J. J. and Naz{\'a}bal, A. and Sutton, C.},
  journal = {Data Mining and Knowledge Discovery},
  year = {2019},
  volume = {33},
  number = {6},
  pages = {1799--1820},
  issn = {1573-756X},
  doi = {10.1007/s10618-019-00646-y},
}

Introduction

Our experiments are made reproducible through the use of GNU Make. You can either set up your local environment with the necessary dependencies as described under Requirements, or use the Dockerfile included in the repository.

There are two ways to reproduce our results. The first only reproduces the figures, tables, and constants in the paper from the raw detection results, while the second runs the detection methods as well.

  1. You can reproduce the figures, tables, and constants from the raw experimental results included in this repository. This will not re-run all the experiments but will regenerate the output used in the paper. The command for this is:

    $ make output
  2. You can fully reproduce our experiments by downloading the data and rerunning the detection methods on all the files. This might take a while depending on the speed of your machine and the number of cores available. Total wall-clock computation time for a single core is estimated at 11 days. The following commands will do all of this.

    $ make clean       # remove existing output files, except human annotated
    $ make data        # download the data
    $ make results     # run all the detectors and generate the result files

    If you'd like to use multiple cores, you can replace the last command with:

    $ make -j X results

    where X is the desired number of cores.

Data

There are two datasets that are used in the experiments. Because we don't own the rights to all these files, we can't package these files and make them available in a single download. We can however provide URLs to the files and add a download script, which is what we do here. The data can be downloaded with:

$ make data

If you wish to change the download location of the data, please edit the DATA_DIR variable in the Makefile.

Note: We are aware of the fact that some of the files may change or become unavailable in the future. This is an unfortunate side-effect of using publically available data in this way. The data downloader skips files that are unavailable or that have changed. Note that this may affect the exact reproducibility of the results.

Requirements

Below are the requirements for reproducing the experiments if you're not using Docker. Note that at the moment only Linux-based systems are supported. MacOS will probably work, but hasn't been tested.

  • Python 3.x with the packages in the requirements.txt file. These can be installed with: pip install --user -r requirements.txt.

  • R with the external packages installed through: install.packages(c('devtools', 'rjson', 'data.tree', 'RecordLinkage', 'readr', 'tibble')).

  • A working LaTeX installation is needed for creating the figures (at least texlive-latex-extra and texlive-pictures), as well as a working LaTeXMK installation.

Instructions

To clone this repository and all its submodules do:

$ git clone --recurse-submodules https://github.com/alan-turing-institute/CSV_Wrangling

Then install the requirements as listed above and run the make command of your choice.

License

With the exception of the submodule in scripts/detection/lib/hypoparsr this code is licensed under the MIT license. See the LICENSE file for more details.

::...
免责声明:
当前网页内容, 由 大妈 ZoomQuiet 使用工具: ScrapBook :: Firefox Extension 人工从互联网中收集并分享;
内容版权归原作者所有;
本人对内容的有效性/合法性不承担任何强制性责任.
若有不妥, 欢迎评注提醒:

或是邮件反馈可也:
askdama[AT]googlegroups.com



自怼圈/年番新

DU21.7
关于 ~ DebugUself with DAMA ;-)


关注公众号, 持续获得相关各种嗯哼:
zoomquiet


粤ICP备18025058号-1
公安备案号: 44049002000656 ...::