Category Archives: conferences

ASCL poster on software citation at ADASS XXXII


Are others using software you’ve written in their research and citing it as you want it to be cited? If not, this poster will help! Software can be cited in different ways, some good, and some not good at all for tracking and counting citations in indexers such as ADS and Google Scholar. Generally, indexers need to match citations to resources, such as journal articles, they ingest. There are several reasons why your code might not be cited well (in a trackable/countable way). One common reason is the lack of clear and explicit instructions on a code’s download site. Most astro code sites don’t list a preferred citation method! Make it easy for people to cite your software by listing a (good! trackable!) preferred citation method where others can easily find it. Creating a standard software metadata file, such as a CITATION.cff or codemeta.json, and adding it to the root of your code repo is easy to do with the ASCL’s metadata file creation overlay (see handout below), and will help out anyone wanting to give you credit for your computational method, whether it’s a huge carefully-written and tested package, or a short quick-and-dirty-but-oh-so-useful code.

#ADASSXXXI

Using the Astrophysics Source Code Library: Find, cite, download, parse, study, and submit

This morning, I gave a tutorial on the ASCL at ADASS XXXII, which is being held virtually from the University of Toronto and the University of Victoria. I’ll write more extensively about ADASS later this week; it is, as always, a fabulous conference with a lot of great work, talks, software, data, discussion, posters, chats, demos, tutorials… well, a lot! It’s my favorite astro conference.

But for now, slides from the tutorial and a link to the recording are below. Thanks to ADASS for accepting the proposal and to the participants for attending and for all the interesting (and occasionally scary!) comments and questions!

Slides (PDF)
Session (video)

ROSA2022: Reproducibility and Open Science in Astronomy workshop

This week, I’m attending and speaking at the ESO-sponsored Reproducibility and Open Science in Astronomy workshop. The first day was fabulous! The workshop runs through Thursday.

My talk is Opening the computational box: software sharing and the ASCL, and the abstract and links to resources mentioned in the talk are below.

Though computational methods are widely used in many disciplines, many researchers do not share the source code they develop, making their research difficult to verify and replicate. This presentation focuses on what software users and authors can do to share codes effectively, increase research reproducibility, and meet new requirements established by funders and journals. It will also cover how the Astrophysics Source Code Library (ASCL) improves the transparency of science by registering research code, its efforts to increase software findability, and how astronomers can get credit for their codes and better support the research record.

Slides (PDF)

Journals

Journal of Open Source Software (JORS)

Astronomy and Computing (A&C)

SoftwareX

Journal of Open Source Software (JOSS)

Computing and Software for Big Science

Research Notes of the AAS

Change leaders, guidelines, and tools

SciCodes/Nine Best Practices for Software Registries and Repositories

FORCE11/FORCE11 Software Citation Principles

Research Data Alliance/FAIR for Research Software (FAIR4RS) WG

CodeMeta/CodeMeta generator

CITATION file format (CFF)/CFF INIT

CiteAs

FAIR principles

Social coding sites and archival services

Bitbucket

GitLab

GitHub

Software Heritage

Figshare

Zenodo

Other resources and fun links

Asclepias

arXiv/arXiv Next Generation

DataCite

All ASCL entries in JSON

ASCL dashboard

Generating software metadata files from an ASCL entry:
codemeta.json example
CITATION.cff example

How many GitHub repos have CITATON.cff files/codemeta.json files?

WE20211030: This week in the ASCL

The ADASS conference took place this week. The ASCL presented a poster about SciCodes at the conference. Though ADASS took up most of my time, eight new code entries, three of them submitted by their authors, were assigned ASCL IDs and moved into production. I also wrote and submitted an abstract for an iPoster presentation at the AAS’s January 2022 meeting.

ASCL poster on SciCodes consortium at ADASS XXXI

Poster describing the SciCodes consortium and how it might be of interest to astronomers

