Cite a factor
Numbers checked against the live data on
To cite a factor, copy the citation at the bottom of its factor page and paste it next to the line it covers. The citation starts with the library's credit line, which is what using the data obliges you to print and which names two parties: the publisher, and open-climate.ai. It ends with an address that opens the value you used.
Copy the factor citation#
- Open the factor page. Find a factor shows how.
- Click Cite at the top of the page, beside Copy value, or scroll to Cite this factor at the bottom.
- If you used another value than the one the page opens on, an earlier year say, step to it first. The citation names the value on screen.
- Click Copy citation. The button reads "Copied" for a moment.
- Paste the line into your methodology note, next to the activity it covers.
The citation is one line, in this order:
<publisher's credit>. Normalised by open-climate.ai, https://open-climate.ai/factors/libraries/<library>/ (<licence>). https://open-climate.ai/factors/<factor address>/?v=<value key>
For anthracite in ADEME's Base Carbone it reads:
Source ADEME, Base Carbone v23.11. Normalised by open-climate.ai, https://open-climate.ai/factors/libraries/ademe/ (CC BY 4.0). https://open-climate.ai/factors/ef-ademe-anthracite-fr-kg-well_to_wheel-7825b0a9/?v=efv1-66fa22977930eb6f76371a6d32358d67
- The publisher's credit comes first, in the publisher's own words. It names the edition you read when the publisher's wording does, as ADEME's "Base Carbone v23.11" does; EXIOBASE's reads "EXIOBASE 3 (Stadler et al.), CC BY-SA 4.0" and names none. See Editions and updates.
- "Normalised by open-climate.ai", with the library page's address, is open-climate.ai's half of the credit. The licence in brackets is open-climate.ai's own: see Credit open-climate.ai.
- The address is the factor's permanent page. Factor addresses do not change: an old address redirects to the current one.
?v=carries the key of the value on screen, so the address opens that same value again, the year included. It is thevalue_keythat Pin a factor value to a release reads a value back by.
The line carries no date: the address pins the value instead. It is word for word the citation column of an export. BibTeX, beside Copy citation, copies the same reference as an entry for a reference manager: the publisher as author, the factor as title, the edition and the publisher's record number as a note, the same address, and the day you copied it as urldate.
Watch out. The address opens the value it names only while that value is served. Once a new edition is loaded, the old key matches nothing, and the address opens the factor's current default value without a notice. Keep the number and the edition with the citation, and write any choice you made (an earlier year, market-based electricity, a flight without radiative forcing) beside it. Choosing between similar factors lists these choices.
Dates, and the old Dataset date#
A factor page prints no date in its citation. Citations copied from an earlier version of the page read differently: they began with "open-climate.ai" and the year window, and carried two dates, "Dataset" and "Retrieved". The Dataset date was a fixed date written into the site's own code, the same on every factor page: not a date from the publisher, not the day a value was loaded, and not a check of the number. The "last verified" date that ended the old line under the value was that same site date. Neither appears on a factor page now. Hold an old citation to its edition and its Retrieved date, never to its Dataset date.
These are the dates that do date something:
| The date | Where you find it | What it dates |
|---|---|---|
| The edition | The publisher's credit and Source and licence | The publisher's own release, such as Base Carbone v23.11 |
| Published | Source and licence on the factor page | The date the publisher gives the record |
| Loaded | The library's Versions section | The day open-climate.ai finished loading that edition |
urldate |
The BibTeX entry | The day you copied the citation |
The Loaded column is in the Versions section of each library page, beside the publisher's own date for the edition. A licence check carries its own date, on the rights card: see What can I do with this data?.
Two people citing the same factor months apart can hold the same address and different values. That is not a contradiction: the edition tells their two citations apart, and what a refresh changes says what can move under an address that stays the same. If the editions agree and the values do not, something is wrong: report it on the form at the foot of the library page, or with Report an error beside the citation.
To reproduce a number after an edition has moved, the address will not do it on its own. Keep the citation and the edition it names; keep the file the number came from; and, if you work in SQL, keep the value's key, the part after ?v=. Pin a factor value to a release sets out what to store. When two surfaces disagree is the same question for the API and the database, which do hand back an ingest stamp you can compare.
Add the library's credit line#
The credit has two halves: the publisher's, which almost every licence here requires, and open-climate.ai's, which the data terms require on every library. One line carries both, and the portal hands it to you ready to copy. A factor citation already starts with it; for the sources section of your report, take it from the library page:
- Open the Libraries list and click the library named at the top of the factor page.
- Go to the Open data section. Each Your rights card carries a Credit line, with a Copy credit line button. That line is the whole credit.
- If you took a file instead, the download dialog holds the same line under What this means, with Copy.
For ADEME Base Carbone the line reads: "Source ADEME, Base Carbone v23.11. Normalised by open-climate.ai, https://open-climate.ai/factors/libraries/ademe/ (CC BY 4.0)".
Watch out. The Licence section of the same library page prints a shorter line, also labelled "Credit line:", and so does Source and licence on a factor page, under "Credit it with this line". That one is the publisher's half on its own, in the publisher's own words: "Source ADEME, Base Carbone v23.11", or "EXIOBASE 3 (Stadler et al.), CC BY-SA 4.0" for EXIOBASE. It is the same text the API and the database carry in
attribution_text. Printing it alone credits the publisher and leaves out open-climate.ai, so take the longer line from the rights card, or add the second half to it yourself.
Always copy the line from the portal, the library page or the factor citation, never from a document like this one: it carries the edition you are actually citing, and it changes when the publisher releases a new one.
Print each library's credit line once, in the sources section of your report, even if you used many factors from it. Keep the citations with the individual lines.
Credit open-climate.ai#
The second half of the line is a condition, not a courtesy. The publisher licenses the values; open-climate.ai licenses the layer that makes them comparable, so the licence in the final parenthesis is open-climate.ai's and not the publisher's. That is why ADEME's line ends "(CC BY 4.0)" while ADEME publishes under its own terms, ademe-base-empreinte-terms. The tick in the download dialog, "I accept the open data terms, and I will credit the publisher and open-climate.ai.", is this obligation. The data terms are where it is stated: which licence covers which layer, why a copyleft library makes it CC BY-SA 4.0, and the two conditions that ride with it, a working hyperlink on a website and no implied endorsement.
What this page adds is where the credit goes, which depends on what you hand over:
- A report or an inventory. The whole line, once per library, in the sources section, with the address as a working link wherever the document is read on screen.
- A product or a dashboard that shows these values. Keep the publisher's credit where the values are shown, and link back to open-climate.ai from your site. The download dialog carries the wording to use, which for ADEME reads "Emission factors by open-climate.ai (https://open-climate.ai/factors/libraries/ademe/), from Source ADEME, Base Carbone v23.11 (ademe-base-empreinte-terms)". Its copy box hands that line over as plain text, address and all, so it pastes the same way into a document, a spreadsheet or a page of your own.
- A file you pass on. A library download carries the credit inside it, on its References sheet. An export carries it on every line, in the
citationcolumn: the library's credit line followed by the value's address. Keep that column when the file leaves your hands. The same credit over the API and in SQL says why the route you took the values out by does not change that.
What the licence adds#
The Your rights card lists the conditions under "Yes, if". The ones you meet most often:
- "you credit the publisher": almost every licence here. The credit line does it.
- "you say what you changed": the Creative Commons licences, CC BY 4.0 and CC BY-SA 4.0. If you converted a value to another unit, or used one open-climate.ai re-weighted from the publisher's figure (its Standardised facts then read "Re-weighted by open-climate.ai"), say so.
- "you share the result under the same licence": CC BY-SA 4.0, which EXIOBASE and Open CEDA are published under. Read the card before you publish results or hand on a file built on these values, and follow the full terms on what counts as sharing.
- "you imply no endorsement by the publisher": the UK Open Government Licence, which DESNZ publishes under.
- "you keep the values unchanged": statutory licences, such as the Spanish law MITECO publishes under.
Which library carries which condition is on its card, and the What I need to do filter on the Open data page answers it for every library at once.
These answers read the publisher's terms; they do not replace them. The card says so: "Not legal advice: the publisher's terms prevail." Its Full terms link opens the publisher's text. See licence tier, licences and Download the open data.
A cited line in practice#
For a line in your inventory, keep together:
- the activity and quantity from your data;
- the factor value and unit you multiplied by, and the GWP it is on, as the line under the value prints it ("GWP100 · AR6"), and whether open-climate.ai re-weighted it;
- any value choice you made (year, approach, grid mix, radiative forcing);
- the copied citation.
Then list the full credit line of each library you used in your sources, publisher first, open-climate.ai second. A reviewer can open each address and check the licence from there. The address opens the value it names only while that value is served, which is why you keep the edition and the number beside it: see Editions and updates, and Pin a factor value to a release for reading a superseded value back.
Next#
- Editions and updates: what the edition in the citation means, and what a refresh changes.
- The data terms: open-climate.ai's own licence on the layer, in full.
- Export to a spreadsheet: take many factors away at once, with a licence column.
- Read a factor page: where the citation sits on the page.