Skip to content

Commit 64d1348

Browse files
jo-muellerjo-mueller
committed
Add CFF citation support and contribution instructions
1 parent 7f1caa6 commit 64d1348

4 files changed

Lines changed: 212 additions & 0 deletions

File tree

‎ngff_spec/CITATION.cff‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
cff-version: 1.2.0
2+
message: Please cite the following works when using this project.
3+
abstract: >-
4+
A growing community is constructing a next-generation file format (NGFF) for
5+
bioimaging to overcome problems of scalability and heterogeneity. Organized by
6+
the Open Microscopy Environment (OME), individuals and institutes across
7+
diverse modalities facing these problems have designed a format specification
8+
process (OME-NGFF) to address these needs. Those community members have built
9+
the format itself – OME-Zarr – along with tools and data resources available
10+
today to increase FAIR access and remove barriers in the scientific process.
11+
The current momentum offers an opportunity to unify a key component of the
12+
bioimaging domain — the file format that underlies so many personal,
13+
institutional, and global data management and analysis tasks.
14+
title: Next-generation file format specification
15+
authors:
16+
- family-names: NGFF-community
17+
given-names: ''
18+
identifiers:
19+
- type: doi
20+
value: 10.1038/s41592-021-01326-w
21+
description: Original Nature Methods article (2021)
22+
- type: doi
23+
value: 10.1101/2023.02.17.528834v2
24+
description: OME-Zarr preprint (2023)
25+
keywords:
26+
- FAIR
27+
- community
28+
- bioimaging
29+
- data
30+
- cloud
31+
- format
32+
license: CC-BY-4.0
33+
url: https://ngff.openmicroscopy.org
34+
repository: https://github.com/ome/ngff-spec
35+
preferred-citation:
36+
type: article
37+
doi: 10.1038/s41592-021-01326-w
38+
journal: Nature Methods
39+
month: 11
40+
start: 1496
41+
end: 1498
42+
title: >-
43+
OME-NGFF: a next-generation file format for expanding bioimaging data-access
44+
strategies
45+
issue: 12
46+
volume: 18
47+
year: 2021
48+
authors:
49+
- given-names: Josh
50+
family-names: Moore
51+
orcid: https://orcid.org/0000-0003-4028-811X
52+
- given-names: Chris
53+
family-names: Allan
54+
- given-names: Sébastien
55+
family-names: Besson
56+
orcid: https://orcid.org/0000-0001-8783-1429
57+
- given-names: Jean-Marie
58+
family-names: Burel
59+
orcid: https://orcid.org/0000-0002-1789-1861
60+
- given-names: Erin
61+
family-names: Diel
62+
orcid: https://orcid.org/0000-0003-2526-3512
63+
- given-names: David
64+
family-names: Gault
65+
- given-names: Kevin
66+
family-names: Kozlowski
67+
- given-names: Dominik
68+
family-names: Lindner
69+
orcid: https://orcid.org/0000-0001-8038-1250
70+
- given-names: Melissa
71+
family-names: Linkert
72+
- given-names: Trevor
73+
family-names: Manz
74+
orcid: https://orcid.org/0000-0001-7694-5164
75+
- given-names: Will
76+
family-names: Moore
77+
orcid: https://orcid.org/0000-0002-7264-8338
78+
- given-names: Constantin
79+
family-names: Pape
80+
orcid: https://orcid.org/0000-0001-6562-7187
81+
- given-names: Christian
82+
family-names: Tischer
83+
orcid: https://orcid.org/0000-0003-4105-1990
84+
- given-names: Jason R.
85+
family-names: Swedlow
86+
orcid: https://orcid.org/0000-0002-2198-1958
87+
type: software
88+
repository-code: https://github.com/ome/ngff

‎ngff_spec/contribute.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,39 @@ jupyter book build ngff_spec
2828

2929
You'll find the built webpages under `_build/html`.
3030

