{"about":{"non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","site":"https://codewithpapers.app","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page","syntology":{"site":"https://syntology.ai","developers":"https://syntology.ai/developers","mcp":{"server":"https://syntology.ai/mcp","transport":"streamable-http","server_card":"https://syntology.ai/.well-known/mcp/server-card.json","auth":{"type":"trial token, no account","trial_token":"https://syntology.ai/api/oauth/trial/token","method":"POST","docs":"https://syntology.ai/developers"}},"have":"https://syntology.ai/api/graph/have?x=<method, arXiv id or title> (free, answers coverage only)","paper_base":"https://syntology.ai/paper/","atlas_base":"https://app.syntology.ai/?focus="},"machine_readable":[{"url":"https://codewithpapers.app/llms.txt","what":"the machine catalog: every machine-readable file, counted"},{"url":"https://codewithpapers.app/index/manifest.json","what":"paper-to-code index by arXiv id, with Syntology's counts"},{"url":"https://codewithpapers.app/search/manifest.json","what":"site search index (titles, authors) and its files"},{"url":"https://codewithpapers.app/download","what":"bulk files: Syntology's layer, described there"},{"url":"https://codewithpapers.app/build_manifest.json","what":"the build record: inputs, counts, exclusions, probes"}]},"url":"/dataset/openasp","name":"OpenAsp","full_name":null,"description_markdown":"# OpenAsp Dataset\r\n\r\n`OpenAsp` is an Open Aspect-based Multi-Document Summarization dataset derived from `DUC` and `MultiNews` summarization datasets.\r\n\r\n![Antarctica](antarctica.png)\r\n\r\n## Dataset Access\r\n\r\nTo generate `OpenAsp`, you require access to the `DUC` dataset which OpenAsp is derived from.\r\n\r\n### Steps:\r\n\r\n1. Grant access to DUC dataset by following NIST instructions [here](https://duc.nist.gov/data.html).\r\n   * you should receive two user-password pairs (for DUC01-02 and DUC06-07)\r\n   * you should receive a file named `fwdrequestingducdata.zip`\r\n2. Clone this repository by running the following command: `git clone https://github.com/liatschiff/OpenAsp.git`\r\n3. Optionally create a `conda` or `virtualenv` environment:\r\n\r\n```bash\r\nconda create -n openasp 'python>3.10,<3.11'\r\nconda activate openasp\r\n```\r\n\r\n4. Install python requirements, currently requires python3.8-3.10 (later python versions have issues with `spacy`)\r\n\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\n5. copy `fwdrequestingducdata.zip` into the `OpenAsp` repo directory\r\n\r\n6. run the prepare script command:\r\n\r\n```bash\r\npython prepare_openasp_dataset.py --nist-duc2001-user '<2001-user>' --nist-duc2001-password '<2001-pwd>' --nist-duc2006-user '<2006-user>' --nist-duc2006-password '<2006-pwd>'\r\n```\r\n\r\n7. load the dataset using [huggingface datasets](https://huggingface.co/docs/datasets/index)\r\n\r\n```python\r\nfrom glob import glob\r\nimport os\r\nimport gzip\r\nimport shutil\r\nfrom datasets import load_dataset\r\n\r\nopenasp_files = os.path.join('openasp-v1', '*.jsonl.gz')\r\n\r\ndata_files = {\r\n    os.path.basename(fname).split('.')[0]: fname\r\n    for fname in glob(openasp_files)\r\n}\r\n\r\nfor ftype, fname in data_files.copy().items():\r\n    with gzip.open(fname, 'rb') as gz_file:\r\n        with open(fname[:-3], 'wb') as output_file:\r\n            shutil.copyfileobj(gz_file, output_file)\r\n    data_files[ftype] = fname[:-3]\r\n\r\n# load OpenAsp as huggingface's dataset\r\nopenasp = load_dataset('json', data_files=data_files)\r\n\r\n# print first sample from every split\r\nfor split in ['train', 'valid', 'test']:\r\n    sample = openasp[split][0]\r\n\r\n    # print title, aspect_label, summary and documents for the sample\r\n    title = sample['title']\r\n    aspect_label = sample['aspect_label']\r\n    summary = '\\n'.join(sample['summary_text'])\r\n    input_docs_text = ['\\n'.join(d['text']) for d in sample['documents']]\r\n\r\n    print('* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *')\r\n    print(f'Sample from {split}\\nSplit title={title}\\nAspect label={aspect_label}')\r\n    print(f'\\naspect-based summary:\\n {summary}')\r\n    print('\\ninput documents:\\n')\r\n    for i, doc_txt in enumerate(input_docs_text):\r\n        print(f'---- doc #{i} ----')\r\n        print(doc_txt[:256] + '...')\r\n    print('* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *\\n\\n\\n')\r\n```\r\n\r\n### Troubleshooting\r\n\r\n1. **Dataset failed loading with `load_dataset()`** - you may want to delete huggingface datasets cache folder\r\n2. **401 Client Error: Unauthorized -** you're DUC credentials are incorrect, please verify them (case sensitive, no extra spaces etc)\r\n3. **Dataset created but prints a warning about content verification -** you may be using different version of `NLTK` or `spacy` model which affects the sentence tokenization process. You must use exact versions as pinned on `requirements.txt`.\r\n4. **IndexError: list index out of range -** similar to (3), try to reinstall the requirements with exact package versions. \r\n\r\n\r\n### Under The Hood\r\n\r\nThe `prepare_openasp_dataset.py` script downloads `DUC` and `Multi-News` source files, uses `sacrerouge` package to\r\nprepare the datasets and uses the `openasp_v1_dataset_metadata.json` file to extract the relevant aspect summaries and compile the final OpenAsp dataset.\r\n\r\n\r\n## License\r\n\r\nThis repository, including the `openasp_v1_dataset_metadata.json` and `prepare_openasp_dataset.py`, are released under [APACHE license](LICENSE).\r\n\r\n`OpenAsp` dataset summary and source document for each sample, which are generated by running the script, are licensed under the respective generic summarization dataset - [Multi-News license](https://github.com/Alex-Fabbri/Multi-News/blob/master/LICENSE.txt) and [DUC license](https://duc.nist.gov/data.html).","description_withheld":null,"homepage":"https://github.com/liatschiff/OpenAsp","introduced_date":"2023-12-07","introduced_date_note":null,"introduced_by":{"paper":"/paper/openasp-a-benchmark-for-multi-document-open","title":"OpenAsp: A Benchmark for Multi-document Open Aspect-based Summarization","first_author":"Shmuel Amar","url":null},"license":null,"modalities":[{"name":"Texts","url":"/datasets/modality/texts"}],"tasks":[{"name":"Text Summarization","url":"/task/text-summarization","datasets_with_task":"/datasets/task/text-summarization"},{"name":"Multi-Document Summarization","url":"/task/multi-document-summarization","datasets_with_task":"/datasets/task/multi-document-summarization"}],"languages":[{"name":"English","url":"/datasets/language/english"}],"variants":["OpenAsp"],"data_loaders":[],"num_papers_in_archive":2,"source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28"},"benchmarks":[],"papers":{"order":"date (newest first), then slug","population":"every paper with a leaderboard row on this dataset's benchmarks (the benchmark-backed subset): the archive's own papers-using-this-dataset list was never published, so this is not that list; num_papers_in_archive is the archive's own count","page":1,"pages_in_order":1,"rows_per_page":100,"shown":0,"of":0,"counts":{"papers_with_a_benchmark_row":0,"with_a_code_link":0,"where_syntology_ran_a_sample":0,"not_listed_spam_title":0,"listed":0,"listed_where_code_ran":0,"where_syntology_ran_a_sample_split":{"with_a_run_with_no_instrument_failure":0,"every_run_a_failure_of_syntologys_instrument":0,"listed_with_a_run_with_no_instrument_failure":0,"listed_every_run_a_failure_of_syntologys_instrument":0,"filter":{"states":["a run with no instrument failure","any run, instrument failures included"],"default":"a run with no instrument failure","note":"on the 'only where code ran' pages the default hides, in the browser, the rows where every run was a failure of Syntology's instrument; the second state shows them again. Rows are hidden, never re-ordered; these twins list every row"}},"definition":"distinct papers with at least one leaderboard row on this dataset's benchmarks; 'where Syntology ran a sample' counts papers with at least one harvested sample that ran, which is not a correctness claim"},"items":[],"full_list":"papers_with_a_benchmark_row: every listed paper, in this order"},"papers_with_a_benchmark_row":[],"papers_where_code_ran":0,"papers_where_code_ran_first_page":null,"papers_where_code_ran_caption":"We ran code from the paper's repository; we did not run it on this dataset or check it against this dataset's benchmarks.","pages":[],"row_route":"each paper's syntology object carries sample_list (this site's paper page, #ran), syntology_url (syntology.ai's page for the paper, only when that route probed live) and mcp (the agent call that lists the paper's harvested samples; not a verdict on the paper)","developers":"https://syntology.ai/developers","syntology_totals":{"read_at":"2026-10-05T00:36:11+00:00","papers_with_samples":0,"samples_harvested":0,"samples_ran":0,"samples_constructed":0,"samples_ran_checked":0,"samples_ran_instrument_failed":0,"samples_unverified":0,"pointer_only_for_licence":0,"papers_with_no_sample_that_ran":0,"papers_with_a_sample_that_ran":0,"papers_with_a_run_with_no_instrument_failure":0,"papers_where_every_run_was_an_instrument_failure":0,"note":"the per-paper counts of every listed paper (all pages), summed; not a rate"},"key_notes":{"samples_ran_checked":"legacy name, kept unchanged so existing readers do not break: it counts the samples that ran with no instrument failure (honoured, violated, and ran with no contract checked); it does not mean a contract was checked, and the pages print it as 'K with no instrument failure', not 'K checked'","samples_constructed":"a sub-count of the samples that ran, never subtracted from them and never a failure: an executed sample whose run returned an instance of its own class (fixture_out_type equals the entry name): the run built an object and did not compute a result (Syntology's RAN record, counts.constructed)"},"since_archive_judged":{"papers":0,"papers_placed":0,"judged_by":{"model":"a model","models_as_recorded":[],"from":"lb_rows_run_verified.jsonl: each record's `model` field (the extractor's call that wrote decisions[])"},"note":"a model's judgement from the paper's own tables that they report on this leaderboard, not a result: no value from a paper that was not placed is printed or carried here; papers counts each paper once over these leaderboards","backfill":"8,886 of 18,637 newer papers checked so far (733 more had nothing to place; 41 could not be read)","backfill_complete":false,"leaderboards":[]},"papers_note":"The archive never published its papers-using-dataset list; these are papers with a leaderboard row on this dataset's benchmarks.","record_sha256":"2af0f6755a917683ef3e88179b5fbef4864c0349fafcbf70fe9905a0d7b33c17","record_changed_at":"2026-10-05","record_changed_at_basis":"changed"}