morocco-communes 1.8.0__tar.gz

morocco_communes-1.8.0/.gitignore

@@ -0,0 +1,14 @@
+node_modules/
+.cache/
+dist/
+.DS_Store
+.superpowers/
+docs/
+.wrangler/
+packages/morocco-communes/dist/
+packages/morocco-communes-py/src/morocco_communes/data/
+packages/morocco-communes-py/src/morocco_communes/_version.py
+packages/morocco-communes-py/dist/
+__pycache__/
+*.egg-info/
+evals/results/

morocco_communes-1.8.0/LICENSE

@@ -0,0 +1,27 @@
+The code in this package is under the MIT License:
+
+Copyright (c) 2026 Ousama Ajebbar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The data (codes, names and population) comes from the Haut-Commissariat au Plan,
+Recensement Général de la Population et de l'Habitat 2024 and 2014, a government
+publication. HCP's terms of use allow reuse, commercial included, on CC BY 4.0 terms:
+credit the Haut-Commissariat au Plan and say what was changed.
+https://www.hcp.ma/Conditions-generales-d-utilisation-Version-1-0_a2194.html

morocco_communes-1.8.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.5
+Name: morocco-communes
+Version: 1.8.0
+Summary: Morocco's régions, provinces, cercles, communes and arrondissements, with the 2024 and 2014 census figures, offline
+Project-URL: Homepage, https://communes.pages.dev
+Project-URL: Documentation, https://communes.pages.dev/docs/python/
+Project-URL: Source, https://github.com/zkousama/morocco-communes
+Project-URL: Issues, https://github.com/zkousama/morocco-communes/issues
+Author: Ousama Ajebbar
+License-Expression: MIT
+License-File: LICENSE
+Keywords: administrative divisions,census,communes,hcp,maroc,morocco,recensement,rgph
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Sociology
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Provides-Extra: pandas
+Requires-Dist: pandas>=1.5; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# morocco-communes
+
+Morocco's 12 régions, 83 provinces and préfectures, 213 cercles, 1,503 communes and 41
+arrondissements, with HCP's codes, names in French and Arabic, the 2024 and 2014 census
+figures, and the establishments the 2024 census mapped. It reads from files inside the
+package, so it works offline.
+
+```sh
+pip install "morocco-communes[pandas]"
+```
+
+```python
+import morocco_communes as mc
+
+communes = mc.communes()                    # 1,503 rows
+communes[communes["region_code"] == "01"]   # the 146 in Tanger-Tétouan-Al Hoceima
+
+people = mc.indicators("people")            # the 2024 census, by unit, area and sex
+economy = mc.economy()                      # the establishments, by unit
+housing = mc.housing()                      # the urban dwellings, by unit
+```
+
+Every table is a pandas DataFrame. With `as_frame=False` it's a list of dicts instead, and
+then the package needs nothing but the standard library.
+
+## Tables
+
+| Call | Rows |
+|---|---|
+| `regions()`, `provinces()`, `cercles()`, `communes()`, `arrondissements()` | one per unit |
+| `indicators(subject, census)` | one per unit and area, and per sex for people |
+| `economy()` | one per unit, from the country down to the commune |
+| `housing()` | one per unit with an urban area, 784 of them |
+| `crosswalk()` | one per commune renumbered in 2015 |
+
+`indicators` takes `"people"` or `"households"`, and `census` `"2024"` or `"2014"`. The
+2024 census asks 73 of the 2014 questions the same way, so those columns subtract.
+
+`fields()` says what each column measures, with HCP's own heading for it and its unit, and
+for 2024 the concept HCP defines it under and its wording. It takes `"indicators"`,
+`"indicators2014"`, `"economy"` or `"housing"`. `sources()` gives each
+workbook's URL, its SHA-256 and the date it was read, and `version` is the dataset's.
+
+## Codes
+
+A unit is identified by its HCP code, and the code is the hierarchy: `01.511.01.0` is a
+commune of province `01.511`, in région `01`. Codes stay strings, so `code_digits` keeps
+the leading zeros that make it 9 digits wide.
+
+## What's elsewhere
+
+Boundaries, which communes border which, search, the urban centres and a commune lookup by
+point are in the [repository](https://github.com/zkousama/morocco-communes) and its API.
+Those all come from OpenStreetMap under ODbL, so they aren't in this package, and neither
+are the area and density fields derived from them. `data/v1/geometry/adjacency.csv` is the
+contiguity graph if you want one: `pandas.read_csv` takes it straight.
+
+## Licence
+
+The code is MIT. The data is the Haut-Commissariat au Plan's, from RGPH 2024 and RGPH
+2014, reusable on CC BY 4.0 terms: credit it and say what you changed.

morocco_communes-1.8.0/README.md

@@ -0,0 +1,61 @@
+# morocco-communes
+
+Morocco's 12 régions, 83 provinces and préfectures, 213 cercles, 1,503 communes and 41
+arrondissements, with HCP's codes, names in French and Arabic, the 2024 and 2014 census
+figures, and the establishments the 2024 census mapped. It reads from files inside the
+package, so it works offline.
+
+```sh
+pip install "morocco-communes[pandas]"
+```
+
+```python
+import morocco_communes as mc
+
+communes = mc.communes()                    # 1,503 rows
+communes[communes["region_code"] == "01"]   # the 146 in Tanger-Tétouan-Al Hoceima
+
+people = mc.indicators("people")            # the 2024 census, by unit, area and sex
+economy = mc.economy()                      # the establishments, by unit
+housing = mc.housing()                      # the urban dwellings, by unit
+```
+
+Every table is a pandas DataFrame. With `as_frame=False` it's a list of dicts instead, and
+then the package needs nothing but the standard library.
+
+## Tables
+
+| Call | Rows |
+|---|---|
+| `regions()`, `provinces()`, `cercles()`, `communes()`, `arrondissements()` | one per unit |
+| `indicators(subject, census)` | one per unit and area, and per sex for people |
+| `economy()` | one per unit, from the country down to the commune |
+| `housing()` | one per unit with an urban area, 784 of them |
+| `crosswalk()` | one per commune renumbered in 2015 |
+
+`indicators` takes `"people"` or `"households"`, and `census` `"2024"` or `"2014"`. The
+2024 census asks 73 of the 2014 questions the same way, so those columns subtract.
+
+`fields()` says what each column measures, with HCP's own heading for it and its unit, and
+for 2024 the concept HCP defines it under and its wording. It takes `"indicators"`,
+`"indicators2014"`, `"economy"` or `"housing"`. `sources()` gives each
+workbook's URL, its SHA-256 and the date it was read, and `version` is the dataset's.
+
+## Codes
+
+A unit is identified by its HCP code, and the code is the hierarchy: `01.511.01.0` is a
+commune of province `01.511`, in région `01`. Codes stay strings, so `code_digits` keeps
+the leading zeros that make it 9 digits wide.
+
+## What's elsewhere
+
+Boundaries, which communes border which, search, the urban centres and a commune lookup by
+point are in the [repository](https://github.com/zkousama/morocco-communes) and its API.
+Those all come from OpenStreetMap under ODbL, so they aren't in this package, and neither
+are the area and density fields derived from them. `data/v1/geometry/adjacency.csv` is the
+contiguity graph if you want one: `pandas.read_csv` takes it straight.
+
+## Licence
+
+The code is MIT. The data is the Haut-Commissariat au Plan's, from RGPH 2024 and RGPH
+2014, reusable on CC BY 4.0 terms: credit it and say what you changed.

morocco_communes-1.8.0/build_data.py

@@ -0,0 +1,104 @@
+"""
+Builds the Python package's data from data/v1: the units, the census figures for both
+censuses, the 2024 establishments and the crosswalk, gzipped so an install stays small.
+
+The two fields that come from OpenStreetMap, area and density, are left out of the
+communes table, as they are from the npm package. They're under ODbL, whose share-alike
+terms would then cover the package; everything here is census data, attributed.
+
+    python3 packages/morocco-communes-py/build_data.py
+"""
+
+import gzip
+import json
+import re
+import shutil
+from pathlib import Path
+
+HERE = Path(__file__).parent
+DATA = Path("data/v1")
+OUT = HERE / "src" / "morocco_communes" / "data"
+
+# source path under data/v1 -> path inside the package
+TABLES = {
+    "attributes/regions.csv": "attributes/regions.csv.gz",
+    "attributes/provinces.csv": "attributes/provinces.csv.gz",
+    "attributes/cercles.csv": "attributes/cercles.csv.gz",
+    "attributes/communes.csv": "attributes/communes.csv.gz",
+    "attributes/arrondissements.csv": "attributes/arrondissements.csv.gz",
+    "indicators/people.csv": "indicators/people.csv.gz",
+    "indicators/households.csv": "indicators/households.csv.gz",
+    "indicators/2014/people.csv": "indicators2014/people.csv.gz",
+    "indicators/2014/households.csv": "indicators2014/households.csv.gz",
+    "economy/establishments.csv": "economy/establishments.csv.gz",
+    "housing/dwellings.csv": "housing/dwellings.csv.gz",
+    "crosswalk/2014-2024.csv": "crosswalk/2014-2024.csv.gz",
+}
+DOCUMENTS = {
+    "indicators/fields.json": "fields/indicators.json",
+    "indicators/2014/fields.json": "fields/indicators2014.json",
+    "economy/fields.json": "fields/economy.json",
+    "housing/fields.json": "fields/housing.json",
+    "sources.json": "sources.json",
+}
+# Derived from OpenStreetMap, so out, along with the boundaries themselves.
+DROP = {"attributes/communes.csv": ["area_km2", "density_2024"]}
+
+
+def rows(path: Path):
+    """The file's lines, without the byte-order mark Excel wants."""
+    text = path.read_text(encoding="utf-8-sig")
+    return text.splitlines(keepends=True)
+
+
+def drop_columns(lines: list[str], columns: list[str]) -> list[str]:
+    """Takes named columns out of a CSV whose values never contain a comma or a quote."""
+    header = lines[0].rstrip("\r\n").split(",")
+    for name in columns:
+        if name not in header:
+            raise SystemExit(f"{name} is not a column of this file; its columns are {', '.join(header)}")
+    keep = [i for i, name in enumerate(header) if name not in columns]
+    out = []
+    for line in lines:
+        if '"' in line:
+            raise SystemExit("a quoted field: this needs a real CSV reader rather than a split")
+        fields = line.rstrip("\r\n").split(",")
+        out.append(",".join(fields[i] for i in keep) + "\n")
+    return out
+
+
+def main() -> None:
+    if not DATA.is_dir():
+        raise SystemExit(f"run this from the repository root; {DATA} is not there")
+    if OUT.exists():
+        shutil.rmtree(OUT)
+
+    for source, target in TABLES.items():
+        lines = rows(DATA / source)
+        if source in DROP:
+            lines = drop_columns(lines, DROP[source])
+        path = OUT / target
+        path.parent.mkdir(parents=True, exist_ok=True)
+        # mtime 0, so the same data builds the same bytes.
+        with gzip.GzipFile(path, "wb", mtime=0) as f:
+            f.write("".join(lines).encode("utf-8"))
+
+    for source, target in DOCUMENTS.items():
+        path = OUT / target
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps(json.loads((DATA / source).read_text(encoding="utf-8")), ensure_ascii=False), encoding="utf-8")
+
+    version = json.loads((DATA / "sources.json").read_text(encoding="utf-8"))["datasetVersion"]
+    declared = re.search(r'^version = "(.+)"$', (HERE / "pyproject.toml").read_text(encoding="utf-8"), re.M)
+    if not declared:
+        raise SystemExit("pyproject.toml has no version line")
+    if declared.group(1) != version:
+        raise SystemExit(f"pyproject.toml says {declared.group(1)}, the dataset is {version}; bump it deliberately")
+    (OUT.parent / "_version.py").write_text(f'"""Generated by build.py. Do not edit."""\n\n__version__ = "{version}"\n', encoding="utf-8")
+
+    total = sum(p.stat().st_size for p in OUT.rglob("*") if p.is_file())
+    print(f"python package: {len(TABLES)} tables and {len(DOCUMENTS)} documents, {total / 1024:.0f} KB, version {version}")
+
+
+if __name__ == "__main__":
+    main()

morocco_communes-1.8.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "morocco-communes"
+version = "1.8.0"
+description = "Morocco's régions, provinces, cercles, communes and arrondissements, with the 2024 and 2014 census figures, offline"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Ousama Ajebbar" }]
+keywords = ["morocco", "maroc", "communes", "census", "recensement", "rgph", "hcp", "administrative divisions"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Science/Research",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+  "Topic :: Sociology",
+  "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+pandas = ["pandas>=1.5"]
+
+[project.urls]
+Homepage = "https://communes.pages.dev"
+Documentation = "https://communes.pages.dev/docs/python/"
+Source = "https://github.com/zkousama/morocco-communes"
+Issues = "https://github.com/zkousama/morocco-communes/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/morocco_communes"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "LICENSE", "build_data.py", "pyproject.toml"]

morocco_communes-1.8.0/src/morocco_communes/__init__.py

@@ -0,0 +1,51 @@
+"""
+Morocco's administrative divisions and census figures, offline.
+
+    import morocco_communes as mc
+
+    mc.communes()                       # 1,503 rows, with 2024 and 2014 population
+    mc.indicators("people")             # the 2024 census, by unit, area and sex
+    mc.economy()                        # the establishments the 2024 census mapped
+    mc.housing()                        # the urban dwellings it counted
+
+Every table comes back as a pandas DataFrame, or as a list of dicts with as_frame=False,
+which needs nothing but the standard library. `fields()` says what each column measures.
+
+The figures are the Haut-Commissariat au Plan's, from RGPH 2024 and RGPH 2014. Credit it
+when you publish them. The boundaries are in the repository and its API instead: they come
+from OpenStreetMap under ODbL, and so are the area and density fields derived from them.
+"""
+
+from ._data import (
+    arrondissements,
+    cercles,
+    communes,
+    crosswalk,
+    economy,
+    fields,
+    housing,
+    indicators,
+    provinces,
+    regions,
+    sources,
+)
+from ._version import __version__
+
+#: The dataset's version, which is also the package's.
+version = __version__
+
+__all__ = [
+    "arrondissements",
+    "cercles",
+    "communes",
+    "crosswalk",
+    "economy",
+    "fields",
+    "housing",
+    "indicators",
+    "provinces",
+    "regions",
+    "sources",
+    "version",
+    "__version__",
+]

morocco_communes-1.8.0/src/morocco_communes/_data.py

@@ -0,0 +1,178 @@
+"""
+Reads the tables the package ships. Each one comes back as a pandas DataFrame, or as a
+list of dicts when pandas isn't installed or isn't wanted.
+
+The codes are strings and stay strings: 01.511.01.0 is a commune, and its padded form
+001511010 would lose its leading zeros as a number.
+"""
+
+from __future__ import annotations
+
+import csv
+import gzip
+import json
+from importlib import resources
+from typing import Any, Iterator
+
+__all__ = [
+    "regions",
+    "provinces",
+    "cercles",
+    "communes",
+    "arrondissements",
+    "indicators",
+    "economy",
+    "housing",
+    "crosswalk",
+    "fields",
+    "sources",
+]
+
+#: Columns that are identifiers rather than numbers, wherever they appear.
+CODES = frozenset(
+    {
+        "code",
+        "code_digits",
+        "region_code",
+        "province_code",
+        "cercle_code",
+        "commune_code",
+        "code_2024",
+        "code_2014",
+    }
+)
+
+CENSUSES = ("2024", "2014")
+SUBJECTS = ("people", "households")
+DICTIONARIES = ("indicators", "indicators2014", "economy", "housing")
+
+
+def _path(*parts: str):
+    return resources.files("morocco_communes").joinpath("data", *parts)
+
+
+def _header(name: str) -> list[str]:
+    with gzip.open(_path(name), "rt", encoding="utf-8") as f:
+        return next(csv.reader(f))
+
+
+def _cell(value: str) -> Any:
+    """A CSV cell as what it holds: a whole number, a decimal, or None for an empty one."""
+    if value == "":
+        return None
+    try:
+        return int(value)
+    except ValueError:
+        pass
+    try:
+        return float(value)
+    except ValueError:
+        return value
+
+
+def _dicts(name: str) -> list[dict[str, Any]]:
+    with gzip.open(_path(name), "rt", encoding="utf-8", newline="") as f:
+        return [{k: ((v or None) if k in CODES else _cell(v)) for k, v in row.items()} for row in csv.DictReader(f)]
+
+
+def _pandas():
+    try:
+        import pandas as pd
+    except ModuleNotFoundError as err:  # pragma: no cover - depends on the environment
+        raise ModuleNotFoundError(
+            "reading a table as a DataFrame needs pandas: pip install 'morocco-communes[pandas]', "
+            "or pass as_frame=False for a list of dicts"
+        ) from err
+    return pd
+
+
+def _frame(name: str):
+    pd = _pandas()
+    text = frozenset(_header(name)) & CODES
+    with gzip.open(_path(name), "rb") as f:
+        return pd.read_csv(f, dtype={column: "string" for column in text})
+
+
+def _table(name: str, as_frame: bool):
+    return _frame(name) if as_frame else _dicts(name)
+
+
+def regions(as_frame: bool = True):
+    """The 12 régions, with their 2024 population and how much they hold."""
+    return _table("attributes/regions.csv.gz", as_frame)
+
+
+def provinces(as_frame: bool = True):
+    """The 83 provinces, préfectures and préfectures d'arrondissements."""
+    return _table("attributes/provinces.csv.gz", as_frame)
+
+
+def cercles(as_frame: bool = True):
+    """The 213 cercles, which group the rural communes of a province."""
+    return _table("attributes/cercles.csv.gz", as_frame)
+
+
+def communes(as_frame: bool = True):
+    """The 1,503 communes, with their type, parents, and population in 2024 and 2014."""
+    return _table("attributes/communes.csv.gz", as_frame)
+
+
+def arrondissements(as_frame: bool = True):
+    """The 41 arrondissements of the 6 cities divided into them."""
+    return _table("attributes/arrondissements.csv.gz", as_frame)
+
+
+def indicators(subject: str = "people", census: str = "2024", as_frame: bool = True):
+    """
+    HCP's census figures: a row per unit and area for households, and per unit, area and
+    sex for people. `subject` is people or households, `census` 2024 or 2014.
+    """
+    if subject not in SUBJECTS:
+        raise ValueError(f"subject is people or households, not {subject!r}")
+    if census not in CENSUSES:
+        raise ValueError(f"census is 2024 or 2014, not {census!r}")
+    folder = "indicators" if census == "2024" else "indicators2014"
+    return _table(f"{folder}/{subject}.csv.gz", as_frame)
+
+
+def economy(as_frame: bool = True):
+    """The economic establishments the 2024 census mapped, a row per unit."""
+    return _table("economy/establishments.csv.gz", as_frame)
+
+
+def housing(as_frame: bool = True):
+    """
+    The urban housing stock the 2024 census counted, a row per unit that has one. It counts
+    dwellings rather than households, and only in towns, so a unit with no urban area has
+    no row.
+    """
+    return _table("housing/dwellings.csv.gz", as_frame)
+
+
+def crosswalk(as_frame: bool = True):
+    """The 207 communes renumbered in 2015, each 2024 code beside its 2014 one."""
+    return _table("crosswalk/2014-2024.csv.gz", as_frame)
+
+
+def fields(dataset: str = "indicators", as_frame: bool = True):
+    """
+    What each column of a table measures: its path, its label, HCP's own heading for it and
+    its unit. `dataset` is indicators, indicators2014 or economy.
+    """
+    if dataset not in DICTIONARIES:
+        raise ValueError(f"dataset is one of {', '.join(DICTIONARIES)}, not {dataset!r}")
+    document = json.loads(_path("fields", f"{dataset}.json").read_text(encoding="utf-8"))
+    rows = document["fields"] if "fields" in document else [*document["people"], *document["households"]]
+    return _pandas().DataFrame(rows) if as_frame else rows
+
+
+def sources() -> dict[str, Any]:
+    """Where the data came from: each workbook's URL, digest, licence and the date it was read."""
+    return json.loads(_path("sources.json").read_text(encoding="utf-8"))
+
+
+def _tables() -> Iterator[str]:
+    """Every table the package ships, for the tests."""
+    for folder in ("attributes", "indicators", "indicators2014", "economy", "housing", "crosswalk"):
+        for path in sorted(p.name for p in _path(folder).iterdir()):
+            yield f"{folder}/{path}"

morocco_communes-1.8.0/src/morocco_communes/_version.py

@@ -0,0 +1,3 @@
+"""Generated by build.py. Do not edit."""
+
+__version__ = "1.8.0"

morocco_communes-1.8.0/src/morocco_communes/data/fields/economy.json

@@ -0,0 +1 @@
+{"census": "2024", "source": {"id": "hcp-2024-establishments", "url": "https://www.hcp.ma/file/242672/"}, "fields": [{"path": "establishments.total", "column": "establishments_total", "topic": "establishments", "key": "total", "label": "Establishments mapped", "heading": "Nombre total des établissements géoréférencés", "unit": "establishments"}, {"path": "establishments.publicServices", "column": "establishments_public_services", "topic": "establishments", "key": "publicServices", "label": "Public service establishments", "heading": "Nombre d'établissements de services publics", "unit": "establishments"}, {"path": "establishments.nonProfit", "column": "establishments_non_profit", "topic": "establishments", "key": "nonProfit", "label": "Non-profit establishments, in premises of their own", "heading": "Nombre d'établissements à but non lucratif (Associations opérant dans des locaux indépendants)", "unit": "establishments"}, {"path": "establishments.weeklySouks", "column": "establishments_weekly_souks", "topic": "establishments", "key": "weeklySouks", "label": "Weekly souks in use", "heading": "Nombre de Souks hebodomadaires actifs", "unit": "souks"}, {"path": "establishments.business", "column": "establishments_business", "topic": "establishments", "key": "business", "label": "Businesses", "heading": "Nombre d'établissements à but lucratif (entreprises et leurs établissements hors secteur de l'agriculture)", "category": "Nombre d'établissements", "unit": "establishments"}, {"path": "establishments.jobs", "column": "establishments_jobs", "topic": "establishments", "key": "jobs", "label": "Permanent jobs in those businesses", "heading": "Nombre d'établissements à but lucratif (entreprises et leurs établissements hors secteur de l'agriculture)", "category": "Emplois permanents occupés par ces établissements", "unit": "jobs"}, {"path": "sector.industry", "column": "sector_industry", "topic": "sector", "key": "industry", "label": "Industry", "heading": "Nombre d'établissements à but lucratif : par secteur d'activité", "category": "Industrie", "unit": "establishments"}, {"path": "sector.construction", "column": "sector_construction", "topic": "sector", "key": "construction", "label": "Construction", "heading": "Nombre d'établissements à but lucratif : par secteur d'activité", "category": "Construction", "unit": "establishments"}, {"path": "sector.commerce", "column": "sector_commerce", "topic": "sector", "key": "commerce", "label": "Commerce", "heading": "Nombre d'établissements à but lucratif : par secteur d'activité", "category": "Commerce", "unit": "establishments"}, {"path": "sector.services", "column": "sector_services", "topic": "sector", "key": "services", "label": "Services", "heading": "Nombre d'établissements à but lucratif : par secteur d'activité", "category": "Services", "unit": "establishments"}, {"path": "size.1", "column": "size_1", "topic": "size", "key": "1", "label": "One person", "heading": "Nombre d'établissements à but lucratif : par classe d'emploi", "category": "un seul employé", "unit": "establishments"}, {"path": "size.2-3", "column": "size_2_3", "topic": "size", "key": "2-3", "label": "2 to 3 people", "heading": "Nombre d'établissements à but lucratif : par classe d'emploi", "category": "2 à 3", "unit": "establishments"}, {"path": "size.4-9", "column": "size_4_9", "topic": "size", "key": "4-9", "label": "4 to 9 people", "heading": "Nombre d'établissements à but lucratif : par classe d'emploi", "category": "4 à 9", "unit": "establishments"}, {"path": "size.10-49", "column": "size_10_49", "topic": "size", "key": "10-49", "label": "10 to 49 people", "heading": "Nombre d'établissements à but lucratif : par classe d'emploi", "category": "10 à 49", "unit": "establishments"}, {"path": "size.50+", "column": "size_50_plus", "topic": "size", "key": "50+", "label": "50 people and over", "heading": "Nombre d'établissements à but lucratif : par classe d'emploi", "category": "50 & +", "unit": "establishments"}, {"path": "founded.before1956", "column": "founded_before_1956", "topic": "founded", "key": "before1956", "label": "Before 1956", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "Avant 1956", "unit": "establishments"}, {"path": "founded.1956-1980", "column": "founded_1956_1980", "topic": "founded", "key": "1956-1980", "label": "1956 to 1980", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "1956-1980", "unit": "establishments"}, {"path": "founded.1981-1990", "column": "founded_1981_1990", "topic": "founded", "key": "1981-1990", "label": "1981 to 1990", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "1981-1990", "unit": "establishments"}, {"path": "founded.1991-2000", "column": "founded_1991_2000", "topic": "founded", "key": "1991-2000", "label": "1991 to 2000", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "1991-2000", "unit": "establishments"}, {"path": "founded.2001-2010", "column": "founded_2001_2010", "topic": "founded", "key": "2001-2010", "label": "2001 to 2010", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "2001-2010", "unit": "establishments"}, {"path": "founded.2011-2019", "column": "founded_2011_2019", "topic": "founded", "key": "2011-2019", "label": "2011 to 2019", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "2011-2019", "unit": "establishments"}, {"path": "founded.2020+", "column": "founded_2020_plus", "topic": "founded", "key": "2020+", "label": "2020 and later", "heading": "Nombre d'établissements à but lucratif : par classe de date de création", "category": "2020 et +", "unit": "establishments"}], "notes": {"counted": "Every establishment HCP's field teams found and put on the map during the 2024 census: a place of business, a public service, or an association in premises of its own.", "agriculture": "Farms are out. The workbook counts the establishments of every sector but agriculture.", "souks": "A weekly souk is a market that stands on one day of the week. It is counted on its own and is not part of the establishment total.", "jobs": "The jobs are the permanent ones the businesses hold, so seasonal and casual work is not in the figure.", "units": "The workbook counts the 6 cities with arrondissements by arrondissement rather than as one place. Each of those cities carries the sum of its own arrondissements, marked basis: arrondissement_sum, the way its 2014 population is. Every other figure is a row of HCP's."}}