{"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_with_a_benchmark_row":[],"syntology_totals":{"read_at":"2026-09-25T09:33:49+00:00","papers_with_samples":0,"samples_harvested":0,"samples_ran":0,"samples_unverified":0,"pointer_only_for_licence":0,"papers_with_no_sample_that_ran":0,"note":"the per-paper counts above, summed; not a rate"},"papers_note":"The archive never published its papers-using-dataset list; these are papers with a leaderboard row on this dataset's benchmarks."}