# 台灣網絡科學教育（netscied.tw）

> 和台灣有關的網絡資料集（圖、超圖、單純複形、排名與成對比較等關聯資料），以及台灣各大學開設的網絡科學課程。
> Network datasets about Taiwan (graphs, hypergraphs, simplicial complexes, rankings and pairwise comparisons) and network-science courses taught at universities in Taiwan.

目前收錄 11 筆資料集（其中 3 筆由本站託管檔案）、28 門課程、7 項徵求中的資料。
Currently 11 datasets (3 with files hosted here), 28 courses and 7 wanted entries. Pages are in Traditional Mandarin with an English section; every record also has English titles.

## 網址 / URL patterns

- 資料集列表 Dataset table: https://netscied.tw/datasets/
- 單一資料集 One dataset: https://netscied.tw/datasets/<id>/ (Markdown: https://netscied.tw/datasets/<id>/index.md)
- 課程 Courses: https://netscied.tw/courses/ and https://netscied.tw/courses/<id>/ (Markdown: …/index.md)
- 資料許願池 Wanted data: https://netscied.tw/wanted/
- 搜尋 Search (needs JavaScript; use the API instead): https://netscied.tw/search/?q=<query>&type=datasets|courses
- 託管檔案 Hosted files: https://netscied.tw/data/<id>/<version>/ (immutable; each folder has SHA256SUMS)

## API（不需金鑰、靜態 JSON） / API (static JSON, no key)

- [API index](https://netscied.tw/api/v1/index.json): every file, record counts, API version, metadata license.
- [datasets.json](https://netscied.tw/api/v1/datasets.json) / datasets.csv: all published datasets in summary form; full records at /api/v1/datasets/<id>.json.
- [courses.json](https://netscied.tw/api/v1/courses.json) / courses.csv; full records at /api/v1/courses/<id>.json.
- [wanted.json](https://netscied.tw/api/v1/wanted.json), [news.json](https://netscied.tw/api/v1/news.json), [taxonomy.json](https://netscied.tw/api/v1/taxonomy.json) (every controlled vocabulary with Mandarin and English labels).
- JSON Schemas of these responses: each file in https://netscied.tw/api/v1/index.json names its schema in its `schema` field (for example https://netscied.tw/api/v1/schema/dataset-record.schema.json).
- catalog.json is internal (the browser's search payload); do not depend on its shape.

## 欄位 / Field meanings (dataset records)

- `id`: permanent ASCII slug; never reused. `status`: published, withdrawn (a tombstone with `withdrawn.date` and `withdrawn.reason`, no files) or renamed (`current_id`).
- `structure.kinds`: graph, hypergraph, simplicial-complex, cell-complex, ranking, pairwise-comparison, other-relational (the first is native). Properties are fields: `structure.directed`, `weighted` (+ `weight.meaning`), `partitions`, `layers`, `temporal.form`, `spatial.form`. `structure_text` says it in words.
- `semantics.node` and `semantics.link`: what a node and a link represent.
- `domains`: one to three of society, politics, culture, economy, transport, technology, information, life, health.
- `license.id`: SPDX id (for example OGDL-Taiwan-1.0, CC-BY-4.0), LicenseRef-*, NOASSERTION or NONE; `license.class`; `redistribution.may_redistribute` tells whether this site may host the files.
- `latest_version.files[]`: `url`, `format`, `bytes`, `sha256` for every hosted file; link-only records have `access[]` links to the upstream source instead.
- `personal_data.level`: none, public-role, private-individuals, sensitive.
- `citation.text` and `citation.bibtex`: ready to use; they cite the version URL until a version DOI exists. `attribution`: the text the license requires.

## 篩選 / How to filter

- By structure: datasets.json entries whose `kinds` includes "hypergraph".
- By domain: entries whose `domains[].id` is "transport".
- Hosted files only: `hosted` is true; may redistribute: `redistribution.may_redistribute` is true.
- Courses by category: courses.json `category.id` in network-science, social-network-analysis, graph-theory, graph-ml.

## 授權與引用 / License and citation

- Catalog metadata written by this site is CC0 1.0 (quoted license text and metadata copied from upstream sources keep their own terms). Each dataset keeps its own license; read `license` and `attribution` before reuse.
- Cite a dataset with its record's `citation` field; cite the site as 台灣網絡科學教育（netscied.tw）, https://netscied.tw/.

## 範例 / Examples

- [第10屆立法院委員提案連署超圖](https://netscied.tw/datasets/ly-bill-cosponsorship-10th/) — hypergraph, temporal: event times (day); CC-BY-4.0
- [臺北捷運站間起訖運量（月彙總）](https://netscied.tw/datasets/taipei-metro-od-monthly/) — graph, directed, weighted (trips in the month (sum of the source's daily hourly 人次 counts), unit trips), self-loops, temporal: snapshots (month); OGDL-Taiwan-1.0
- [中華職棒逐打席資料（野球革命開放資料）](https://netscied.tw/datasets/cpbl-play-by-play/) — bipartite graph (batters–pitchers), undirected, multi-edges, temporal: event times (day); ODC-By-1.0

## 其他 / Other

- [關於本站 About](https://netscied.tw/about/): contribution channels, takedown procedure, privacy notice.
- [Atom feed](https://netscied.tw/news/feed.xml), [sitemap](https://netscied.tw/sitemap.xml).
- Contact: tcy@inferweave.com