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

Citation? #70

Closed
biona001 opened this issue Aug 18, 2020 · 7 comments · Fixed by #71
Closed

Citation? #70

biona001 opened this issue Aug 18, 2020 · 7 comments · Fixed by #71

Comments

@biona001
Copy link

I'm using JLSO.jl for one of my research papers and I wish to cite this package. Is there a bibtex file or should I just make one myself?

@oxinabox
Copy link
Member

oxinabox commented Aug 18, 2020

you should make one youself.

Though @rofinn what do you think of submitting JLSO to JOSS?
It might be too basic a tool. I am not sure.

@rofinn
Copy link
Member

rofinn commented Aug 18, 2020

Okay, I had a quick look at JOSS and I don't think this package really fits. It isn't a very research focused tool even if we often use it for research datasets. I don't think JLD2.jl, CSV.jl or BSON.jl would really make sense either. That being said, it might not be a bad idea to add DOIs to our repos on GitHub regardless?

https://guides.github.com/activities/citable-code/

@biona001
Copy link
Author

You can get a DOI from Zenodo, but ok I'll make a bibtex myself, and update it if there's something else I should use.

@oxinabox
Copy link
Member

At least two similar packages for python have a JOSS paper: https://joss.theoj.org/papers/10.21105/joss.01115, https://joss.theoj.org/papers/10.21105/joss.00766

and in R land they will write a JOSS paper about anything: https://joss.theoj.org/papers/10.21105/joss.00185, https://joss.theoj.org/papers/10.21105/joss.00910,

@rofinn
Copy link
Member

rofinn commented Aug 19, 2020

Alright, I'm down to give it a shot if you want.

@oxinabox
Copy link
Member

Lets register for a Zenodo url now since will need one to post to JOSS anyway

@oxinabox
Copy link
Member

oxinabox commented Aug 19, 2020

Things a paper should cover:

  • Fundermentally 2 types of serialization (but no doubt exceptions exist)
    • Restricted types, Cross-language, Secure, robust to underling resentation code changes. like JSON, pure BSON, pure HDF5, CSV
    • Unrestricted types, Single-language, (generally) vulnerable to abitary code injection, not-robust to code changes. Like Julia Serializers, Python's Pickle, BSON.jl's julia specific extensions, JLD/JLD2 HDF5 extensions, MatLab's .mat HDF5 extension

One wants to use the later category as it is generally convient to be able to work with the types that are convient.
Though for long term archieve and sharing one needs to swap to the first category;
people often don't realise what is important to save til long after and might only have these short term serialized objects about.
Example: when asked to add extra information or plots to a publication after a round of review.
Making sure those can actually be openned when source code has changed is crucial for being able to access old work.

JLSO: container for these unresticted serialisers, that adds enough metadata that they can be sure to be able to be openned again.
Also adds compression.

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 a pull request may close this issue.

3 participants