Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add GCN Circulars schema #154

Merged
merged 8 commits into from
Jul 8, 2024
Merged

Add GCN Circulars schema #154

merged 8 commits into from
Jul 8, 2024

Conversation

lpsinger
Copy link
Member

Description

Create a JSON Schema for GCN Circulars based on a recent example Circular.

Related Issue(s)

Fixes #152.

Testing

Added example for validation purposes.

"title": "GCN Circular",
"description": "GCN Circulars are rapid astronomical bulletins submitted by and distributed to community members worldwide. They are used to share discoveries, observations, quantitative near-term predictions, requests for follow-up observations, or future observing plans related to high-energy, multi-messenger, and variable or transient astrophysical events. See https://gcn.nasa.gov/circulars",
"properties": {
"eventId": {
Copy link
Member

@Vidushi-GitHub Vidushi-GitHub Jun 12, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about using event_name from Event Core Schema (https://github.com/nasa-gcn/gcn-schema/blob/v4.0.0/gcn/notices/core/Event.schema.json)?
It can be same property for both Circulars and Notices, helpful for correlation.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could, but we would need to migrate the whole GCN Circulars database if we changed field names.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ohh, may be one more translation layer can help later.
@jracusin what is your opinion keeping the name as available in Unified Schema or it's fine?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we need a translation layer. I agree with you, @Vidushi-GitHub, that this schema is not very consistent with GCN Notices. We should discuss if and how we should achieve this transition.

"type": "string",
"description": "Name, affiliation, and email address of the person who submitted the Circular, in the form `A. E. Einstein at IAS <[email protected]>`"
},
"submittedHow": {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about "submissionMethod"? sounds more appropriate

lpsinger and others added 2 commits June 13, 2024 14:11
gcn/circulars.schema.json Outdated Show resolved Hide resolved
gcn/circulars.schema.json Outdated Show resolved Hide resolved
},
"submitter": {
"type": "string",
"description": "Name, affiliation, and email address of the person who submitted the Circular, in the form `A. E. Einstein at IAS <[email protected]>`"

This comment was marked as resolved.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not any kind of standard.

gcn/circulars.schema.json Outdated Show resolved Hide resolved
gcn/circulars.schema.json Outdated Show resolved Hide resolved
@lpsinger lpsinger marked this pull request as draft June 17, 2024 18:13
@lpsinger
Copy link
Member Author

Capturing the consensus from our sprint call: let's include this schema that describes the existing GCN Circulars record structure in the next minor release, and then migrate names of fields in the next major release.

@lpsinger lpsinger marked this pull request as ready for review June 24, 2024 15:31
@jracusin jracusin merged commit 700167a into nasa-gcn:main Jul 8, 2024
1 of 2 checks passed
@lpsinger lpsinger deleted the circulars branch July 8, 2024 22:38
athish-thiru pushed a commit to athish-thiru/gcn-schema that referenced this pull request Sep 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add schema for GCN Circulars
5 participants