Menu

Tree [6b51c4] master /
 History

HTTPS access


File Date Author Commit
 screenshots 2017-03-16 EG EG [63201d] screenshots
 server 2017-03-23 EG EG [6b51c4] websockets ok if you are surfing localhost; not...
 .gitignore 2017-02-05 EG EG [01ac2a] publish .gitignore
 LICENSE 2016-09-22 EG EG [798b19] first (re)commit
 NEEDS_DEBUGGING.txt 2017-03-15 EG EG [c88776] activepoll.sessionstate set on initialization: ...
 README.md 2017-03-08 EG EG [fe791a] calculatewordweights is its own file; dbHeadwor...
 hipparchiaserver_function_and_class_list.txt 2017-03-04 EG EG [27eed8] update functionlist
 run.py 2017-03-10 EG EG [7a90d6] SUPPRESSCOPYRIGHTNOTICE config option added; co...
 sample_config.py 2017-03-22 EG EG [563c24] max/min

Read Me

a front end to the database generated by HipparchiaBuilder

key features:
    searching
        search multiple corpora simultaneously
        build search lists with according to a variety of criteria
            search by date range
            add/exclude individual authors
            add/exclude individual author genres
            add/exclude individual works
            add/exclude individual work genres
            add/exclude individual passages
            add/exclude individual author locations
            add/exclude individual work provenances
            include/exclude spuria
            include/exclude undateable works
            remove items from the list by "dragging to trash"
            store and load search lists between sessions
            reset sessions to configurable defaults
        search syntax
            search with or without polytonic accents
            wildcard searching via regular expressions
            phrase searching: "κατὰ τὸ ψήφιϲμα", etc.
            proximity searching:
                within N lines or words
                not within N lines or words
        results
            results can be limited to a maximum number of hits
            results can be limited to one hit per author/work
            results can be sorted by name, date, etc
            can set amount of context to accompany results
    tools
        browser
            browse to any passage of your choice
            browse to any passage that occurs as a search result
            skim forwards or backwards in the browser
            click on words to acquire parsing and dictionary info for them
        dictionaries
            look up individual words in Greek or Latin
            get a morphological analysis of a Greek or Latin word
            get per corpus counts of the use of the word and its derivatives
            get a weighted chronological distribution of the word's use: mostly 'early', etc.
            get a weighted distribution by top 5 genres: show if a word predominantly 'epic', etc.
            get a summary of uses, senses, and quotes
            reverse lookup: 'unexpected' returns ἀδευκήϲ, ἀδόκητοϲ, ἀδόξαϲτοϲ, ἀελπτία, ...
            click to browse to passages cited in the lexical entries ('often' works)
        text maker
            build a text of a whole work or subsection of a work
            for example see Xenophon, Hellenica as a whole or just book 3 or just book 3, chapter 4
        index maker
            build an index for a whole author, work or subsection of a work
            for example see an index to all of Vergil or just the Aeneid or just Book 1 of the Aeneid

    local/contextual information
        searches give progress updates in percentage complete and time elapsed
        concordance builds give progress updates in percentage complete and time elapsed
        search lists can be inspected/hidden before execution
        local info on current author can be shown/hidden
        local info on genre lists can be shown/hidden
        show/hide the settings pane
        show/hide the complex criteria setter
        show/hide the complex search dialog boxes
        hover over interface items to get tooltips

    misc
        search will attempt to choose the most efficient strategy for any given situation
        text layout in results/browser/text maker sensitive to shifts in font face and size
        text layout via CSS: possible to modify the style sheet to suit your own tastes
        configurable defaults for most options
        unicode support of technical, rare, and exotic characters (that you can also search for: 𐆂,𐄒, 🜚)
        forward-compatible unicode: attempt to properly code characters which are not yet available in most fonts
        known unknowns: unhandled characters preserve their betacode messages in the metadata for future fixes

HipparchiaServer typically runs from the command line within a python virtual environment

% python ./run.py

then you point your browser at http://localhost:5000

alternately you can hook HipparchiaServer to something like nginx via uwsgi. that would create a different url

it would be rather unwise to expose this server to the whole internet. there are many elements to this unwisdom.

let us only mention one: there are security checks inside Hipparchia, but many queries can be generated that would
consume vast computational resources. what would happen if 1000 people tried to do that to your machine at once?
your inability to execute these queries on the tlg web site is partially a function of their choice to
adopt a one server and many clients model.

of course, most queries take <2s to execute. but servers live in the worst of all possible worlds.

instructions on how to use Hipparchia can be found by clicking on the '?' button if you can make it to the front page.

minimum software requirements:

    to launch HipparchiaServer
        python 3.6
            pip
            flask
            psycopg2
            bs4
        postgresql9.5

    to properly interact with HipparchiaServer via a browser
        jquery
        jquery-ui
        js-cookie
        dejavu fonts [strongly recommended, not a hard requirement]

please see HipparchiaBSD about setting up python and postgresql9.

the project pages for the other dependencies:

jquery:
http://jquery.com/download/

jquery-ui:
http://jqueryui.com/download/

js-cookie:
https://github.com/js-cookie/js-cookie/releases

dejavu fonts:
https://github.com/dejavu-fonts/dejavu-fonts/releases

see HipparchiaBSD for details on how to acquire and to install these items.
[details in 00_FreeBSD_initial_setup.txt or 01_macOS_hipparchia_installation.txt]

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.