/skipchunk

Extracts a latent knowledge graph from text and index/query it in elasticsearch or solr

Primary LanguagePythonMIT LicenseMIT

Skipchunk

Pypi

Travis build status

Documentation Status

Easy search autosuggest with NLP magic.

Out of the box it provides a hassle-free autosuggest for any corpus from scratch, and latent knowledge graph extraction and exploration.

Install

pip install skipchunk
python -m spacy download 'en_core_web_lg'
python -m nltk.downloader wordnet

You also need to have Solr or Elasticsearch installed and running somewhere!

The current Solr supported version is 8.4.1, but it might work on other versions.

The current Elasticsearch supported version is 7.6.2, but it might work on other versions.

Use It!

See the ./example/ folder for an end-to-end OSC blog load:

Solr

Start Solr first! Doesn't work with Solr cloud yet, but we're working on it. You'll need to start solr using skipchunk's solr_home directory for now.

Then run this: python solr-blog-example.py

Elasticsearch

Start Elasticsearch first!

Then run this: python elasticsearch-blog-example.py

Features

  • Identifies and groups the noun phrases and verb phrases in a corpus
  • Indexes these phrases in Solr or Elasticsearch for a really good out-of-the-box autosuggest
  • Structures the phrases as a graph so that concept-relationship-concept can be easily found
  • Meant to handle batched updates as part of a full stack search platform

Library API

Engine configuration

You need an engine_config, as a dict, to create skipchunk. The dict must contain the following entries

  • host (the fully qualified URL of the engine web API endpoint)
  • name (the name of the graph)
  • path (the on-disk location of stateful data that will be kept)
  • engine_name (either "solr" or "elasticsearch")

Solr engine config example

    engine_config_solr = {
        "host":"http://localhost:8983/solr/",
        "name":"osc-blog",
        "path":"./skipchunk_data",
        "engine_name":"solr"
    }

Elasticsearch engine config example

    engine_config_elasticsearch = {
        "host":"http://localhost:9200/",
        "name":"osc-blog",
        "path":"./skipchunk_data",
        "engine_name":"elasticsearch"
    }

Skipchunk Initialization

When initializing Skipchunk, you will need to provide the constructor with the following parameters

  • engine_config (the dict containing search engine connection details)
  • spacy_model="en_core_web_lg" (the spacy model to use to parse text)
  • minconceptlength=1 (the minimum number of words that can appear in a noun phrase)
  • maxconceptlength=3 (the maximum number of words that can appear in a noun phrase)
  • minpredicatelength=1 (the minimum number of words that can appear in a verb phrase)
  • maxpredicatelength=3 (the maximum number of words that can appear in a verb phrase)
  • minlabels=1 (the number of times a concept/predicate must appear before it is recognized and kept. The lower this number, the more concepts will be kept - so be careful with large content sets!)
  • cache_documents=False
  • cache_pickle=False

Skipchunk Methods

  • tuplize(filename=source,fields=['title','content',...]) (Produces a list of (text,document) tuples ready for processing by the enrichment.)
  • enrich(tuples) (Enriching can take a long time if you provide lots of text. Consider batching at 10k docs at a time.)
  • save (Saves to pickle)
  • load (Loads from pickle)

Graph API

After enrichment, you can then index the graph into the engine

  • index(skipchunk:Skipchunk) (Updates the knowledge graph in the search engine)
  • delete (Deletes a knowledge graph - be careful!)

After indexing, you can call these methods to get autocompleted concepts or walk the knowledge graph

  • conceptVerbConcepts(concept:str,verb:str,mincount=1,limit=100) -> list ( Accepts a verb to find the concepts appearing in the same context)
  • conceptsNearVerb(verb:str,mincount=1,limit=100) -> list ( Accepts a verb to find the concepts appearing in the same context)
  • verbsNearConcept(concept:str,mincount=1,limit=100) -> list ( Accepts a concept to find the verbs appearing in the same context)
  • suggestConcepts(prefix:str,build=False) -> list ( Suggests a list of concepts given a prefix)
  • suggestPredicates(prefix:str,build=False) -> list ( Suggests a list of predicates given a prefix)
  • summarize(mincount=1,limit=100) -> list ( Summarizes a core)
  • graph(subject:str,objects=5,branches=10) -> list ( Gets the subject-predicate-object neighborhood graph for a subject)

Credits

Developed by Max Irwin, OpenSource Connections https://opensourceconnections.com

All the blog posts contained in the example directory are copyright OpenSource Connections, and may not be used nor redistributed without permission