The Astrophysics Source Code Library (ASCL ascl.net), started in 1999, is a free open registry of software used in refereed astronomy research. Over the past few years, it has spearheaded an effort to form a consortium of scientific software registries and repositories. In 2019 and 2020, ASCL contacted editors and maintainers of academic discipline and institutional software registries and repositories in math, biology, neuroscience, geophysics, remote sensing, and other fields to develop a list of best practices for research software registries and repositories. At the completion of that project, performed as a Task Force for a FORCE11 working group, members decided to form SciCodes as an ongoing consortium. This poster will cover the consortium’s work so far, what it is currently working on, what it hopes to achieve for making scientific research software more discoverable across disciplines, and how the consortium can benefit astronomers.

Download poster (PDF)

#ADASSXXXI

Resources for SIAM CSE21 presentation on Schrödinger’s Code

I am giving a presentation at the SIAM (virtual) Conference on Computational Science and Engineering today in a Minisymposium on Data-Driven Analysis of Scientific Software Quality, Availability, and Development Productivity to discuss research we published in 2018 and the relevance of our findings to scientific software availability. A link to the slides from the presentation is below, along with links to additional information.


Slides (PDF)

Paper: Schroedinger’s Code: A Preliminary Study on Research Source Code Availability and Link Persistence in Astrophysics
Data and code

