@digital4better/data 1.3.72 → 1.3.74

package/README.md

@@ -12,13 +12,13 @@ Available as **JSON and CSV** for analysts, sustainability teams, researchers an
 | --- | --- |
 | Compare AI models, capabilities and estimated sizes | [AI models](./data/ai/README.md) |
 | Identify cloud regions, VM hardware and manufacturing impacts | [Cloud infrastructure](./data/cloud/README.md) |
-| Convert electricity consumption into environmental impacts | [Electricity factors](./data/factor) |
-| Explore electricity generation by geography and period | [Electricity mixes](./data/mix) |
-| Compare electricity production technologies | [Energy impacts](./data/energy) |
+| Convert electricity consumption into environmental impacts | [Electricity factors](./data/factor/README.md) |
+| Explore electricity generation by geography and period | [Electricity mixes](./data/mix/README.md) |
+| Compare electricity production technologies | [Energy impacts](./data/energy/README.md) |
 | Estimate building energy impacts | [Facility factors](./data/facility/README.md) |
 | Estimate employee travel impacts | [Transport factors](./data/transport/README.md) |
-| Model equipment power and manufacturing impacts | [Equipment references](./data/equipment) |
-| Match countries, subdivisions and estimated distances | [Geographic references](./data/country) |
+| Model equipment power and manufacturing impacts | [Equipment references](./data/equipment/README.md) |
+| Match countries, subdivisions and estimated distances | [Geographic references](./data/country/README.md) |
 
 ## Highlights
 
