---
title: "Method: Sector and state directories"
url: https://tipsheet.markets/methods/directories/
description: "How tipsheet.markets computes sector and state directories: sources, start dates, checks and caveats."
updated: 2026-10-29
publisher: tipsheet (https://tipsheet.markets/)
cite: "tipsheet, “Method: Sector and state directories”, 29 October 2026, https://tipsheet.markets/methods/directories/"
---

[Methods](https://tipsheet.markets/methods/)

# Sector and state directories

One page per sector and per state, bringing together what Tipsheet already publishes about it: a sector’s stock returns beside the bank credit it gets, the foreign money in it, what mutual funds hold of it and how its companies are doing; a state’s investors beside its fund assets, prices, output and borrowing.

Code: `pipeline/tipsheet/compute/directories.py`, `publish/directories.py`, step `directories` (`steps/site_directories.py`). Crosswalks: `pipeline/tipsheet/reference/crosswalk/`. Tests: `pipeline/tests/test_directories.py`.

## What a directory page shows, and what it doesn’t

Every number on a directory page is read from a bundle the site already publishes, exactly as that bundle has it, with its own date. The page links each number to the topic it comes from. Nothing is computed from the join: no correlations across sources, no “leads”, no rankings of sectors or states that would imply a cause. A new claim of that kind needs pre-registration in `docs/research/site_calculations_spec.md` first.

Two things are added on top of the source numbers, and both are labelled:

- **A short history** (sparkline) where the source bundle carries the series’ own past: three years of month-ends for index returns, five years of P/E and P/B, the last 36 readings for credit growth and company results, twelve months for industrial output and wholesale prices.
- **A percentile against the series’ own history**, only where the source carries that history and the history passes the site’s floor (`publish/bundles.py`: five years and enough readings at the series’ frequency). Below the floor the bundle says why (`rank.why`, such as “26 readings since Mar 2024: too short to rank against”). Index valuation percentiles are the valuation page’s own, so the site shows one number. Credit growth is ranked on RBI’s growth comparable across the HDFC merger, as the credit pages do. Growth rates of company profits are not ranked (they swing too much); margins are.

## The canonical sectors

Twenty-one sectors (`sectors.csv`). The grain is NSE’s 22-sector level of its four-level industry classification (12 macro-economic sectors, 22 sectors, 59 industries, 197 basic industries; NSE Indices, *Industry Classification Structure*, March 2022). It’s the level where the market sources meet: NSDL’s FPI tables have used it since 30 April 2022, and the foreign-ownership estimate uses it. Four changes:

- **Financial Services is split** into **Banks** and **Non-bank financials** (NBFCs and housing financiers, insurers, brokers, exchanges, asset managers). Readers ask about banks by name. Sources that don’t split them (NSDL, PRIME) map to both as *partial*.
- **NSE’s “Services” is named Transport and logistics.** That’s mostly what it is (airlines, shipping, logistics, ports, airports). Its engineering and commercial services are noted as the difference.
- **Diversified, Utilities (other than power) and Forest Materials have no page.** Diversified has no single activity; the other two are too small to fill one.
- **Agriculture is added.** It has no listed sector (NSE files farm-input makers under chemicals and food processors under FMCG), but bank and NBFC lending to it and its value added are among the most-read numbers on the site.

## The states

All 28 states and 8 union territories (`states.csv`), with ISO 3166-2:IN codes as revised on 23 November 2023 (Chhattisgarh IN-CG, Odisha IN-OD, Telangana IN-TS, Uttarakhand IN-UK; the old codes are kept in `iso_previous`). History is explicit:

- **Telangana** from 2 June 2014. Before that, Andhra Pradesh means the undivided state.
- **Jammu and Kashmir** was a state including Ladakh until 30 October 2019. Both have been union territories since 31 October 2019.
- **Dadra and Nagar Haveli and Daman and Diu** merged on 26 January 2020. The two former territories are listed with an end date and a successor, and have no page.

`state_map.csv` holds every label a source prints that isn’t a state’s own name: old spellings (Orissa, Pondicherry, Uttaranchal), NSE’s “Keralam”, ”&” forms, a source’s misspelling (“Lakhswadeep”), the combined regions sources use to keep long series comparable, and the labels that are not places (Others, Army personnel, a generic “Union Territory”, SEBI’s regions, the national total).

## How matching works

`sector_map.csv` lists every category of every source that classifies by sector, keyed by the classification scheme it uses (`nse_index`, `nse_sector`, `nse_macro`, `fpi_group`, `amfi_industry`, `rbi_bank_credit`, `rbi_nbfc_credit`, `rbi_nbfc_sectors`, `rbi_companies`, `iip_industry`, `wpi_group`, `isp_subsector`, `gva_sector`, `pulse_indicator`, `capital_ownership`). Each row gives the canonical sector, a match quality and a note on what differs. A category may map to two sectors (Financial Services to Banks and to Non-bank financials), each *partial*. Labels are compared ignoring case, ”&” and punctuation.

What the match qualities mean to a reader:

- **Exact**: the source’s category is the sector as defined here (NSDL’s “Healthcare” is NSE’s Healthcare sector).
- **Close**: the same activity with a different boundary, or a sample of it. Nifty Bank is the largest banks, not all of them. RBI’s “Computer Software” is lending to software firms, listed or not. RBI’s “Food Products and Beverages” is the listed companies in its sample.
- **Partial**: the source’s category overlaps the sector but also holds other things, or covers only part of it. The page shows these with the source’s own label beside the number (“Share of foreign investors’ equity holdings (Financial Services)” on the Banks page) and the note. When a sector is pieced together from several partial categories of one source, only each part’s headline reading is shown, and partial readings get no sparkline.
- **None**: no honest counterpart, with the reason. Not shown. “None” is a valid answer: NSE’s Commodities macro-sector is chemicals, metals, building materials and paper together, and showing it on the Metals page would mislead.

Household loans for a sector’s products (home loans, vehicle loans, consumer-durable loans) are mapped *partial*, with a note that they measure demand for the sector rather than lending to it. Priority-sector categories map to *none*: they are a regulatory slice of loans already counted in the main categories.

## Known mismatches

- **Banks and non-bank financials** can’t be separated in NSDL’s FPI data or PRIME’s ownership data. On both pages those readings are all of Financial Services.
- **Capital goods, construction, power, telecom, textiles, consumer services and transport have no NSE sector index of their own.** Their stock bands use a partial theme index (Nifty Energy, Nifty India Defence, Nifty Transportation & Logistics, Nifty India Tourism) or have none.
- **Consumer services** is the thinnest page: only NSDL matches it exactly; fund holdings, RBI credit and company results match parts of it.
- **Bank and NBFC credit** is lending to every firm in the activity, listed or not. It is a different universe from the listed sector, and the notes say so.
- **RBI’s company results** cover listed non-financial companies only, by RBI’s own industry list. Paints, leather and jewellery are filed under consumer durables to follow NSE. Rubber products are filed under autos because tyre makers dominate the sample; this is a judgement, not a rule in RBI’s list.
- **IIP and WPI** follow the national industrial classification. “Other transport equipment”, mostly two-wheelers, goes to autos; “Motor vehicles” excludes two-wheelers.
- **Mining** (credit, IIP, GVA) includes coal, which NSE files under oil and gas. It maps to metals as *partial*.
- **States:** AMFI combines Andhra Pradesh with Telangana, and Jammu and Kashmir with Ladakh, so its long series compare. Both states’ pages show the combined figure as *partial*. NSE Market Pulse figures come from a PDF report; the readings say so.
- **State histories differ in length.**
  
  - Fund assets: March 2014 (AMFI).
  - The monthly signals: ten years published. Ranks leave out readings touching April 2020 to March 2022, as the states pages do.
  - CPI: January 2026, the first year-on-year reading on base 2024. The old base is not spliced on.
  - NSE accounts: 20 October 2026, Tipsheet’s first capture. NSE publishes only the current snapshot, and no past is rebuilt from registration flows.
  - Anything under five years carries no percentile until it passes the floor.
  - These are the sources’ current figures: a month MoSPI or a source has revised shows the revised number, not its first print.

## Checks

The step, and `tests/test_directories.py` against published bundles where they exist, fail when:

- a registered bundle carries a category no row maps (a source added or renamed one);
- a bundle not registered or listed in `IGNORED` looks like a sector or state breakdown (five or more known labels): a new source nobody mapped;
- the CSVs are inconsistent: an unknown sector or state, a *partial* without a note, a *none* without a reason, a malformed ISO code or slug, or a sector whose named primary index doesn’t map to it.

On failure nothing is published and the last published directories stand. The fix is a row in `reference/crosswalk/`. The CSVs are edited by hand and reviewed like code.

## Bundles

- `directories/sectors/<slug>`, `directories/states/<slug>`: the entry, its bands and readings (shape in `docs/rebuild/status/crosswalk.md`).
- `directories/sectors/index`, `directories/states/index`: every entry with a few headline readings (exact or close matches only), for the directory’s landing page.
- `directories/sectors/crosswalk`, `directories/states/crosswalk`: the crosswalk tables themselves, for readers and agents who want to check a match.

Slugs: lowercase ASCII with hyphens; states by full name (`tamil-nadu`), agreed with the taxonomy (`ia`).

This note is the repository file `docs/methods/directories.md`, rendered as-is.

---

Historical research, not investment advice. This page in HTML: https://tipsheet.markets/methods/directories/. Every published dataset: https://tipsheet.markets/data/v1/manifest.json. A map of the site: https://tipsheet.markets/llms.txt