Other studies mentioned:
Collberg C., Proebsting T. and Warren A. M. 2014 Repeatability and Benefaction in Computer Systems Research: A Study and a Modest Proposal, Tech. Rep. TR 14-04 (http://repeatability.cs.arizona.edu/v2/RepeatabilityTR.pdf)

Howison J. and Bullard J. 2016 Software in the scientific literature: Problems with seeing, finding, and using software mentioned in the biology literature, Journal of the Association for Information Science and Technology 67 2137

Mangul, S., Mosqueiro, T., Duong, D., Mitchell, K., Sarwal, V., Hill, B., Brito, J., Littman, R., Statz, B., Lam, A., Dayama, G., Grieneisen, L., Martin, L., Flint, J., Eskin, E., & Blekhman, R. 2018, A comprehensive analysis of the usability and archival stability of omics computational tools and resources, bioRxiv

Rewarding the effort involved

Funding
How to fund research software development
Essential Open Source Software for Science
DOE to Provide $12 Million for Research on Adapting Scientific Software to Run on Next-Generation Supercomputers

Recognition
Citations for software
FORCE11 Software Citation Principles
FORCE11 Software Citation Implementation Working Group
Software must be recognised as an important output of scholarly research

Career path
The Society of Research Software Engineering
US Research Software Engineer Association

Training

Better Scientific Software (BSSw)
SciCoder
Software Sustainability Institute
How to Professionally Develop Reusable Scientific Software—And When Not To

Changes in journal practices

In which journals should I publish my software?
Software with impact
An empirical analysis of journal policy effectiveness for computational reproducibility

Better support through technology

Tools for working with CITATION.cff files
Create a CodeMeta file
Getting a DOI for your code

The ASCL at the 237th meeting of the American Astronomical Society

It’s that time of year again, when astronomers’ hearts and wings turn to AAS for the winter AAS meeting. This year, however, the wings are virtual; like other conferences in this time of pandemic, the 237th meeting of the AAS is online. I’m very impressed with the online meeting space, which includes a conference center with different locations to visit, a virtual exhibit hall, an iPoster gallery, and many opportunities through Slack and thoughtfully-planned activities to enable and encourage interaction between attendees, exhibitors, and presenters, including the always great Open Mic event, a highlight of the winter meeting, on Wednesday evening.

Members of the ASCL are presenting two iPosters + (the “plus” is a short Zoom session about  the poster) and an oral presentation at this meeting.

On Monday, Siddha Mavuram, an UMD student hired to do development work for the ASCL for our NASA ADAP project, is doing an iPoster + presentation titled Come search the ASCL with our new API! I also have an iPoster + presentation on Monday called Life, the Universe and Everything… you ever wanted to know about the Astrophysics Source Code Library. Though our short talks, using our posters only as our visual aids, are on Monday, our posters are available all week.

On Tuesday, Peter Teuben is presenting results of our NASA ADAP project. Though Siddha is presenting part of the development work done for this project, Peter is sharing the overall results in his oral presentation Increasing the visibility of NASA astrophysics software through the ASCL, showing how this project has made it possible to search the ASCL and ADS for NASA software through the use of keywords and, on ADS, the doctype value software. You can see these results yourself on the ASCL and with an ADS search.

Because I very cleverly failed to realize that all the links I added to the slides for my iPoster wouldn’t work once I made those slides images (doh!), I provide a PDF of these slides for download below in which most, but alas not all, of the links work. Later this week, I’ll provide a full list of links in another post that will contain all of the resources and links the ASCL is presenting this week.

Slides for Peter’s oral presentation (PDF)

Slides for Alice’s ASCL iPoster slideshow (PDF)

Lightning talk at ADASS XXX: Making organizational software easier to find

The excellent ADASS XXX conference concluded yesterday. I missed meeting ADASS attendees face-to-face, but was delighted to spend time with them safely online, to learn about their projects and research, to talk about software and data, to share what the ASCL has been doing, and to meet old and new friends. The all-virtual conference was just about perfect; the technology set-up was excellent, providing opportunities to see sessions as they happened or at a later time on video, ask questions, comment on and discuss what was presented, and have one-on-one or small group video calls. The schedule was easy to keep track of, as one could subscribe to the schedule and get updates to it (mostly additions) immediately. Support was extremely responsive; an online Help Desk provided answers to queries almost immediately. There was even a conference photo!

Poster presenters were invited to record and upload a lightning talk — no more than three minutes — for their posters; two-minute lightning talks via Zoom were also arranged at the conference. The ASCL presented a poster on Making organizational software easier to find in ASCL and ADS; the hastily-put-together lightning talk presented at the conference for this poster is below.

ADASS attendee Simón Torres offered to download all the pre-recorded lightning talks and stream them during the conference, so a Poster Video Watching Party was scheduled for Wednesday afternoon. The stream was great fun to watch! It was interesting, too, to see all the different ways people presented their lightning talks.

What a great conference this was! I look forward to next year’s!

ASCL poster on NASA software project at ADASS XXX


Software is the most used instrument in astronomy, and organizations such as NASA and the Heidelberg Institute for Theoretical Physics (HITS) fund, develop, and release research software. NASA, for example, has created sites such as code.nasa.gov and software.nasa.gov to share its software with the world, but how easy is it to see what NASA has? Until recently, searching NASA’s Astrophysics Data System (ADS) for NASA’s astronomy software has not been fruitful. Through its ADAP program, NASA has funded the Astrophysics Source Code Library (ASCL ascl.net) to improve the discoverability of these codes. Adding institutional tags to ASCL entries makes it easy to find this software not only in the ASCL but also in ADS and other services that index the ASCL. This poster presentation covers the changes the ASCL has made as a result of this funding and how you can use the results of this work to better find organizational software in ASCL and ADS.

Download poster (PDF)

ASCL API poster at ADASS XXX

Poster about ASCL API
We have developed an API for the Astrophysics Source Code Library (ASCL) that enhances the ability of users to conduct complex and automated queries on ASCL indexed codes. The API is public and allows anyone to programmatically search and filter the ASCL software database via an HTTP request. For example, the search https://ascl.net/api/search/?q=%22supernova%22&fl=credit returns a list of authors with ASCL-indexed codes involving supernovae in JSON format. We will demonstrate the API and show its use in answering a researcher’s questions regarding the growth and usage of both interpreted and compiled languages in the database, gaining a more nuanced understanding of trends in astrophysics software development. Our findings confirmed a piece of conventional wisdom: that Python is growing in market share, while low level programming languages like C and C++ remain very popular. Further documentation for the API is available at https://github.com/teuben/ascl-tools/tree/master/API.

Siddha Mavuram (UMD), Alice Allen (ASCL/UMD), Robert J. Nemiroff (MTU), Judy Schmidt (ASCL), Peter J. Teuben (UMD)

Download poster (PDF)