{"id":21007011,"url":"https://github.com/abehandler/clioquery","last_synced_at":"2025-03-13T15:15:59.559Z","repository":{"id":41333056,"uuid":"480035052","full_name":"AbeHandler/ClioQuery","owner":"AbeHandler","description":"Supporting code for the paper \"ClioQuery: Interactive Query-Oriented Text Analytics for Comprehensive Investigation of Historical News Archives,\" forthcoming in ACM TiiS","archived":false,"fork":false,"pushed_at":"2022-06-30T16:47:33.000Z","size":12908,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-20T10:44:55.231Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AbeHandler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-10T14:02:59.000Z","updated_at":"2023-10-30T15:57:27.000Z","dependencies_parsed_at":"2022-08-27T19:23:11.603Z","dependency_job_id":null,"html_url":"https://github.com/AbeHandler/ClioQuery","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbeHandler%2FClioQuery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbeHandler%2FClioQuery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbeHandler%2FClioQuery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbeHandler%2FClioQuery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AbeHandler","download_url":"https://codeload.github.com/AbeHandler/ClioQuery/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243428433,"owners_count":20289317,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T08:54:28.347Z","updated_at":"2025-03-13T15:15:59.541Z","avatar_url":"https://github.com/AbeHandler.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClioQuery\n\nDirectories in the repo are listed below.\n\n### tex\n\n- The `tex` directory holds latex files for the paper \"ClioQuery: Interactive Query-Oriented Text Analytics for Comprehensive Investigation of Historical News Archives\" from Abram Handler, Narges Mahyar and Brendan O'Connor.\n\n### system\n\n- The `system` directory holds the code for the ClioQuery system, along with a small sample corpus of 25 New York Times editorials mentioning \"Salvador\". \n\n- To run the system you need to first create a conda environment with the required dependencies. To do this, run `cd system/webapp \u0026\u0026 conda env create -f environment.yml \u0026\u0026 conda activate cqdemo`. This will load an environment called `cqdemo`.\n\n- After you create the environment, run `py app.py` (you should be in `system/webapp` already) and then navigate to `http://localhost:5010/`. You should see the ClioQuery interface running on a small corpus of 25 New York Times editorials mentioning \"Salvador.\"\n\n- To load a new corpus, create a `.jsonl` file in the same format as `editorial_Salvador.jsonl` and run `py make_backend_indexes.py` to fill the `cache/` directory.\n\n- The demo in `webapp` uses a precompiled `app.js` file which implements the ClioQuery front-end. To rebuild or modify the front-end for the webapp you will need to run a javascript build system which will compile the `.jsx` files to a `app.js` file. That `app.js` file is then loaded into `webapp.py` and presented in the user interface. Javascript build systems change quickly and tend to require a lot of configuration, so this repo does not include instructions for configuring or setting up a build system. The `.jsx` files are located in `system/webapp/frontend`. \n\n### sec_8\n\n- `make_results.py` makes many quantitative results for Section 8. Many of these results are written to files \u0026 latex macros reported in the paper, so if you look at included files in the tex of section 8 (or macros defined in `packages_and_commands.tex`) you can see how numbers in the paper are generated.\n- `section_8_qual.jsonl` contains qualitative feedback reported in Section 8 of the paper. Worker IDs have been removed for anonymity. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabehandler%2Fclioquery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabehandler%2Fclioquery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabehandler%2Fclioquery/lists"}