<commit_before># AskOmics

[![Build Status](https://travis-ci.org/askomics/askomics.svg?branch=master)](https://travis-ci.org/askomics/askomics)
[![Coverage Status](https://coveralls.io/repos/github/askomics/askomics/badge.svg?branch=master)](https://coveralls.io/github/askomics/askomics?branch=master)
[![Docker Build](https://img.shields.io/docker/pulls/askomics/askomics.svg)](https://hub.docker.com/r/askomics/askomics/)
[![Documentation](https://readthedocs.org/projects/askomics/badge/?version=latest)](http://askomics.readthedocs.io/en/latest/?badge=latest)

![Askomics logo](static/askomics.png)

AskOmics is a visual SPARQL query interface supporting both intuitive data integration and querying while shielding the user from most of the technical difficulties underlying RDF and SPARQL

![Askomics Homepage](static/askomics_home.png)

## Running AskOmics

AskOmics is available under two supports : Docker and VM Virtualbox.

Some (possibly outdated) documentation is on the [AskOmics Wiki](https://github.com/askomics/askomics/wiki)

See the new [AskOmics documentation](https://askomics.readthedocs.io/)

------------------

## Development information

### Requirements

If you want to use AskOmics, you will need :

* [Python 3.4](https://www.python.org/downloads/) (or greater)
* [Pyramid 1.5](http://www.pylonsproject.org) (or greater)
* [SPARQLWrapper](https://rdflib.github.io/sparqlwrapper/) 1.6.4 (or greater)

AskOmics also uses the following bundled libraries:

* [Bootstrap](http://getbootstrap.com)
* [D3.js](http://d3js.org)
* [jQuery](http://jquery.com)
* [jQuery-File-Upload](https://github.com/blueimp/jQuery-File-Upload)
* [Handlebars.js](http://handlebarsjs.com/)
* [Google Material icons](https://design.google.com/icons/)
* [Font Awesome icons](http://fontawesome.io/icons/)
* [DataTables](https://datatables.net/)
* [jQuery contextMenu](http://swisnl.github.io/jQuery-contextMenu/index.html)

#### Browser compatibility

| Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|
| 38+  | 13+  | Not supported  | 25+  |  7.1+ |

### Install Askomics

#### Requirements

+ python 3.4
+ pip
+ venv
+ npm
+ gulp
+ docker

#### Manual installation

+ Install  Virtuoso

```
docker run -d --name virtuoso \
        -e VIRT_Parameters_TN_MAX_memory=4000000000 \
        -e VIRT_SPARQL_ResultSetMaxRows=100000 \
        -e VIRT_SPARQL_MaxQueryCostEstimationTime=300 \
        -e VIRT_SPARQL_MaxQueryExecutionTime=300 \
        -e VIRT_SPARQL_MaxDataSourceSize=1000000000 \
        -e VIRT_Flags_TN_MAX_memory=4000000000 \
        -e DBA_PASSWORD=<PASSWORD> \
        -e SPARQL_UPDATE=true \
        -e DEFAULT_GRAPH=http://localhost:8890/DAV \
        --net="host" -t askomics/virtuoso
```

+ Run `startAskomics.sh`

```
./startAskomics -t <triplestore> -d <mode>
```

with:

+ triplestore: fuseki or virtuoso
+ mode: prod (production) or dev (development)


### Running tests

AskOmics comes with some unit and functional tests.

#### Python tests

To run tests, AskOmics need a triplestore and a Galaxy instance.

The testing configuration is set in the `test.virtuoso.ini` file.

To get a Galaxy instance, you can run a docker galaxy with the following lines

    docker pull bgruening/galaxy-stable
    docker run -d -p 8080:80 -p 8021:21 -p 8022:22 bgruening/galaxy-stable

Then, test can be run with

##### All tests

```
./venv/bin/python setup.py nosetests
```

##### Without Galaxy Tests
```
./venv/bin/python setup.py nosetests -a '!galaxy'
```
##### Target a single file test

./venv/bin/python setup.py nosetests -a '!galaxy' --tests askomics/test/askView_test.py

##### With a html report coverage

```
./venv/bin/python setup.py nosetests -a '!galaxy' --with-coverage --cover-erase --cover-html
```

#### Javascript tests

```
gulp test
```<commit_msg>remove doc in readme<commit_after># AskOmics

[![Build Status](https://travis-ci.org/askomics/askomics.svg?branch=master)](https://travis-ci.org/askomics/askomics)
[![Coverage Status](https://coveralls.io/repos/github/askomics/askomics/badge.svg?branch=master)](https://coveralls.io/github/askomics/askomics?branch=master)
[![Docker Build](https://img.shields.io/docker/pulls/askomics/askomics.svg)](https://hub.docker.com/r/askomics/askomics/)
[![Documentation](https://readthedocs.org/projects/askomics/badge/?version=latest)](http://askomics.readthedocs.io/en/latest/?badge=latest)

![Askomics logo](static/askomics.png)

AskOmics is a visual SPARQL query interface supporting both intuitive data integration and querying while shielding the user from most of the technical difficulties underlying RDF and SPARQL

![Askomics Homepage](static/askomics_home.png)

## Documentation

All documentation, included installation instruction is [here](https://askomics.readthedocs.io/en/latest/)
{'fraction_non_alphanumeric': 0.15326947105372762, 'fraction_numerical': 0.017284464806330696, 'mean_word_length': 4.378499440089586, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 6, 'https://': 22, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 3, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6730014', 'n_tokens_mistral': 1773, 'n_tokens_neox': 1581, 'n_words': 344}