Energetic Calculator for Ancient Buildings - EnCAB

How to Cite Project

EnCAB should not be cited as a website, but rather as a digital publication; the project has a DOI covering the project as a whole, and when major changes are made snapshots are made using Zenodo. In this way authors can cite the project in their publications with the assurance that future readers will be able to access the same information either in whatever current state the project is in or by going back to the Zenodo snapshots.

Citing the project as a whole can be done in two ways: through an Open Science Framework DOI (DOI 10.17605/OSF.IO/NMZXT) or, if one should need to refer to earlier versions of the project, through Zenodo DOIs linked to specific versions. The project is Open Source, published under the GNU-GPL 3.0 license. The bibliographical entries for the Open Science Framework project in the most common formats are as follows (please use this citation method and not the one proposed by Open Science Framework, which is meant for webpages):

The Zenodo DOIs, on the other hand, should be used only to cite specific versions of the project; this would primarily be useful when comparing two different versions of the EnCAB project. This link resolves to the latest version stored on Zenodo: latest version. On that page one finds links to earlier versions together with creation dates. To cite the Zenodo versions, please use the scheme above inserting the correct DOI instead of the suggested citation method proposed by Zenodo.

Who is the Author?

Who is the author of a digital publication of this type? In a sense, there are three authors, or levels of authorship. First, there is the author of the project as a whole, who is the editor of the digital publication but also the author of the explanatory texts and programming. Then there is the author who generates the individual algorithm, and finally there is the author of the text from which the algorithm is extracted. Each of these authors need to be reflected in the bibliographical reference. The following attempts to include each level of authorship by presenting the author of EnCAB as the editor, the authors of the algorithms as the authors of each entry within the edited work, and the authors of the works from which the algorithms were drawn as an integral part of the citation.

How to Cite Individual Algorithms

Individual Algorithms should be cited in the text as if figures of the Project, using "alg." instead of "fig.". Thus citing the algorithm derived from Robson's 1999 publication would be:

            Buccellati 2018, alg. Robson_1999_67

The 'Buccellati' here is the author of the algorithm, and does not refer to the editor of EnCAB as a whole. The editor is cited in the bibliographical entry for the algorithm:

            Buccellati, F. 2018. “EnCAB Alg. - Robson_1999_67.” In Energetic Calculator for Ancient Buildings – EnCAB, edited by F. Buccellati, 1.1. Charlottesville: OSF.

In this way EnCAB is cited as the source, with a reference to the specific algorithm used. To find the correct algorithm reference to use, see the "How to cite:" entry in each algorithm. Note that the version number, here 1.1, refers to the release of EnCAB which was used, and can be found either on the GitHub page for the project or by following the link to Zenodo above.