@@ -36,9 +36,7 @@ Regions, VMs, CPUs, accelerators and modeled hosts for AWS, Azure, GCP, Oracle,
 
 **Sources:** official catalogs from [AWS](https://docs.aws.amazon.com/ec2/latest/instancetypes/instance-types.html), [Azure](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/overview), [GCP](https://docs.cloud.google.com/compute/docs/machine-resource), [Oracle](https://docs.oracle.com/en-us/iaas/Content/Compute/References/computeshapes.htm), [OVHcloud](https://www.ovhcloud.com/en/public-cloud/prices/) and [Scaleway](https://www.scaleway.com/en/docs/instances/reference-content/instances-datasheet/), together with manufacturer specifications.
 
-Region indicators use provider environmental disclosures, including [AWS](https://sustainability.aboutamazon.com/aws-wue-pue.csv), [Microsoft](https://datacenters.microsoft.com/sustainability/efficiency/), [Google](https://cloud.google.com/sustainability/region-carbon), [Oracle](https://www.oracle.com/a/ocom/docs/corporate/citizenship/oracle-corp-citizenship-report-3941904.pdf), [OVHcloud](https://www.ovhcloud.com/sites/default/files/external_files/kpis_fy25.pdf) and [Scaleway](https://www.scaleway.com/en/docs/environmental-footprint/additional-content/calculation-values-reference/).
-
-Read the [cloud guide](./data/cloud/README.md) for units, allocation and assumptions. Hosts are calculation profiles, not a verified server inventory. Regional indicators have different reporting boundaries; zero can be a dataset convention rather than a measured absence of impact.
+The [cloud guide](./data/cloud/README.md) documents environmental disclosures, capacity units, host allocation and provider-specific assumptions.
 
 ### Electricity Mix And Impact Factors
 
@@ -46,7 +44,7 @@ Monthly and yearly data at world, continent, country and subdivision levels, wit
 
 **Sources:** [Ember](https://ember-energy.org/data/yearly-electricity-data/), [UNECE life-cycle assessments](https://unece.org/sed/documents/2021/10/reports/life-cycle-assessment-electricity-generation-options) and [academic literature](https://www.sciencedirect.com/science/article/pii/S0196890422008159#b0530).
 
-Historical territories absent from current source exports retain their previous reference series, with later values carried forward. These are not new observations; see [electricity provenance](./data/electricity-provenance.json). A renewable-only scenario with no eligible generation is unavailable, not zero-impact electricity.
+Read the [mix guide](./data/mix/README.md) for scenarios and historical references, and the [factor guide](./data/factor/README.md) for per-kWh calculations.
 
 ### Facility And Transport
 
@@ -56,7 +54,7 @@ Historical territories absent from current source exports retain their previous
 
 ### Equipment Reference Data
 
-[Equipment references](./data/equipment) support simplified power and manufacturing-impact calculations. [Geographic references](./data/country) support location matching and approximate distance calculations.
+[Equipment references](./data/equipment/README.md) support simplified power and manufacturing-impact calculations. [Geographic references](./data/country/README.md) support location matching and approximate distance calculations.
 
 **Sources:** Digital4Better modeling inputs, life-cycle assessment literature and [ISO country/subdivision conventions](https://www.iso.org/iso-3166-country-codes.html). Distances and equipment factors are reference estimates, not measurements of a specific deployment. See the [usage reference](./llms-full.txt) for their interpretation.
 
@@ -72,7 +70,7 @@ Choose JSON for structured data or CSV for spreadsheets and BI tools. Download f
 | Estimates and sources | Public specifications, observed configurations and calculation hypotheses have different evidential strength. |
 | Availability | Historical cloud offers and AI models remain listed after retirement. |
 
-The [complete reference](./llms-full.txt) documents schemas, all environmental indicators and units, examples and limitations. Source observation dates differ from file modification and package release dates.
+Each dataset guide documents its files, columns, units, sources and limitations. The [usage reference](./llms-full.txt) explains cross-dataset selection and provides examples. Source observation dates differ from file modification and package release dates.
 
 ## Documentation for AI Assistants
 
@@ -85,3 +83,7 @@ Corrections and documented sources are welcome: see [CONTRIBUTING.md](https://gi
 Published under the [Open Database License (ODbL)](./LICENCE). Preserve upstream attribution and notices where applicable.
 
 [Digital4Better](https://digital4better.com) · [fruggr](https://www.fruggr.io) · [GitHub](https://github.com/digital4better/data)
+
+### Versioned AI and cloud sources
+
+The [source registry](sources/catalog.json) and [maintenance guide](sources/README.md) describe publisher references, collection hints, attribution and source lifecycle for AI and the six cloud providers. Read them at the same commit or package version as the datasets. Entries retain specific metadata; shared attribution and verification rules are documented once in the guide. The [schema](sources/catalog.schema.json) distinguishes mandatory catalog/discovery traversal from references checked when used as evidence, with explicit coverage by provider and topic. Active status does not guarantee current availability. Transient collection errors are not stored in the registry.

package/data/cloud/README.md

@@ -124,7 +124,20 @@ Capacity numbers retain their source convention: **GB and GiB are not interchang
 
 Azure GB RAM exceptions include Dnsv6, Dnlsv6, Ensv6, HBv5, Esv7, Ebsv6, Ebdsv6, Ecasv6 and Ecadsv6. Local storage is GB for Lsv4, Lasv4 and Lasv5/Laosv5; GiB for Ddsv7, Dldsv7, Daldsv7, Dcadsv6, Famdsv7 and Faldsv7. TB/TiB totals are reduced to GB/GiB respectively.
 
-Region `pue` is a ratio, `wue` is L/kWh and `ref` is a fraction. Reporting boundaries differ: Google's CFE fraction is not interchangeable with renewable-energy matching. AWS `ref = 0` and Oracle `wue = 0` are dataset conventions, not verified absence of renewable energy or water use. See the [full reference](https://digital4better.github.io/data/llms-full.txt) for provider-specific rules.
+Region `pue` is a ratio, `wue` is L/kWh and `ref` is a fraction. Reporting boundaries differ: Google's CFE fraction is not interchangeable with renewable-energy matching. AWS `ref = 0` and Oracle `wue = 0` are dataset conventions, not verified absence of renewable energy or water use.
+
+### Regional Environmental References
+
+| Provider | Source and interpretation |
+| --- | --- |
+| AWS | [Regional PUE/WUE disclosures](https://sustainability.aboutamazon.com/aws-wue-pue.csv); retained 2024 reference values. REF remains zero by convention. |
+| Azure | [Datacenter efficiency disclosures](https://datacenters.microsoft.com/sustainability/efficiency/) and regional fact sheets, including curated historical values whose original PDFs may no longer be retrievable. |
+| GCP | [Regional carbon data](https://cloud.google.com/sustainability/region-carbon); CFE is used as the REF proxy. Previously derived water values remain pending clearer regional disclosures. |
+| Oracle | [Environmental reporting](https://www.oracle.com/a/ocom/docs/corporate/citizenship/oracle-corp-citizenship-report-3941904.pdf); uniform PUE 1.07 and provisional WUE zero are reference assumptions. |
+| OVHcloud | [FY25 environmental KPIs](https://www.ovhcloud.com/sites/default/files/external_files/kpis_fy25.pdf). |
+| Scaleway | [Calculation reference](https://www.scaleway.com/en/docs/environmental-footprint/additional-content/calculation-values-reference/) and datacenter impact reports. |
+
+Compare reporting periods and regional versus global boundaries before comparing providers. Lower PUE alone does not imply a lower total environmental impact.
 
 ## Methodology
 
@@ -202,7 +215,7 @@ Hardware references also use manufacturer specifications and, where explicitly i
 
 The manufacturing coefficients adapt Teads / Benjamin Davy's [article](https://medium.com/teads-engineering/building-an-aws-ec2-carbon-emissions-dataset-3f0fd76c98ac) and [Scope 3 Ratios spreadsheet](https://docs.google.com/spreadsheets/d/1DqYgQnEDLQVQm5acMAhLgHLD8xXCG9BIrk-_Nv6jF3k/edit), CC BY 4.0. Extensions and allocation rules are Digital4Better assumptions, not vendor-certified LCAs.
 
-For reproducibility, see the [calculation inputs](https://github.com/digital4better/data/blob/main/scripts/cloud-host-inputs.json), [calculator](https://github.com/digital4better/data/blob/main/scripts/cloud-hosts.cjs) and [hardware source evidence](https://github.com/digital4better/data/blob/main/scripts/cloud-embodied-audit-sources.json). Detailed changes remain in [Git history](https://github.com/digital4better/data/commits/main/data/cloud) and the [correction log](https://github.com/digital4better/data/blob/main/scripts/cloud-hardware-corrections.json).
+For reproducibility, see the [calculation inputs](https://github.com/digital4better/data/blob/main/sources/cloud/host-inputs.json), [calculator](https://github.com/digital4better/data/blob/main/scripts/cloud-hosts.ts) and [hardware source evidence](https://github.com/digital4better/data/blob/main/sources/cloud/host-evidence.json). The inputs drive recalculation; the evidence archive preserves dated observations and source hashes supporting the assumptions. Expected hardware values and their official references are checked by the [regression tests](https://github.com/digital4better/data/blob/main/site/tests/cloud-reference.test.cjs). Detailed before/after changes remain in [Git history](https://github.com/digital4better/data/commits/main/data/cloud).
 
 ## Limitations