31+
## First contribution
32+
33+
If you haven't contributed to the spec before,
34+
please add yourself as an author in the `ngff_spec/myst.yml` metadata file.
35+
This should look like this, for example:
36+
37+
```yaml
38+
- name: John A. Doe
39+
id: jdoe
40+
orcid: xxxx-xxxx-xxxx-xxxx
41+
github: jdoe
42+
affiliations:
43+
- id: key
44+
institution: ICSLDJ University
45+
city: Doeburg
46+
ror: https://ror.org/....
47+
- name: Jane Doe
48+
affiliations: key
49+
```
50+
51+
For more information see [myst documentation on author formatting](https://mystmd.org/guide/frontmatter#frontmatter-authors).
52+
53+
When you submit your first PR,
54+
make sure to rebuild the `CITATION.cff` file in the root of this repository.
55+
To do so, run the following command:
56+
57+
```bash
58+
cd ngff_spec/ && jupyter book build --cff
59+
```
60+
61+
Copy the generated `CITATION.cff` file from `ngff_spec/CITATION.cff` to the root of this repository
62+
and submit it along with your PR.
63+
3164
### Text format
3265

3366
Contributions should conform to [Semantic Line Breaks (SemBr)](https://sembr.org/),

‎ngff_spec/footer.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
2+
<div>
3+
Copyright © 2020-2025
4+
<a href="https://www.openmicroscopy.org/"><abbr title="Open Microscopy Environment">OME</abbr></a><sup>®</sup>
5+
(<a href="https://dundee.ac.uk/"><abbr title="University of Dundee">U. Dundee</abbr></a>).
6+
OME trademark rules apply.
7+
</div>

‎ngff_spec/myst.yml‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,90 @@ project:
1010
- format: pdf
1111
template: plain_latex_book
1212
output: exports/book.pdf
13+
- format: cff
14+
type: software
15+
identifiers:
16+
- type: doi
17+
value: 10.1038/s41592-021-01326-w
18+
description: Original Nature Methods article (2021)
19+
- type: doi
20+
value: 10.1101/2023.02.17.528834v2
21+
description: OME-Zarr preprint (2023)
22+
repository-code: 'https://github.com/ome/ngff'
23+
url: 'https://ngff.openmicroscopy.org'
24+
abstract: >-
25+
A growing community is constructing a next-generation file
26+
format (NGFF) for bioimaging to overcome problems of
27+
scalability and heterogeneity. Organized by the Open
28+
Microscopy Environment (OME), individuals and institutes
29+
across diverse modalities facing these problems have
30+
designed a format specification process (OME-NGFF) to
31+
address these needs. Those community members have built
32+
the format itself – OME-Zarr – along with tools and data
33+
resources available today to increase FAIR access and
34+
remove barriers in the scientific process. The current
35+
momentum offers an opportunity to unify a key component of
36+
the bioimaging domain — the file format that underlies so
37+
many personal, institutional, and global data management
38+
and analysis tasks.
39+
keywords:
40+
- FAIR
41+
- community
42+
- bioimaging
43+
- data
44+
- cloud
45+
- format
46+
license: CC-BY-4.0
47+
preferred-citation:
48+
type: article
49+
doi: "10.1038/s41592-021-01326-w"
50+
journal: "Nature Methods"
51+
month: 11
52+
start: 1496
53+
end: 1498
54+
title: "OME-NGFF: a next-generation file format for expanding bioimaging data-access strategies"
55+
issue: 12
56+
volume: 18
57+
year: 2021
58+
authors:
59+
- given-names: "Josh"
60+
family-names: "Moore"
61+
orcid: "https://orcid.org/0000-0003-4028-811X"
62+
- given-names: "Chris"
63+
family-names: "Allan"
64+
- given-names: "Sébastien"
65+
family-names: "Besson"
66+
orcid: "https://orcid.org/0000-0001-8783-1429"
67+
- given-names: "Jean-Marie"
68+
family-names: "Burel"
69+
orcid: "https://orcid.org/0000-0002-1789-1861"
70+
- given-names: "Erin"
71+
family-names: "Diel"
72+
orcid: "https://orcid.org/0000-0003-2526-3512"
73+
- given-names: "David"
74+
family-names: "Gault"
75+
- given-names: "Kevin"
76+
family-names: "Kozlowski"
77+
- given-names: "Dominik"
78+
family-names: "Lindner"
79+
orcid: "https://orcid.org/0000-0001-8038-1250"
80+
- given-names: "Melissa"
81+
family-names: "Linkert"
82+
- given-names: "Trevor"
83+
family-names: "Manz"
84+
orcid: "https://orcid.org/0000-0001-7694-5164"
85+
- given-names: "Will"
86+
family-names: "Moore"
87+
orcid: "https://orcid.org/0000-0002-7264-8338"
88+
- given-names: "Constantin"
89+
family-names: "Pape"
90+
orcid: "https://orcid.org/0000-0001-6562-7187"
91+
- given-names: "Christian"
92+
family-names: "Tischer"
93+
orcid: "https://orcid.org/0000-0003-4105-1990"
94+
- given-names: "Jason R."
95+
family-names: "Swedlow"
96+
orcid: "https://orcid.org/0000-0002-2198-1958"
1397
toc:
1498
- file: specification.md
1599
- file: examples.md

0 commit comments

Comments
 (0)