{
 "$schema": "https://aij.eddy3d.com/api/schemas/case.schema.json",
 "schema_version": "2.6.0",
 "data_version": "7ee0afb7cec8197e7edde0e7c282c8e6e9670b7cef003e6aa218c5a536817f48",
 "license": "CC-BY-4.0",
 "id": "E",
 "slug": "case-e",
 "title": "Case E — Niigata district",
 "summary": "Real district in Niigata at 1:250, before and after a 60 m high-rise and two 18 m mid-rises; pedestrian-height velocity ratio (thermistor), 16 wind directions.",
 "configuration": {
  "district": "Niigata City urban area near the Shinano River; dense low-rise stock (median top 6 m, max 30 m)",
  "scale": "1:250",
  "states": {
   "bc": "before construction (sites of A, B, C empty)",
   "ac": "after construction of A (60 m high-rise), B and C (18 m mid-rises)"
  },
  "new_buildings": {
   "A": "60 m high-rise, bbox x [-79.3, -49.1], y [-17.1, 18.3]",
   "B": "18 m, bbox x [41.5, 61.0], y [-18.5, 8.5]",
   "C": "18 m, bbox x [64.0, 83.5], y [-8.0, 19.0]"
  },
  "wind_directions": [
   "N",
   "NNE",
   "NE",
   "ENE",
   "E",
   "ESE",
   "SE",
   "SSE",
   "S",
   "SSW",
   "SW",
   "WSW",
   "W",
   "WNW",
   "NW",
   "NNW"
  ],
  "wind_directions_deg": [
   0.0,
   22.5,
   45.0,
   67.5,
   90.0,
   112.5,
   135.0,
   157.5,
   180.0,
   202.5,
   225.0,
   247.5,
   270.0,
   292.5,
   315.0,
   337.5
  ],
  "measurement_height_m": 2.0,
  "measurement_height_note": "2 m full scale = 0.008 m model scale",
  "points": 80,
  "values": 2560,
  "Re": 17000,
  "normalisation": "velocity ratio = mean scalar speed at 2 m / inflow velocity at 15.9 m (the Niigata meteorological station height); U(15.9 m) = 0.504531 x UR = 3.935 m/s with UR = 7.8 m/s at ZR = 250 m",
  "instrument": "thermistor anemometer, 100 Hz, 60 s per point, mean scalar wind speed",
  "tunnel": "Niigata Institute of Technology, Kashiwazaki"
 },
 "configurations": [
  {
   "config": "bc",
   "wind_directions": [
    "N",
    "NNE",
    "NE",
    "ENE",
    "E",
    "ESE",
    "SE",
    "SSE",
    "S",
    "SSW",
    "SW",
    "WSW",
    "W",
    "WNW",
    "NW",
    "NNW"
   ],
   "points_per_direction": 80
  },
  {
   "config": "ac",
   "wind_directions": [
    "N",
    "NNE",
    "NE",
    "ENE",
    "E",
    "ESE",
    "SE",
    "SSE",
    "S",
    "SSW",
    "SW",
    "WSW",
    "W",
    "WNW",
    "NW",
    "NNW"
   ],
   "points_per_direction": 80
  }
 ],
 "quantities": [
  "velocity_ratio"
 ],
 "units": {
  "length": "m (FULL scale)",
  "velocity_ratio": "dimensionless"
 },
 "frame": {
  "origin": "centre of the reproduced area, ground plane",
  "x": "+x EAST (full-scale metres)",
  "y": "+y NORTH (compass rose in MP_caseE.png)",
  "z": "+z up; all points at z = 2.0",
  "wind_direction_rotation": "meteorological FROM-direction, clockwise from north; the compass name is the direction the wind comes from (N = 0 deg blows toward -y, E = 90 deg toward -x). This case keeps its geographic frame instead of '+x along the wind' because the district is real and its coordinates are the data's.",
  "lateral_sign_applied": 1,
  "coordinate_scale_applied": 1.0
 },
 "inflow_fit": {
  "method": "the workbook publishes z/ZR, U/UR, k/UR^2 with ZR = 250 m, UR = 7.8 m/s and epsilon = Cmu^0.5 k dU/dz (Cmu = 0.09); de-normalised to full-scale metres and m/s here",
  "U_ref_15_9m_m_s": 3.935,
  "log_law": "does not fit: kappa = 0.41 fits reach 5.3-9.4 % max error over the relevant height range and overshoot U(15.9 m) by 4-7 %",
  "power_law_exponent": {
   "ground_to_60m": 0.158,
   "whole_profile": 0.201
  },
  "note": "derived during scoping, not published by AIJ"
 },
 "approach_flow": {
  "source": "raw/cases/case-e/LF_caseE.xls [sheet Inflow]",
  "units": {
   "z": "m",
   "U": "m/s",
   "k": "m^2/s^2"
  },
  "rows": [
   {
    "z": 1.25,
    "U": 2.847,
    "k": 0.48672
   },
   {
    "z": 2.5,
    "U": 3.042,
    "k": 0.5475599999999999
   },
   {
    "z": 5.0,
    "U": 3.2603999999999997,
    "k": 0.5475599999999999
   },
   {
    "z": 7.5,
    "U": 3.4086,
    "k": 0.5475599999999999
   },
   {
    "z": 12.5,
    "U": 3.7674,
    "k": 0.6083999999999999
   },
   {
    "z": 25.0,
    "U": 4.360200000000001,
    "k": 0.6083999999999999
   },
   {
    "z": 50.0,
    "U": 5.109,
    "k": 0.5475599999999999
   },
   {
    "z": 75.0,
    "U": 5.694,
    "k": 0.48672
   },
   {
    "z": 100.0,
    "U": 6.162,
    "k": 0.42588000000000004
   },
   {
    "z": 150.0,
    "U": 6.9654,
    "k": 0.36504
   },
   {
    "z": 200.0,
    "U": 7.394399999999999,
    "k": 0.24336
   },
   {
    "z": 250.0,
    "U": 7.8,
    "k": 0.12168
   }
  ],
  "csv": {
   "url": "https://aij.eddy3d.com/api/cases/E/approach_flow.csv?v=4971944cd8e9",
   "path": "cases/E/approach_flow.csv",
   "media_type": "text/csv",
   "bytes": 351,
   "sha256": "4971944cd8e9e09965961f6fd54627806708c04899f49b96df2f0efa229c4170"
  }
 },
 "inflow": {
  "benchmark_data": {
   "approach_flow_csv": {
    "url": "https://aij.eddy3d.com/api/cases/E/approach_flow.csv?v=4971944cd8e9",
    "path": "cases/E/approach_flow.csv",
    "media_type": "text/csv",
    "bytes": 351,
    "sha256": "4971944cd8e9e09965961f6fd54627806708c04899f49b96df2f0efa229c4170"
   },
   "columns": [
    "z",
    "U",
    "k"
   ],
   "units": {
    "z": "m",
    "U": "m/s",
    "k": "m^2/s^2"
   },
   "rows": 12,
   "fit": {
    "method": "the workbook publishes z/ZR, U/UR, k/UR^2 with ZR = 250 m, UR = 7.8 m/s and epsilon = Cmu^0.5 k dU/dz (Cmu = 0.09); de-normalised to full-scale metres and m/s here",
    "U_ref_15_9m_m_s": 3.935,
    "log_law": "does not fit: kappa = 0.41 fits reach 5.3-9.4 % max error over the relevant height range and overshoot U(15.9 m) by 4-7 %",
    "power_law_exponent": {
     "ground_to_60m": 0.158,
     "whole_profile": 0.201
    },
    "note": "derived during scoping, not published by AIJ"
   },
   "note": "the measured profile and the fit of it are the benchmark's data as cleaned here; everything under `recommended` is a choice"
  },
  "recommended": {
   "status": "RECOMMENDED by this repository (not part of the benchmark): no log law fits this case (inflow_fit says why); use the measured approach-flow profile as a tabulated inlet (approach_flow.csv). Any inlet may be submitted; say which in submission.yaml",
   "profile": "U(z) and, where published, k(z) tabulated from approach_flow.csv; epsilon = Cmu^0.5 k dU/dz where k is published, else from your own closure",
   "kappa": 0.41,
   "Cmu": 0.09,
   "U_ref_m_s": null,
   "z_ref_m": null,
   "openfoam": "fixedProfile (OpenFOAM.org) with the table, or timeVaryingMappedFixedValue: cases/{id}/inflow_openfoam.txt holds the table"
  },
  "flow_direction": {
   "convention": "geographic_x_east_y_north",
   "meaning": "meteorological FROM-direction theta, clockwise from north: flowDir (-sin theta, -cos theta, 0)",
   "wind_directions_deg": [
    0.0,
    22.5,
    45.0,
    67.5,
    90.0,
    112.5,
    135.0,
    157.5,
    180.0,
    202.5,
    225.0,
    247.5,
    270.0,
    292.5,
    315.0,
    337.5
   ]
  },
  "eddy3d_runs": [
   {
    "run_id": "E.openfoam12-realizableKE.SW",
    "engine": "openfoam12-realizableKE",
    "inlet": "manual (the workbook's tabulated profile, ZR 250 m, UR 7.8 m/s)"
   },
   {
    "run_id": "E.ml-surrogate",
    "engine": "ml-surrogate",
    "scale": 0.9
   }
  ],
  "domain": "the extents, blockage and cell sizes of Eddy3D's domains are not in its snapshots and are not stated here; mesh.cells and the scale are, where the snapshot has them"
 },
 "points": {
  "url": "https://aij.eddy3d.com/api/cases/E/points.json",
  "csv": {
   "url": "https://aij.eddy3d.com/api/cases/E/points.csv?v=e6e89432e706",
   "path": "cases/E/points.csv",
   "media_type": "text/csv",
   "bytes": 164232,
   "sha256": "e6e89432e706de1b807258178150dfa0376f19caa558d2c7f8106778422c11d8"
  },
  "source": "clean/cases/E/points.csv",
  "rows": 2560,
  "distinct_points": 80,
  "columns": [
   "point_id",
   "config",
   "instrument",
   "wind_direction",
   "wind_direction_deg",
   "x",
   "y",
   "z",
   "velocity_ratio",
   "campaign"
  ],
  "counts": {
   "config": {
    "ac": 1280,
    "bc": 1280
   },
   "instrument": {
    "thermistor": 2560
   },
   "wind_direction_deg": {
    "0.0": 160,
    "112.5": 160,
    "135.0": 160,
    "157.5": 160,
    "180.0": 160,
    "202.5": 160,
    "22.5": 160,
    "225.0": 160,
    "247.5": 160,
    "270.0": 160,
    "292.5": 160,
    "315.0": 160,
    "337.5": 160,
    "45.0": 160,
    "67.5": 160,
    "90.0": 160
   }
  },
  "nulls": {},
  "bbox_min": [
   -133.0,
   -94.0,
   2.0
  ],
  "bbox_max": [
   125.0,
   112.0,
   2.0
  ]
 },
 "probes": {
  "csv": {
   "url": "https://aij.eddy3d.com/api/cases/E/probes.csv?v=e248607ca6fe",
   "path": "cases/E/probes.csv",
   "media_type": "text/csv",
   "bytes": 177771,
   "sha256": "e248607ca6fe771edd8b9f4366b22d483f6383540cc6d220a162ad159ffe3669"
  },
  "rows": 2560,
  "columns": [
   "point_id",
   "config",
   "campaign",
   "instrument",
   "run",
   "wind_direction_deg",
   "x",
   "y",
   "z",
   "scored_as"
  ],
  "columns_meaning": "the key columns of a scored file (point_id with config, campaign, instrument, run and wind_direction_deg as the case has them), x, y, z in m (case frame), and scored_as: the families the row is scored in (vector, k, thermistor_bracket, concentration, theta, joined by +)"
 },
 "scoring": {
  "U_ref_m_s": null,
  "U_ref_meaning": "the table holds Vs/U(15.9 m) (U(15.9 m) = 3.935 m/s); give ratios",
  "theta": null,
  "scored_as": {
   "vector": "U, V, W and the speed |U| against the split-fibre, LDV or hot-wire components (velocity.U, velocity.V, velocity.W, speed)",
   "k": "the turbulent kinetic energy (k)",
   "thermistor_bracket": "a mean scalar speed (thermistor, cup or sonic anemometer) against |U| (vs.vector) and sqrt(|U|^2 + 2k) (vs.scalar)",
   "concentration": "the dimensionless concentration c* = C/c0 (cstar)",
   "theta": "the floor-referenced temperature fraction (theta)"
  },
  "value_columns": [
   "U",
   "V",
   "W",
   "speed",
   "k",
   "cstar",
   "theta",
   "T"
  ],
  "key_columns": [
   "config",
   "campaign",
   "instrument",
   "run",
   "wind_direction_deg",
   "point_id"
  ],
  "conventions": "velocities and the speed over U_ref, k over U_ref^2 (Cases E, F and G publish ratios already); U, V, W, |U| and the thermistor bracket scored as signed velocities (FAC2's ratio keeps the sign; hit rate D = 0.25, W = 0.05); k by the plain definitions (D = 0.25 only); a thermistor, cup or sonic reading (a mean scalar speed) scored against |U| (vs.vector) and sqrt(|U|^2 + 2k) (vs.scalar), the two ends of its bracket; c* = C/c0 with one detection limit per case, 1e-3 of the largest measured value; theta = (T_floor - T)/(T_floor - T_H) scored like a positive velocity. The same conventions score the served Eddy3D results (docs/validation/method.md).",
  "tool": "uv run python validation/score_submissions.py <folder>, from a checkout of the repository (pyproject.toml)",
  "metric_meaning": {
   "Count": "number of measured points scored",
   "MeanObserved": "mean of the measured, normalised quantity",
   "MeanPredicted": "mean of the modelled, normalised quantity",
   "Fb": "fractional bias, 2 (mean_obs - mean_pred) / (mean_obs + mean_pred); positive = model low",
   "Nmse": "normalised mean square error",
   "Nad": "normalised absolute difference",
   "Fac2": "fraction of points within a factor of two (harsh near zero for sign-changing V and W)",
   "HitRate": "fraction of points within D = 0.25 relative or W = 0.05 U_H absolute",
   "Mg": "geometric mean bias",
   "Vg": "geometric variance",
   "GeometricPairs": "pairs with both values positive (used for Mg/Vg)",
   "R": "Pearson correlation coefficient",
   "null": "a metric that is undefined for the data (for example Mg and Vg when no pair has both values positive; Fb, Nmse and Nad of a signed velocity component of Case H or I whose observed and predicted means are not both positive)"
  }
 },
 "geometry": {
  "url": "https://aij.eddy3d.com/api/cases/E/geometry.json",
  "files": [
   {
    "configuration": "ac",
    "url": "https://aij.eddy3d.com/api/cases/E/geometry.stl?v=c29624fdae6d",
    "triangles": 8432,
    "watertight": true
   },
   {
    "configuration": "bc",
    "url": "https://aij.eddy3d.com/api/cases/E/geometry_bc.stl?v=9b944d97a817",
    "triangles": 8396,
    "watertight": true
   }
  ]
 },
 "validation": {
  "url": "https://aij.eddy3d.com/api/cases/E/validation.json",
  "status": "scored",
  "engines": {
   "openfoam12-realizableKE": "scored",
   "openlb": "not comparable",
   "fluidx3d": "pending",
   "ml-surrogate": "scored"
  }
 },
 "known_issues": [
  "The velocity ratio is normalised by the inflow velocity at 15.9 m (= 3.935 m/s), NOT by U_H and NOT by UR = 7.8 m/s. A prior Eddy3D comparison in the folder divided by the wrong reference and came out low by a factor of 2.048 (FAC2 0.338 -> 0.863 once rescaled, R unchanged at 0.661).",
  "All 2560 published ratios are integer multiples of 0.0198204 (55 distinct levels): the data's own resolution is +/-0.0099, 3.1 % of the median value and about 10 % at the lowest points.",
  "The readme describes AF_caseE.csv, RS_caseE.csv and BD_caseE.stl, but this repository holds only the .3dm, .ghx, .xls and the MP drawing; everything here is extracted from the workbook and the 3dm.",
  "case-e.3dm is FULL-SCALE metres (MP_caseE.png is drawn at model scale, +/-0.8 m). Use layers 'buildings' (5,015 meshes, before construction) and 'buildings_new_construction' (3 prisms); exclude the map plate on the Japanese-named general layer, the terrain plates (the site is flat) and 'probes'.",
  "case-e.3dm: 1,563 of 8,436 triangles (18.5 %) of the building meshes are wound against their neighbours; all are re-wound here.",
  "Do not take the measurement coordinates from the 3dm's 'probes' layer: its 80 spheres sit a median 2.31 m (max 21 m) from the workbook's points, which are authoritative (all 80 fall in open space, min 0.83 m from a building edge).",
  "The measured quantity is a scalar (thermistor) speed; a RANS |U| is biased low against it in a dense canopy. The construction signal (ac - bc) is largest for SW (mean |d| 0.2155) and smallest for SSE (0.093)."
 ],
 "people": {
  "data_collectors": [
   "Yoshihide Tominaga (Niigata Institute of Technology)"
  ],
  "editors_distributors": [
   "Hideki Kikumoto (The University of Tokyo)",
   "Tsubasa Okaze (Institute of Science Tokyo)"
  ],
  "contact": "Yoshihide Tominaga <tominaga@abe.niit.ac.jp>"
 },
 "doi": "10.5281/zenodo.15429017",
 "doi_note": null,
 "citation_requested": "Tominaga, Y. et al. (2008). AIJ guidelines for practical applications of CFD to pedestrian wind environment around buildings. JWEIA 96, 1749-1761. https://doi.org/10.1016/j.jweia.2008.02.058",
 "citation": {
  "apa": "Tominaga, Y., Kikumoto, H., & Okaze, T. (2025). AIJ UWE Benchmark Dataset – Case E (Niigata): Wind Tunnel Experiment for Flow within an Actual Urban Area in Niigata [Data set]. Zenodo. https://doi.org/10.5281/zenodo.15429017",
  "bibtex": "@misc{aijuwe_case_e,\n  author    = \"Tominaga, Yoshihide and Kikumoto, Hideki and Okaze, Tsubasa\",\n  title     = \"{AIJ UWE Benchmark Dataset -- Case E (Niigata): Wind Tunnel Experiment for Flow within an Actual Urban Area in Niigata}\",\n  year      = \"2025\",\n  publisher = \"Zenodo\",\n  doi       = \"10.5281/zenodo.15429017\",\n  url       = \"https://doi.org/10.5281/zenodo.15429017\",\n  note      = \"Data set\"\n}"
 },
 "files_in_repository": {
  "folder": "https://github.com/Eddy3D-Dev/AIJ-Data-Validation/tree/main/raw/cases/case-e",
  "reference": "raw/cases/case-e/LF_caseE.xls",
  "approach_flow": "raw/cases/case-e/LF_caseE.xls [sheet Inflow]",
  "readme": "raw/cases/case-e/readme_caseE.md"
 },
 "render": "https://aij.eddy3d.com/assets/geometry/case-e-after.png",
 "page": "https://aij.eddy3d.com/cases/case-e/"
}
