Ghost Rivers

Sheet §0·Overview

A river was paved over, and everyone forgot it was there.

This manual holds two things: a competition‑ready environmental research plan built around the buried Kohaku River from Spirited Away, and a complete guide to running Claude Code in a Windows terminal so you can actually do the work.

Contour — elevation surface Flow accumulation — where water must go Method: topography says stream + old map says stream + modern map says nothing = buried

The contours above are synthetic, but the idea is exactly the real method. Water flows downhill whether or not there is a pipe in the way. Feed a laser‑scanned elevation model into a flow‑accumulation algorithm and it will draw you the streams a city must have — including the ones that no longer appear on any modern map, because someone put them in a culvert a hundred years ago and built houses on top.

What's in here

Where things stand

ItemStatusNote
Topic selectionDoneTwo projects fully scoped; Ghost Rivers recommended
Literature checkDoneGap confirmed open outside Baltimore and Detroit
Study areaBlockedNeeds a decision — everything downstream depends on it
Desk work vs. field workBlockedA genuine fork about what kind of work you enjoy
Data availability auditNot startedOne afternoon, once the city is chosen
ToolchainThis manualPart II gets you from zero to a working terminal
Two decisions to make

1. Which city or town? It needs a real stream network, open 311 data, LiDAR coverage, historical topographic maps back to about 1900, and — most importantly — a personal connection to you. Avoid Baltimore and Detroit; both are partly done.

2. Desk or boots? Ghost Rivers is maps, code, and archives: solo, weather‑independent, year‑round. The Half‑Life of a River Cleanup is gloves and repeat site visits across a semester. Both are good research.

Sheet §0 of 12 Series: Ghost Rivers Field Manual Sources verified 2026‑08‑08

Sheet H‑0·Method

How to pick a topic that is actually new

You do not need virgin territory. You need a combination nobody has tried — and a reason someone would care about the answer.

Time to apply
One week
Tools needed
Google Scholar
Skips this step at
Your peril

The instinct is to look for a question no human being has ever asked. That instinct is wrong twice over: genuinely untouched questions are vanishingly rare, and the ones you find are usually untouched because they are impossible to answer with free data and a laptop.

What actually wins competitions and gets published is a novel combination:

(a dataset few people use) × (a place or scale few people study) × (a question someone has a stake in) The three‑term test

Each term does specific work. The dataset term means nobody has the drop on you. The place term means the result is yours and not a re‑run. The stakes term is the one students skip, and it is the one reviewers respond to hardest.

The strongest version of the third term is auditing

Someone publicly claims an environmental outcome — a company says it protected a forest, an agency says it paid farmers to plant cover crops, a government says it plugged leaking wells — and you check the claim from orbit.

This framing is unusually powerful for a student, for two reasons that have nothing to do with how clever the analysis is:

  • Novelty is not arguable. Nobody has audited that specific claim before. You do not have to win a debate about whether your topic is new.
  • The result has consequences. A finding that money did or did not buy the outcome it promised is interesting to someone outside your school.

The two things that decide success

1. Do the novelty search before you write any code

Budget a full week. Search Google Scholar for your exact dataset × region × question triple, then read the reference lists of the three closest hits — that is where the paper that scoops you is hiding. Also search the local watershed association and any nearby university's environmental science department, because a great deal of this work lives in gray literature and unpublished master's theses that Scholar indexes badly.

This already happened once

The original plan here was the nighttime‑cooling study on sheet H‑2. Four searches in, we found a Nature Communications paper from May 2025 that had already done essentially that study for Los Angeles — 345 cloud‑free scenes, the redlining overlay, the income comparison, all of it.

Discovering that in month four instead of week one is the single most common way these projects die. It cost us an afternoon. It could have cost a year.

2. Have a control group, and quantify your uncertainty

The characteristic failure of a student remote‑sensing project is a convincing‑looking correlation with nothing to compare it against. Buried streams run hotter than open streams — but buried streams are also under parking lots. Unless you match them against open streams with similar pavement, slope, and upstream drainage area, you have not discovered anything about burial. You have rediscovered that cities are paved.

Matched controls, error bars, and validation against ground measurements are the entire difference between a paper and a poster.

The third thing, which is really part of the second

Name your own limitations precisely. Satellites only see the biggest methane leaks. Land surface temperature is not air temperature. A well‑characterized detection limit plus an honest null result for the small cases is publishable science, and good judges rate it far above an oversold headline. Do not stretch a finding to make it land harder.

Sheet H‑0 of 12 Part I · The Research

Sheet H‑1·Hydrology·Recommended

Giving the rivers back their names

Stream burial, flood risk, and environmental memory — a project that starts with a spirit who could not remember his own name.

Novelty
High — gap confirmed open
Data cost
$0, no access walls
Difficulty
Moderate
Work style
Desk — GIS, code, archives
Best venue
Stockholm Junior Water Prize
Biggest risk
Historical map coverage

The moment to build on

The richest environmental detail in Spirited Away is not the Stink God. It is Haku.

Haku cannot remember his own name, and so he cannot leave the bathhouse. Chihiro remembers it for him: he is the spirit of the Kohaku River — 琥珀川 — the river she fell into as a small child, which carried her safely to the bank instead of drowning her. The reason he lost his name is stated plainly in the film. The river was filled in, and apartments were built on top of it.

A river was paved over. Its spirit forgot what it was. Nobody remembers it was ever there.

Both halves of that map onto named science

Stream burial

Cities worldwide have driven their small streams into culverts, pipes, and concrete channels and built over the top. Headwater streams are hit hardest, because they make up the largest share of total stream length and are the cheapest to bury — that is the finding of Elmore & Kaushal (2008), the canonical paper. The documented consequences are specific: destroyed channels, downstream habitat degradation, fragmented aquatic habitat, faster transport of water and toxic contaminants, and the loss of nutrient and sediment retention.

Shifting baseline syndrome

And here is why nobody notices. Soga & Gaston (2018) define it as a gradual change in the accepted norms for the condition of the natural environment, caused by a lack of experience, memory, or knowledge of its past condition. It is also called environmental generational amnesia, and it was coined by the fisheries scientist Daniel Pauly in 1995.

The literature's own favourite example is rivers. Children once swam in clear local streams and caught minnows in jars. Today a murky, straightened concrete channel is simply accepted as what a river is.

Haku forgetting his name is shifting baseline syndrome. The mapping the whole project rests on

That is not a metaphor forced onto the film. It is a precise correspondence between a fictional device and a citable scientific concept — and it is what makes the framing read as intellectual rather than decorative.

Research questions

QuestionWhat you test
RQ1
Find them
How much stream length in the city has been buried since about 1900?
RQ2
Who lost them
Is burial socially patterned? Do lower‑income and historically redlined neighborhoods have a higher share of their streams buried — and a lower share daylighted or restored?
RQ3
Do the ghosts still act
A buried river is invisible, but the valley is still there and water still runs downhill. Test three consequences: (a) flooding — do 311 complaints and FEMA claims cluster along ghost channels? (b) heat — buried reaches lost their riparian tree corridor, so do they run hotter in Landsat land surface temperature once you control for pavement? (c) canopy loss.
RQ4
Optional · the best one
Survey residents living above buried streams: do they know there is a river under their street? Model awareness against distance from the ghost channel and length of residence. This empirically measures environmental amnesia — a near‑literal test of the film's premise.

Method

  1. Historical layer. Georeference historical USGS topographic quadrangles — free from USGS topoView — plus Sanborn fire insurance maps. Digitize the blue lines: streams that used to be mapped.
  2. Topographic layer. Take USGS 3DEP LiDAR elevation data and compute flow accumulation, using richdem or whitebox in Python, or QGIS. This tells you where a stream should be from the shape of the land alone.
  3. Define a ghost reach. Topography says stream + historical map says stream + modern NHD says nothing → buried. This follows the established Elmore & Kaushal approach, which means your method is defensible rather than invented.
  4. Overlay. Census income and race, HOLC redlining grades, NLCD canopy and imperviousness, city 311 open data, and Landsat land surface temperature via Earth Engine.
  5. Statistics. Matched comparison of buried against still‑open reaches, matched on imperviousness, slope, and upstream contributing area. Then test Moran's I, and move to a spatial error or lag model if autocorrelation is present.
The statistics trap

Plain ordinary least squares on spatial data produces fake significance, because neighboring places are not independent observations. Test Moran's I and say so in the paper. A sharp judge will ask, and having the answer ready is worth more than the extra decimal place.

Where the gap is

Already doneStill open
Elmore & Kaushal quantified burial in BaltimoreSystematic quantification of burial rate by neighborhood income and race
Detroit‑area work found buried channels were the single most common flood risk factorLinking ghost channels to flooding and heat in the same study
The equity literature discusses restoration justice conceptually, and warns restoration may be inadvertently enhancing inequitiesAny city outside the handful already studied
NYC 311 street‑flooding studies — but the predictors were catch basins and impervious coverBuried streams as the predictor, with 311 as validation
Daylighting invertebrate recovery; a Global North–South daylighting comparisonEmpirical measurement of resident awareness of buried streams

Skip Baltimore and Detroit. Your own city is both more novel and a better story. Note also that there is a public art installation called “Ghost Rivers” in Baltimore about the buried Sumwalt Run — excellent precedent to cite, and it means that exact title is taken there.

Feasibility

High. QGIS plus Python (geopandas, richdem or whitebox), all data free, and no access wall of the kind that complicates the ECOSTRESS project on sheet H‑2.

The historical map georeferencing is genuinely tedious — and that is an asset. It is visible, honest labour that reviewers and judges respect, and it is the part that cannot be automated away.

Alternative — The Half‑Life of a River Cleanup

If hands in the water beats hands in a GIS, build on the other scene, which has the strongest autobiographical link to Miyazaki himself. The River Spirit arrives at the bathhouse as the reeking Stink God; Chihiro finds a thorn in its side, and when it is pulled a torrent of garbage pours out — and a bicycle. Miyazaki has confirmed this came from cleaning a polluted river in his hometown, where the crew hauled a bicycle out of the muck. “I cleaned a river once.”

The question nobody has properly answered: how long does a cleanup last?

Volunteer cleanups are enormously popular, well funded, and emotionally satisfying — and the rate at which the trash comes back is barely measured. That is a striking gap for such a widespread practice.

  1. Pick 6–10 reaches of a local urban stream.
  2. Standardized baseline litter survey: fixed transects, item counts by material category, following an established protocol.
  3. Clean each reach completely.
  4. Re‑survey at fixed intervals — 2, 4, 8, and 16 weeks.
  5. Fit a re‑accumulation curve and estimate a half‑life.
  6. Test what predicts fast re‑accumulation: upstream impervious area, storm events between surveys, road proximity, adjacent land use, outfall locations.

It produces a real number with error bars, it is cheap, and it yields a direct policy recommendation: cleanups here last three months and here three weeks, so put the interception device in the second place.

Presentation tip

Photograph the single strangest object you pull out of the water. You will find something absurd. That photograph is your opening slide.

The college application arc

  1. You noticed something specific — not “the movie is about nature,” but a spirit who lost his name because his river was paved over.
  2. You went looking, and found the real thing has a name: stream burial. And the forgetting has a name too: shifting baseline syndrome.
  3. You went hunting for your own city's ghost rivers — georeferencing century‑old maps, running flow accumulation over LiDAR.
  4. You found them. And you found who lost them.
  5. Haku gets his name back and is freed. You gave your city's rivers their names back.
Two candid warnings

Admissions readers see a great many Ghibli essays. Yours survives because there is actual data underneath it. Spend one or two sentences on the film, then get out. Do not retell the plot.

Let the finding carry the emotion. If lower‑income neighborhoods turn out to have lost more of their streams, state it plainly and let it land. Understatement is stronger here than anything you could add.

Sheet H‑1 of 12 Part I · The Research Front‑runner

Sheet H‑2·Urban climate·Cautionary

The night that never cools off

A strong idea, most of which was published in May 2025. Worth reading for the lesson about novelty searches as much as for the narrow gap that survives.

Novelty
Narrow — mostly taken
Data cost
$0, but awkward access
Difficulty
High
Work style
Desk — heavy statistics
Best venue
ISEF, AGU poster
Biggest risk
Too few night scenes to fit a curve

The original idea

Nearly all urban heat island research uses Landsat, which passes over at about 10:30 in the morning. But heat does not kill people at 10:30 in the morning. It kills them across nights that never cool down, when the body gets no recovery period at all. So: which built‑environment features predict slow overnight cooling, and does that track income or historical redlining?

The instrument that makes this possible is ECOSTRESS, a thermal sensor mounted on the International Space Station. Because the station's orbit precesses, its overpass time drifts — which is normally an inconvenience, but here is the entire point. It samples the night.

What we found on the fourth search

Shreevastava et al. 2025 · Nature Communications

ECOSTRESS land surface temperature at 70 m. 345 cloud‑free scenes, 2018–2023. Four time‑of‑day bins × four seasons = sixteen combinations. Predictors: HOLC redlining grade, income, NDVI, impervious fraction. Kolmogorov–Smirnov tests, principal component analysis over 26 variables, linear regression. Headline result: contemporary income beats historic redlining as a predictor; a 5–7 °C summer‑afternoon disparity; roughly 1 °C of added disparity per 6 °C rise in mean land surface temperature; R² = 0.83.

That is, essentially, the study. Published while we were still sketching it.

What survives

Two things, and they are both narrow but real.

1. Everyone measures levels. Nobody measures the rate. This is the pattern across every single paper in the urban heat equity literature: temperature is sampled at a snapshot time and compared between neighborhoods. But the physically interesting quantity is the nocturnal decay parameter — how fast a place sheds heat after sunset. You get it by fitting a diurnal temperature cycle model, a three‑ to six‑parameter curve with separate day and night functions, to the irregular ECOSTRESS overpasses.

This matters because it is a different physics question. Daytime peak temperature is set by radiative load: albedo, tree shade, pavement. Nocturnal cooling rate is set by thermal inertia and geometry — the heat capacity of the built mass, and the sky view factor, meaning how much open sky a surface can actually radiate to. A narrow street canyon cannot cool no matter how pale you paint it.

2. It was one city. The authors say so themselves, in print: “It is important to note that LA is a rather uniquely situated city… may not be extendable to other U.S. cities without further investigation.” A multi‑city version with city as a random effect in a multilevel model, and variance partitioning to see how much of the disparity is a within‑city versus between‑city phenomenon, is a genuinely different contribution.

The feasibility surprise

ECOSTRESS is not where you expect it

ECOSTRESS land surface temperature is not in the Google Earth Engine catalog — only the STARS product, which gives NDVI and albedo. This looks like a wall, and it is actually a shortcut.

Use NASA AppEEARS in point‑sample mode: upload a CSV of latitudes and longitudes, receive a tidy CSV time series back. You skip raster processing entirely, which for a curve‑fitting project is exactly what you want. Watch for the v002 cloud_mask convention — it is a common source of silently wrong results.

The caveat you must state up front

Land surface temperature is not air temperature. A satellite measures the radiating skin of the ground and roofs; a person breathes the air a metre and a half above it. They correlate, they are not the same, and the offset varies by surface type. Say this in your limitations section before anyone asks.

Week‑one go / no‑go

Before committing, check exactly one thing: how many usable nighttime ECOSTRESS scenes exist over your candidate city? If you cannot get enough night observations spread across enough hours to constrain a decay curve, the entire project is impossible, and you want to know that in week one rather than month three. Note that coverage runs roughly 52°N to 52°S.

Sheet H‑2 of 12 Part I · The Research Read for the lesson

Sheet H‑3·Catalog

All thirteen ideas, plainly

Every candidate in one place. For each: what you would look at, and what makes it new. Grouped by the reason each one is novel, not by an arbitrary ranking.

Entries
13
Data cost
$0 for all of them
Grouping
By source of novelty
Auditing a claim Old‑sensor blind spot Wrong variable measured Field work

Auditing a claim · someone said they did an environmental good

Carbon offset forests

Auditing
What you check
A company paid to protect or replant a forest, and the project boundaries are public. Did canopy cover inside the polygon actually change?
The critical step
Looking at the project area alone proves nothing, because trees may have grown anyway. You need matched control areas outside it — similar elevation, slope, and baseline cover. This is a BACI design: before, after, control, impact.
Data
Verra and Gold Standard registries; Landsat and Sentinel‑2 NDVI; Hansen Global Forest Change; GEDI or ICESat‑2 for canopy height.
Difficulty
⚠ Caution
This field got crowded fast — major Science and Nature papers in 2023–24. You would be competing with well‑funded teams.

Farm conservation payments

Auditing Easiest start
What you check
The USDA pays farmers to plant winter cover crops — not for harvest, but to hold the soil and stop erosion. Are those fields actually green in winter?
The comparison
Counties receiving more conservation dollars against counties receiving fewer. Do the well‑funded ones show more winter vegetation?
Data
Sentinel‑2 winter NDVI time series; USDA Cropland Data Layer; publicly reported EQIP and CSP payments by county.
Difficulty
Highest feasibility on this list — mostly Earth Engine and pandas.
Why it's new
Cover‑crop remote sensing methods exist. Using them as a policy audit at national scale is much less done.

Orphaned oil and gas wells

Auditing
What you check
Methane is a far stronger greenhouse gas than CO₂, and many abandoned wells were never properly sealed. Federal money was allocated to plug them. Did the plumes shrink?
Data
EMIT, an imaging spectrometer on the ISS with a free plume catalog; Sentinel‑2 and Landsat shortwave infrared retrievals; state orphan‑well registries; Department of Interior plugging‑grant records.
Difficulty
Honesty required
Satellites only detect the largest emitters. That is fine — a well‑characterized detection limit plus an honest null result for small wells is publishable and impresses good judges. Do not oversell it.

Marine protected areas and illegal trawling

Auditing
What you check
Bottom trawling drags a net across the seabed and stirs up sediment — and that turbid plume is visible from orbit in optical imagery. Is anyone fishing inside the protected zone?
Three lines of evidence
Sediment plumes in Sentinel‑2, vessel detections in Sentinel‑1 radar, and suspicious gaps in AIS vessel tracking where a boat's transponder goes quiet.
Data
Sentinel‑1, Sentinel‑2, Global Fishing Watch AIS, World Database on Protected Areas.
Difficulty
Why it's new
“Paper parks” is a known concept in conservation. Sediment‑plume evidence for trawling is a fresh and visually compelling line of proof.

Groundwater rules and sinking ground

Auditing Hardest
What you check
Pump too much groundwater and the land physically sinks. Radar satellites measure that subsidence to the millimetre. California's SGMA law drew groundwater management boundaries — does the subsidence rate change discontinuously at those administrative lines?
Why that's clever
A jump at an arbitrary legal boundary is a regression discontinuity, one of the strongest causal identification strategies available. Nature does not put a cliff there; only the law does.
Data
Sentinel‑1 InSAR — use pre‑processed ARIA or OPERA displacement products. Do not process interferograms from scratch.
Difficulty
Highest on this list.

Rice irrigation and methane

Auditing
What you check
Alternate wetting and drying is a major methane‑reduction practice in rice farming — flooded paddies emit methane, so draining them periodically cuts it. Is anyone actually doing it?
The trick
Sentinel‑1 radar penetrates the crop canopy and can see standing water underneath, which optical sensors cannot.
Difficulty

Blind spots · nobody looked because old sensors could not see it

Small lakes

Blind spot Strong
The insight
Old ocean‑colour sensors had pixels 300 m to 1 km across. A lake smaller than one pixel is literally invisible. So decades of algal bloom research concentrated on Erie, Okeechobee, and Taihu — because those were the lakes the instruments could resolve.
What you do
Sentinel‑2 has 10–20 m pixels. Build the first bloom climatology ever for every lake under about 1 km² in your state.
Then the interesting part
Test whether bloom frequency tracks upstream fertilizer application, concentrated animal feeding operation density, or septic system prevalence.
Data
Sentinel‑2; NHD lake polygons; USGS water quality records for ground truth.
Difficulty

Fire and snow

Blind spot
The mechanism
After a forest burns, two things change at once: the canopy that shaded the snowpack is gone, and charred ground is darker so it absorbs more sunlight. Both make snow melt earlier.
What you measure
How many days earlier snow disappears inside burn scars — and how that effect decays over the ten years after a fire as vegetation returns.
Why it matters
Western US cities drink melted snow. Snow that melts in April instead of June is a water supply problem, not just an ecology one.
Data
Sentinel‑2 and MODIS fractional snow cover; MTBS burn severity perimeters; Landsat albedo.
Difficulty

Power outage restoration equity

Blind spot
What you check
Nightlight satellites see which neighborhoods get their power back first after a hurricane. Do lower‑income areas wait longer?
The control you must have
Damage severity. A neighborhood that was hit harder takes longer for reasons that are not about equity, so you have to hold that constant before claiming anything.
Data
VIIRS Black Marble daily nightlights across many storm events.
Difficulty

Solar farms and local climate

Contested
The question
Do large solar installations warm the land around them? The “photovoltaic heat island” is genuinely disputed in the literature and barely measured at scale.
What you do
A BACI design on land surface temperature and NDVI across hundreds of utility‑scale installations — before construction, after, against matched controls.
Difficulty

Artisanal gold mining

Blind spot
What you measure
River turbidity plus deforestation in the Amazon or Ghana, correlated against the gold price time series. When gold goes up, does the river go brown?
Difficulty

Wrong variable · everyone measured the thing that is easy to measure

Ghost Rivers — buried streams

Recommended
Summary
Everyone maps the streams that exist. Nobody maps the ones that were erased. Full treatment on sheet H‑1.
Difficulty

Nighttime cooling rate

Mostly taken
Summary
Everyone measures temperature levels at a snapshot time. Nobody measures the rate of cooling. Full treatment, including what got published first, on sheet H‑2.
Difficulty

Breaking a published method

Underrated
What you do
Take a published spectral index — marine plastic detection is the best candidate — and test whether it can actually distinguish its target from confounders in a new region. Does it mistake sargassum, sea foam, or sun glint for plastic?
Why this counts
Negative results and limitation‑finding are legitimately publishable in remote sensing venues. Showing that someone's method fails outside the conditions it was developed in is a contribution, and it is a very achievable one.
Difficulty

Field work · boots, not code

The Half‑Life of a River Cleanup

Field work
What you measure
Clean 6–10 stretches of stream completely, then re‑count the trash at 2, 4, 8, and 16 weeks. Fit a curve. Report a half‑life. Full protocol on sheet H‑1.
Why it's new
Volunteer cleanups are everywhere and heavily funded, and almost nobody has measured how fast the trash comes back.
Difficulty
Low technically, high in logistics — needs a schedule and probably a safety adult.

The food waste perception gap

Field work
What you measure
Weigh what your school actually throws away. Then survey what people believe they throw away. The gap between the two is the finding.
Why it's new
Perception gap studies are under‑done relative to straight waste audits, and the mismatch is what a behaviour‑change intervention would actually have to target.
The Ghibli link
No‑Face consumes endlessly, grows monstrous, and is healed only by expelling everything he swallowed.
Difficulty
But see the human‑subjects note on sheet H‑4.
Sheet H‑3 of 12 Part I · The Research 13 entries

Sheet H‑4·Logistics

From idea to submission

Where the work goes, in what order, and the four rules that keep a project from falling apart in review.

Realistic timeline
One to two semesters
First publication target
Journal of Emerging Investigators
Preprint
EarthArXiv — do this regardless

Order of operations

  1. 1

    Choose the study area

    Everything depends on this — the novelty check, the data audit, and the story. What you want: a real stream network, city 311 open data, USGS 3DEP LiDAR coverage, historical topographic quadrangles back to about 1900, and a personal connection. Avoid Baltimore and Detroit.

  2. 2

    Novelty search — budget one week

    Search Scholar for "buried stream" OR "stream burial" OR daylighting + [city]. Then search the city's watershed association and the nearest university's environmental science department, because much of this work is gray literature and unpublished theses. Read the reference lists of the three closest hits.

  3. 3

    Data availability audit — one afternoon

    • USGS topoView — confirm historical quad coverage and the earliest available date
    • USGS 3DEP — confirm LiDAR coverage and resolution
    • City open data portal — confirm 311 flooding categories exist and are geocoded
    • NHD — download modern flowlines
    • Mapping Inequality — check whether your city has a HOLC redlining map
  4. 4

    Write the formal proposal

    Hypotheses stated so they could be falsified, methods, the statistical plan written before you see results, and a timeline. This document is also most of your competition paperwork.

  5. 5

    Pilot on one small watershed

    Do not scale to the whole city first. Georeference one quad, run flow accumulation on one sub‑basin, find one ghost reach end to end. You will discover the three things that are harder than expected while they are still cheap to fix.

  6. 6

    Scale, then write

    Post the preprint to EarthArXiv as soon as the analysis is stable — it is free, citable, and timestamps your work. Then check the AGU abstract deadline and the competition calendar below.

Competitions

VenueFitNotes
Stockholm Junior Water PrizeNear perfectWater‑focused and explicitly values real‑world application. This is the one to aim at.
Regeneron ISEFStrongEarth & Environmental Sciences category. Check the human‑subjects rules early — see below.
Genius OlympiadStrongExplicit environmental focus, and welcomes a values‑driven framing rather than penalising it.
Regeneron STSStretchSeniors only, full research report.
JSHSGoodRegional then national; presentation‑heavy.
NASA Space AppsDifferent shapeHackathon format — a good place to build the first prototype fast.
IEEE GRSSTechnicalStudent paper contest and Data Fusion Contest — squarely remote sensing.

Publication

VenueTypeNotes
EarthArXivPreprintFree, citable, immediate. Do this regardless of anything else.
Journal of Emerging InvestigatorsPeer‑reviewedBuilt for pre‑college authors. The realistic first target.
AGU / AMS annual meetingStudent posterAccepts abstracts. Hydrology, or Earth & space informatics.
Freshwater ScienceJournalNatural home for the buried‑stream work.
Urban Climate / Landscape and Urban PlanningJournalRealistic if the full version comes together.
Remote Sensing (MDPI)JournalAchievable, but carries an article processing charge. Confirm a mentor's institution can cover it before submitting.
Environmental Research LettersJournalA stretch, but not absurd with a strong multi‑city result.

The four standing rules

Rule 1 · Novelty search before code

Budget a full week. This already cost us the nighttime cooling project once.

Rule 2 · Matched controls, always

For Ghost Rivers, match buried against open reaches on imperviousness, slope, and upstream contributing area. Without matching, the study only rediscovers that cities are paved.

Rule 3 · Test spatial autocorrelation

Moran's I, then a spatial error or lag model if it is present. Plain OLS on spatial data produces fake significance and a sharp judge will catch it.

Rule 4 · Human subjects paperwork comes first

If you include RQ4 — the resident awareness survey — or the food waste perception survey, that is human participants research. It may need school or IRB approval, and ISEF has specific forms that must be filed before you collect any data. Retroactive approval does not exist. Check the current ISEF rules the week you decide to include a survey, not the week before the deadline.

Sheet H‑4 of 12 Part I · The Research

Sheet W‑1·Installation

Claude Code on Windows

From a Windows PC with nothing installed to a working terminal session. You do not need to know how to code, and you do not need administrator rights.

Applies to
Windows 10 v1809+ · Server 2019+
Hardware
4 GB+ RAM · x64 or ARM64
Time needed
About 10 minutes
Admin rights
Not required
Account needed
Pro, Max, Team, Enterprise, or Console
Shells supported
PowerShell · CMD · Git Bash
Before you start · the account requirement

Claude Code needs a Pro, Max, Team, Enterprise, or Claude Console account. The free Claude.ai plan does not include Claude Code access. Check this first, so you do not install everything and then hit a wall at the login step.

Prefer to skip the terminal entirely?

There is a Claude Code desktop app for Windows with a graphical interface — no terminal required. Download it from claude.com/download. Everything on this sheet is for the terminal version, which is what you want if you plan to run Python and GIS work alongside it.

  1. 1

    Install Git for Windows — optional, but do it

    Git for Windows provides Git Bash, which enables Claude Code's Bash tool. Without it, Claude Code falls back to using PowerShell as its shell. You will not need to learn Git yourself.

    1. Go to git-scm.com/downloads/win and download the installer.
    2. Run it and click Next on every screen to accept the defaults. There are many screens; you do not need to change anything on any of them.
    3. If it asks you to choose an editor, keep the default.
    4. When you reach “Adjusting your PATH environment,” keep the recommended option selected.

    Already have Git, or not sure? Install it anyway. Reinstalling causes no problems.

  2. 2

    Open PowerShell

    PowerShell is Windows' built‑in terminal. It is pre‑installed on every Windows computer.

    Press Win + X and choose Windows PowerShell or Terminal from the menu. A window with a blinking cursor appears.

    PowerShell or CMD? This matters

    Windows has two command‑line programs that look nearly identical but take different commands. Read the start of your prompt line:

    • PowerShell shows PS C:\Users\YourName> — note the PS.
    • CMD shows C:\Users\YourName> — no PS.
    Not the x86 one

    If the Start menu offers Windows PowerShell (x86), do not use it. That entry runs as a 32‑bit process, and the installer will refuse with “Claude Code does not support 32‑bit Windows.” Pick the entry without (x86) in its name.

  3. 3

    Run the installer

    Copy the line below, paste it into PowerShell with Ctrl + V or a right‑click, and press Enter. irm fetches the installer and iex runs it.

    PowerShell
    irm https://claude.ai/install.ps1 | iex

    You will see text scrolling. When it finishes you should see Claude Code successfully installed!

    If you are in CMD rather than PowerShell, use this instead:

    CMD
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    Two errors that mean you're in the wrong shell
    • The token '&&' is not a valid statement separator → you ran the CMD command in PowerShell. Use the PowerShell one.
    • 'irm' is not recognized as an internal or external command → you ran the PowerShell command in CMD. Use the CMD one, or open PowerShell.

    Native installs update themselves in the background, so this is the only time you run an install command.

  4. 4

    Verify it worked

    PowerShell
    claude --version

    A working install prints a version number followed by (Claude Code) — something like 2.1.211 (Claude Code).

    For a fuller check, claude doctor prints read‑only diagnostics — install health, settings file validation errors, and any warnings with suggested fixes — without starting a session.

    PowerShell
    claude doctor

    If you get 'claude' is not recognized, the install directory is not on your PATH yet. That fix is on sheet W‑4.

  5. 5

    Log in

    Navigate to a folder you want to work in, then start Claude Code. In PowerShell, cd changes directory:

    PowerShell
    cd C:\Users\YourName\Documents\ghost-rivers
    claude

    On first run you are prompted to log in, and a browser window opens for you to sign in. Once you have logged in, your credentials are stored and you will not need to do it again. To switch accounts later, type /login inside a running session.

    If the ANTHROPIC_API_KEY environment variable is set, Claude Code skips the browser and asks you once to approve that key instead.

Other ways to install

MethodCommandAuto‑updatesUse when
Native
Recommended
irm https://claude.ai/install.ps1 | iex Yes Default choice for almost everyone.
WinGet winget install Anthropic.ClaudeCode No You already manage software with WinGet. Upgrade with winget upgrade Anthropic.ClaudeCode.
npm npm install -g @anthropic-ai/claude-code Manual You already have Node.js 22 or later. Upgrade with npm install -g @anthropic-ai/claude-code@latest.
Never use sudo or an elevated npm install

Do not run sudo npm install -g. It causes permission problems and is a security risk. Also note: for npm upgrades use @latest explicitly — plain npm update -g respects the original semver range and may not move you to the newest release.

Native Windows or WSL?

You can run Claude Code directly on Windows or inside the Windows Subsystem for Linux. Choose based on where your project files live and whether you need sandboxing.

OptionRequiresSandboxingUse when
Native WindowsNothing; Git for Windows optionalNot supportedWindows‑native projects and tools
WSL 2WSL 2 enabledSupportedLinux toolchains, or you want sandboxed command execution
WSL 1WSL 1 enabledNot supportedOnly if WSL 2 is unavailable

For a student research project on a Windows laptop, native Windows is the right default. Your QGIS install, your Python environment, and your downloaded map files are all Windows‑side, and crossing the WSL filesystem boundary is slow and confusing. If you go the WSL route instead, you install and launch claude inside the WSL terminal, not from PowerShell — and WSL setups do not need Git for Windows.

Pointing Claude Code at Git Bash

With Git for Windows installed, Claude Code uses Git Bash for its Bash tool. If it cannot find it, set the path in your settings file at %USERPROFILE%\.claude\settings.json:

settings.json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Note the doubled backslashes — that is required in JSON. To find where your Git actually lives:

PowerShell
Get-Command git | Select-Object Source

Uninstalling

If you installed natively:

PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

WinGet: winget uninstall Anthropic.ClaudeCode. npm: npm uninstall -g @anthropic-ai/claude-code.

Removing settings deletes your history

Deleting %USERPROFILE%\.claude and %USERPROFILE%\.claude.json removes all your settings, allowed‑tool rules, MCP server configuration, and session history. Only do this if you mean it.

Sheet W‑1 of 12 Part II · Claude Code on Windows Verified against official docs 2026‑08‑08

Sheet W‑2·Operation

Your first session

What the terminal expects from you, what Claude Code does with a request, and the handful of controls that matter on day one.

Prerequisite
Sheet W‑1 complete
Coding required
None
Interface
Text only — no clicking

Six things about living in a terminal

  • You cannot click on things. Use the arrow keys to move around.
  • Esc interrupts Claude mid‑task. This is the single most useful key. If it starts down the wrong path, stop it rather than letting it finish.
  • Enter sends your message. Type in plain English.
  • recalls previous commands, and Tab completes them.
  • Type / to list every command available to you.
  • exit, or Ctrl + D twice on an empty prompt, leaves.

Starting up

PowerShell
PS C:\Users\You> cd Documents\ghost-rivers
PS C:\Users\You\Documents\ghost-rivers> claude

  ╭──────────────────────────────────────────╮
  │  Claude Code v2.1.211                    │
  │  model: claude-opus-5                    │
  │  cwd:   C:\Users\You\Documents\...       │
  ╰──────────────────────────────────────────╯

  /help for commands · /resume to continue a previous conversation
> 

Above the prompt you see the version, the current model, and the working directory. That last one matters: Claude Code can only see files in and below the directory you started it in. Start it in the wrong place and it will not find your project.

Ask about the project before asking for changes

Claude Code reads your files as needed — you do not have to attach or paste anything. Let it look around first:

You typewhat does this project do?
You typeexplain the folder structure
You typewhat technologies does this project use?

It will also answer questions about itself, which is the fastest way to learn what it can do:

You typewhat can Claude Code do?

Making your first change

Describe the outcome you want in plain language.

You typeadd a hello world function to the main file

Claude Code will find the right file, show you the proposed change, ask for approval, and then make the edit. Whether it asks each time depends on your permission mode.

Permission modes — Shift + Tab

Press Shift + Tab to cycle. This is the control that decides how much rope Claude has.

ModeBehaviourWhen to use it
defaultAsks for approval before each changeStart here. Stay here until you trust what you are seeing.
acceptEditsAuto‑approves file editsLong mechanical jobs — batch georeferencing, renaming a hundred files.
planProposes changes without editing anythingBefore a big refactor, or when you want the strategy reviewed first.
autoRuns a background safety check and blocks risky actionsAvailable on some accounts. Returns to prompting after repeated blocks.

Git without learning Git

Version control is worth having on a research project — it is how you undo a bad afternoon. You can run it conversationally:

You typewhat files have I changed?
You typecommit my changes with a descriptive message
You typecreate a new branch called feature/flow-accumulation

Four habits worth forming immediately

1 · Be specific

Instead of “fix the bug,” try “fix the login bug where users see a blank screen after entering wrong credentials.” The difference in output quality is larger than you would expect.

2 · Break big things into numbered steps

Give it a sequence rather than a wish:

1. load the 1903 quad raster and the modern NHD flowlines 2. compute flow accumulation from the DEM 3. flag cells where accumulation is high but NHD has nothing within 30 m
3 · Let it explore before it acts

“analyze the database schema” or “read the three CSVs in data/ and tell me what's in them” before you ask for an analysis. Context first, work second.

4 · Run /init once per project

This creates a CLAUDE.md file — a persistent set of notes about your project that Claude reads every session. Put your conventions in it: coordinate reference system, file naming, which library you settled on. It stops you re‑explaining the same things.

Sheet W‑2 of 12 Part II · Claude Code on Windows

Sheet W‑3·Reference

Command reference

Shell commands run from PowerShell to start Claude Code. Slash commands run inside a session. Not every command appears for every user — availability depends on your platform, plan, and environment.

Shell commands
5 essential
Slash commands
Type / to list yours
Discovery
/help

Shell commands · run from PowerShell

CommandWhat it doesExample
claudeStart an interactive sessionclaude
claude "task"Start with an opening taskclaude "fix the build error"
claude -p "query"Run one query, print the answer, exitclaude -p "explain this function"
claude -cContinue the most recent conversation in this folderclaude -c
claude -rResume a previous conversation, chosen from a listclaude -r
claude --versionPrint the versionclaude --version
claude doctorRead‑only install and settings diagnosticsclaude doctor
claude updateApply an update immediatelyclaude update

Keyboard

KeyEffect
EscInterrupt Claude mid‑task
Shift + TabCycle permission modes
/List all available commands and skills
TabComplete a command
Previous command from history
Ctrl + D ×2Exit on an empty prompt
Ctrl + VPaste into PowerShell

The dozen slash commands you will actually use

CommandWhat it doesWhy it matters here
/helpShow help and available commandsFirst thing to type when stuck
/initCreate a CLAUDE.md project guideRun once per project; stops you repeating yourself
/clearStart fresh with empty contextBetween unrelated tasks — keeps answers sharp
/compactSummarize the conversation to free contextWhen a long session starts drifting
/contextVisualize current context usageShows you why it started drifting
/resumeReturn to an earlier conversationPick up yesterday's analysis mid‑thought
/rewindRoll back code and conversation to a checkpointThe undo button. Learn this early.
/diffOpen an interactive diff of uncommitted changesReview before you commit
/planSwitch to plan mode before large changesGet the strategy right before any file is touched
/modelSwitch to a different Claude modelHeavier model for statistics, lighter for file wrangling
/permissionsSet approval rules for tool usageStop approving the same safe command forty times
/memoryEdit CLAUDE.md memory filesRecord project conventions as you settle them
/usageShow token usage and costsKnow what you are spending
/doctorRun a setup checkupWhen something behaves oddly
/exitExit the CLI

Worth knowing about

CommandWhat it does
/add-dir <path>Add another working directory for file access this session
/cd <path>Move the session to a different working directory
/configOpen the settings interface, or set settings directly
/effortSet the model effort level
/fastToggle fast mode — same Opus model, faster output
/code-reviewReview a diff for correctness and cleanup opportunities
/verify <path>Verify code for correctness before you rely on it
/simplifySimplify code for clarity and maintainability
/security-reviewCheck a diff for security vulnerabilities
/datavizDesign guidance for charts, graphs, and dashboards
/deep-researchFan out web searches and synthesize a cited report
/exportExport the current conversation as plain text
/copyCopy the last response to the clipboard
/themeSet the colour theme — light, dark, or auto
/agentsManage subagent configurations
/mcpManage MCP server connections
/hooksView hook configurations for tool events
/loginSign in, or switch accounts
/bugReport a bug or share your conversation
Beyond the terminal

The same account works in the VS Code and JetBrains extensions, the desktop app, the web at claude.ai/code, and in GitHub Actions. From inside a terminal session, /desktop, /web, and /teleport move a conversation between them.

Sheet W‑3 of 12 Part II · Claude Code on Windows

Sheet W‑4·Troubleshooting

Windows errors, and their fixes

Find your error message in the left column. These are the specific failures Windows installs actually hit.

First move
claude doctor
Most common cause
Wrong shell, or PATH
Second most common
Free plan, no Claude Code access
Start here

claude doctor prints install health, settings‑file validation errors, and warnings with suggested fixes — without starting a session. Run it before working through anything below.

'claude' is not recognized

The installer worked, but the folder it installed into is not on your PATH, so Windows cannot find the program. Run these two lines in PowerShell:

PowerShell
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Then close PowerShell entirely and open a new window — PATH changes do not apply to already‑open terminals. Try claude again.

'irm' is not recognized as an internal or external command

You are in CMD, not PowerShell. Close the window and open PowerShell instead (Win + X → Windows PowerShell), or use the CMD form of the installer:

CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

The token '&&' is not a valid statement separator

The mirror image of the previous error: you ran the CMD command in PowerShell. Use irm https://claude.ai/install.ps1 | iex instead.

Could not create SSL/TLS secure channel

Usually an older Windows 10 system defaulting to an outdated TLS version. Run this first, in the same window, then retry:

PowerShell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Claude Code does not support 32-bit Windows

On a 64‑bit machine this almost always means you opened Windows PowerShell (x86), which runs as a 32‑bit process. Close it, open the Start menu entry without (x86) in the name, and run the installer again.

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Neither shell was found, and Claude Code needs at least one. Work through these in order:

  1. Make sure powershell.exe is on your PATH. Its default location is C:\Windows\System32\WindowsPowerShell\v1.0\. Alternatively install PowerShell 7, which provides pwsh.
  2. Or install Git for Windows to get Git Bash.
  3. If Git is installed but Claude Code cannot find it, point at it explicitly:
PowerShell
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

That lasts only for the current window. To make it permanent, put it in settings.json as shown on sheet W‑1. If your Git lives elsewhere, find it with Get-Command git | Select-Object Source and use that Git\bin folder.

syntax error near unexpected token '<', or HTML in your terminal

The install URL returned a web page instead of the installer script. If that page says App unavailable in region, Claude Code is not available in your country — check Anthropic's supported countries list. Otherwise just run the command again; transient failures happen.

Login fails, or there is no Claude Code option

Check the plan first

Claude Code requires Pro, Max, Team, Enterprise, or a Claude Console account. The free Claude.ai plan does not include it. No amount of reinstalling fixes a plan problem. You can also use Claude Code through Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry if your school or organization provides one.

Search or file discovery fails

Claude Code normally bundles ripgrep. If searching your project silently returns nothing, that is the usual culprit — check the official search troubleshooting page.

Everything worked, then a command hangs forever

You have most likely triggered something waiting for input that Claude cannot see — an interactive prompt, a pager, or a confirmation dialog. Press Esc to interrupt. When asking Claude to run a tool, prefer non‑interactive flags.

Two installations at once

If claude still runs after you uninstalled it, you probably have a second install from a different method, or a leftover shell alias. claude doctor will tell you which install it is actually using.

Sheet W‑4 of 12 Part II · Claude Code on Windows

Sheet W‑5·Application

Using Claude Code for this project

The two halves of this manual meeting: concrete prompts for each stage of the Ghost Rivers analysis, and the places where you must not take the answer on trust.

Stack
Python · QGIS · Earth Engine
Key libraries
geopandas · richdem · rasterio
Run /init
Before anything else

Set the project up once

Start in your project folder and run /init. Then tell it the things it cannot guess, and they will persist across every future session:

You typeAdd to CLAUDE.md: this project maps buried streams in [city]. All spatial data uses EPSG:26918 (UTM 18N). Rasters live in data/raster/, vectors in data/vector/, notebooks in notebooks/. Use geopandas and rasterio, not arcpy. Always write intermediate outputs to data/derived/ and never overwrite anything in data/raw/.

Stage by stage

Setting up the Python environment

This is the part that historically eats a weekend on Windows, because the geospatial stack has awkward binary dependencies. Ask for it explicitly:

You typeSet up a Python environment on Windows for geospatial work. I need geopandas, rasterio, richdem, rioxarray, and matplotlib. Explain each step before running it, and tell me if conda is a better choice than pip here and why.

Georeferencing the historical quads

You typeI have a scanned 1903 USGS topographic quad as a JPEG with no spatial reference. Walk me through georeferencing it in QGIS — which control points to pick, how many, and how to check the residual error afterwards. I want to understand the accuracy I'm introducing.

Note the last sentence. You need the error figure for your limitations section, so ask for it while you are doing the work rather than reconstructing it later.

Flow accumulation

You typeWrite a script that takes the 3DEP DEM in data/raster/dem.tif, fills sinks, computes D8 flow direction and flow accumulation with richdem, and writes a stream network raster thresholded at contributing areas above 5 hectares. Comment every step so I can explain the algorithm in my methods section.
Ask for the explanation, not just the code

“Comment every step so I can explain it in my methods section” is the most valuable phrase in this entire sheet. You will have to defend this analysis to a judge who may know more hydrology than you do. Code you cannot explain is worse than no code.

Defining ghost reaches

You typeI have three layers: modelled streams from flow accumulation, digitized 1903 streams, and modern NHD flowlines. Find reaches where the first two agree but NHD has nothing within 30 metres. Then tell me what could make this rule wrong — I want the false positives before I trust the count.

The matched comparison

You typeI need to compare buried reaches against still-open reaches while matching on imperviousness, slope, and upstream contributing area. Explain my options for matching, recommend one for a sample of about 200 reaches, and be explicit about what each method assumes.

Spatial statistics

You typeCompute Moran's I on the residuals from this OLS model. If there's significant spatial autocorrelation, fit the appropriate spatial error or lag model instead and explain which one you chose and why.

Figures

You typeMake a publication-quality figure: the ghost stream network over a census income choropleth, with a scale bar, north arrow, and a colorblind-safe palette. Serif labels. No chartjunk.

Where you must not trust it

Three hard rules for using an AI assistant in research

1 · Never cite a paper you have not read. If Claude names a reference, find it, open it, and read at least the abstract and methods. This is not about whether the citation is real; it is that you cannot defend a claim you sourced secondhand.

2 · Statistical choices are yours to justify. Ask for options and assumptions, not a verdict. When a judge asks why you used a spatial lag model rather than a spatial error model, “it suggested that one” is a failing answer.

3 · Check the numbers by hand at least once. Take one ghost reach, verify its length in QGIS with a measuring tool, and confirm it matches what your script reported. Do the same for one census join. Silent unit errors and coordinate reference system mismatches are the most common way a geospatial analysis is quietly wrong from end to end.

And disclose it

Competition rules increasingly ask how you used AI tools, and honest disclosure is normal and expected. Write down as you go which parts were assisted — environment setup, code drafting, figure styling — and which were your own analysis and interpretation. Keeping that log during the work takes minutes; reconstructing it in April does not.

Sheet W‑5 of 12 Part II · Claude Code on Windows

Sheet A‑1·Appendix

Sources

Everything consulted while scoping these projects, grouped by what it is for. Read the ones marked core before you write your proposal.

Verified
2026‑08‑08
Paywalled
1 — noted below

Stream burial & environmental memory · core

  1. Elmore & Kaushal (2008), “Disappearing headwaters,” Frontiers in Ecology and the Environment. esajournals.onlinelibrary.wiley.com/doi/10.1890/070101 The canonical stream burial paper, and the source of the method you are adapting. Read this one properly.
  2. Soga & Gaston (2018), shifting baseline syndrome, Frontiers in Ecology and the Environment. esajournals.onlinelibrary.wiley.com/doi/10.1002/fee.1794 The framework paper. Where “environmental generational amnesia” gets its definition. Cites Pauly 1995.
  3. Global synthesis on the occurrence of shifting baseline syndrome. pmc.ncbi.nlm.nih.gov/articles/PMC11494512 Evidence that SBS is widespread, which is what lets you argue RQ4 is measuring something real.
  4. UMCES buried streams modeling. umces.edu/campuses/al/buried-streams Practical detail on how burial is actually modelled.

Restoration equity & daylighting

  1. PLOS Water on restoration potentially enhancing inequities. journals.plos.org/water — pwat.0000308 The uncomfortable finding that makes RQ2 more than a formality.
  2. Freshwater Science on equity in stream restoration. journals.uchicago.edu/doi/full/10.1086/721651
  3. Daylighting and rapid invertebrate community change. researchgate.net — Re-engineering buried urban streams
  4. Global North–South daylighting comparison, Frontiers in Ecology and Evolution. frontiersin.org — fevo.2022.838794

Ghost streams & urban flooding

  1. Planet Detroit on ghost streams as a flood risk factor. planetdetroit.org/2025/07/detroit-ghost-streams-flooding Partly does RQ3(a) for Detroit — which is why you should pick a different city.
  2. NYC 311 street flooding study, Journal of Hydrology. sciencedirect.com — S0022169421013500 Establishes 311 as a usable flooding signal. Its predictors were catch basins and impervious cover, not buried streams — that gap is yours.

Urban heat & nighttime temperature

  1. Shreevastava et al. (2025), Nature Communications — ECOSTRESS heat equity in Los Angeles. Read this before doing anything on sheet H‑2. It is the paper that already did the obvious version.
  2. 2025 nighttime LST review, GIScience & Remote Sensing, 10.1080/15481603.2025.2527990. Paywalled Would have been the ideal gap analysis. Request it through a school or library account if you can.
  3. Chakraborty (2019); Hsu (2021); Chang (2022); Li (2023) — the urban heat equity sequence. All measure temperature levels. Collectively they are the evidence for the claim that nobody measures the rate.
  4. Ramamurthy & Bou‑Zeid (2017) — moist heat and urban heat stress.
  5. Lu (2021) on diurnal temperature cycle models; Wen (2022). Where the nocturnal decay parameter comes from.
  6. Health outcome literature: Lancet Planetary Health, European Heart Journal, Environmental Epidemiology. These are what justify caring about night temperature specifically.
  7. Science Advances on crowdsourced air temperature. Relevant to the land surface versus air temperature caveat.

Data & tools

  1. USGS topoView — historical topographic quadrangles, free.
  2. USGS 3DEP — LiDAR elevation data.
  3. NHD — National Hydrography Dataset, modern flowlines.
  4. NLCD — imperviousness and tree canopy layers.
  5. Mapping Inequality — digitized HOLC redlining maps.
  6. Sanborn fire insurance maps — building‑scale historical detail.
  7. NASA AppEEARS — point‑sample mode returns tidy CSV time series. The workaround for ECOSTRESS not being in Earth Engine.
  8. NASA ECOSTRESS‑Data‑Resources; the GEE STARS catalog entry.
  9. CAPA Heat Watch / NIHHIS at heat.gov — ground traverse air temperature.
  10. Google Earth Engine with geemap; Microsoft Planetary Computer; QGIS; geopandas; richdem / whitebox; xarray + stackstac.

Spirited Away factual basis

  1. Looper on the River Spirit scene's real origin. looper.com/1018413 Miyazaki's river cleanup and the bicycle. “I cleaned a river once.”
  2. GKIDS Films confirmation. x.com/GKIDSfilms/status/1054809687726555136
  3. Baltimore “Ghost Rivers” public art project, on the buried Sumwalt Run. Good precedent to cite. Also means that exact title is taken in Baltimore.

Claude Code documentation

  1. Advanced setup. code.claude.com/docs/en/setup
  2. Quickstart. code.claude.com/docs/en/quickstart
  3. Terminal guide for new users — the Windows walkthrough. code.claude.com/docs/en/terminal-guide
  4. Commands reference. code.claude.com/docs/en/commands
  5. Troubleshoot installation and login. code.claude.com/docs/en/troubleshoot-install
Sheet A‑1 of 12 Appendix Every URL checked 2026‑08‑08

第 §0 页·概览

一条河被填平了,然后大家都忘了它存在过。

这份手册有两半。前一半是一个能投竞赛的环境研究计划,灵感来自《千与千寻》里被填掉的琥珀川。后一半教你在 Windows 的命令行里用 Claude Code,把这个研究真的做出来。

等高线 —— 地面的高低 水流路线 —— 水一定会走的地方 判断方法:地形说这有河 + 老地图说这有河 + 新地图什么都没有 = 被埋了

上面这张图是电脑合成的,但方法是真的。

不管上面盖了什么,水还是往低处流。所以你可以这样做:拿激光测出来的地面高度数据,让电脑算「水会往哪里流」。它就会画出这座城市一定有过的那些河——包括今天任何地图上都找不到的那些。因为一百年前有人把它们塞进了地下管道,然后在上面盖了楼。

这里面有什么

现在做到哪一步了

事情状态说明
选题目做完了两个方案都想细了,推荐幽灵河流
查有没有人做过做完了除了巴尔的摩和底特律,别的地方还没人做
选哪座城市卡住了要你来定。后面每一步都得等这个
坐电脑前还是下河卡住了看你喜欢哪种干活方式
查数据能不能拿到还没开始城市定了之后,一个下午就查完
工具就是这份手册第二部分带你从零装到能用
两个要你决定的事

第一,选哪座城市?这座城市要有真的河,要有公开的市政投诉数据,要有激光测高数据,还要有 1900 年左右的老地图。最重要的是:它得跟你本人有关系。

避开巴尔的摩和底特律,这两个地方别人做过一部分了。

第二,你想坐在电脑前,还是穿雨靴下河?

幽灵河流是查地图、写代码、翻档案。一个人就能做,不用看天气,一年四季都行。

清理河流的半衰期要戴手套,要在一整个学期里反复跑同一个地方。两个都是好研究。

第 §0 页 / 共 12 页 幽灵河流手册 资料查过:2026‑08‑08

第 H‑0 页·方法

怎么选一个真的没人做过的题目

你不用去找一片完全空白的地方。你要找的是一个没人试过的组合,而且要有人真的在乎答案。

要花多久
一个星期
要用什么
Google Scholar
跳过这步
后果自己承担

大部分人第一个想法是:我要找一个全世界都没人问过的问题。

这个想法错了两次。第一,完全没人碰过的问题非常少。第二,你能找到的那些,之所以没人碰,通常就是因为用免费数据加一台笔记本根本做不出来。

真正能获奖、能发表的,是一个新的组合

(很少人用的数据)×(很少人研究的地方)×(有人真的想知道答案的问题) 三个条件

这三个条件各有用处:

  • 数据这一项,保证别人抢不了先。
  • 地方这一项,保证结果是你的,不是重复别人。
  • 有人在乎这一项,学生最容易忘掉。但评委最看重的就是这个。

第三项最好用的玩法:查账

有人公开说自己做了一件环保好事。比如:

  • 某公司说它花钱保护了一片森林
  • 某部门说它发钱让农民种了保护土壤的作物
  • 某政府说它把漏气的废井都封好了

而你,用卫星去查:他说的是真的吗?

这个思路对学生特别有威力。原因跟你的分析有多聪明没关系:

  • 没人能说你的题目不新。在你之前,没有人查过这一件具体的事。这一点没法争。
  • 结论真的有用。「这笔钱到底买到了它承诺的东西吗」——这是你们学校以外的人也会关心的问题。

决定成败的两件事

一、动手写代码之前,先查有没有人做过

给这件事整整一个星期。

去 Google Scholar 搜「你的数据 + 你的地区 + 你的问题」。然后把最接近的三篇论文的参考文献全部看一遍。抢先做了你这个题目的那篇论文,往往就藏在那里面。

另外还要搜两个地方:

  • 当地的流域保护协会(这种组织常有自己的报告)
  • 附近大学环境科学系的网页

因为这类研究有很多是没正式发表的报告和硕士论文。Google Scholar 收不全它们。

这件事已经真的发生过一次了

本来的计划是 H‑2 那个夜间降温研究。查到第四条的时候,我们发现 2025 年 5 月有一篇《Nature Communications》,已经在洛杉矶把那个研究基本做完了。345 张无云卫星图、红线区对比、收入对比,全都有。

做到第四个月才发现这件事,是这类项目最常见的死法。

这次它只花掉我们一个下午。本来可能花掉一年。

二、一定要有对照组,一定要给误差范围

学生做遥感项目最常见的失败是:画出一条看起来很有说服力的曲线,但没有任何东西可以拿来对比

举个例子。被埋掉的河道确实比露天的河道热。但被埋的河道上面往往是停车场——水泥地本来就热。

所以你必须去找一些露天的河道,它们的水泥地比例差不多、坡度差不多、上游集水面积也差不多,然后拿这些来比。这叫配对

不做配对的话,你什么都没发现。你只是重新发现了「城市铺了水泥」。

有配对的对照组、有误差范围、跟地面实测数据核对过——这就是「论文」和「海报」的全部区别。

还有第三件事,其实算第二件的一部分

老实说出你自己做不到什么。

比如:卫星只看得见最大的甲烷漏点,小的看不见。地表温度不等于气温。

把「我能看到多大的信号」这条线说清楚,然后老实报告「小的那些我查不出来」——这本身就是可以发表的科学。好评委给这种做法的评价,远高于一个被夸大的标题。

不要为了让结论更好看而把它说大。

第 H‑0 页 / 共 12 页 第一部分 · 研究

第 H‑1 页·水文·推荐

把名字还给河流

从一个「记不起自己名字的河神」开始,研究被埋掉的河道、淹水风险,还有人的遗忘。

新颖程度
高,空白已确认
数据要花钱吗
不用,也没门槛
难度
中等
干活方式
坐电脑前:地图、代码、档案
最适合投
斯德哥尔摩青少年水奖
最大风险
老地图不一定盖到你的城市

要抓住的那一幕

《千与千寻》里最重的环境细节,不是腐烂神,是白龙

白龙记不起自己的名字,所以他走不出汤屋。最后是千寻帮他想起来的:他是琥珀川的河神。就是千寻小时候掉进去的那条河。那条河没有淹死她,反而把她推到了岸上。

他为什么会丢掉名字?电影里说得很直白:那条河被填平了,上面盖起了公寓楼。

一条河被铺平了。它的神忘了自己是谁。没有人记得它曾经在那里。

这两件事,现实里都有名字

第一件:河道填埋

全世界的城市都干过同一件事:把小河塞进地下管道和水泥渠,然后在上面盖房子。

被埋得最多的是源头小溪。原因有两个:它们加起来占了河流总长度里最大的一份;而且它们最细,埋起来最便宜。这是 Elmore 和 Kaushal 2008 年那篇论文的核心发现,也是这个领域最基础的一篇。

埋掉之后会发生什么,已经有研究记录下来了:

  • 自然河道被毁掉
  • 下游的生物栖息地变差
  • 水里的生物被切断,走不通了
  • 雨水和有毒污染物冲得更快
  • 河道原本能留住的养分和泥沙,留不住了

第二件:基线漂移

这一件解释了「为什么没人发现」。

Soga 和 Gaston 在 2018 年给它下了定义。简单说就是:因为你没见过环境以前的样子,你就以为它现在这样是正常的。一代一代往下滑,每一代都觉得自己看到的是「本来的样子」。

它还有个更好懂的名字叫「环境代际失忆」。最早是渔业科学家 Daniel Pauly 在 1995 年提出来的。

这个领域自己最爱用的例子就是河:

上一代人小时候在清澈的小河里游泳、用玻璃瓶捞小鱼。今天的小孩看到的是一条浑浊的水泥渠,然后觉得——河本来就是这样的啊。

白龙忘掉自己的名字,就是基线漂移。 整个项目立在这一句上

这不是硬套在电影上的比喻。它是一个虚构设定和一个真实科学概念的精确对应。也正因为这样,这个框架读起来才像想法,不像装饰。

要回答的四个问题

问题你要查什么
RQ1
找到它们
从 1900 年左右到今天,这座城市一共有多长的河被埋掉了?
RQ2
是谁的河没了
被埋掉的河,是不是集中在某些社区?收入低的社区、以前被银行划成「不给贷款」的社区,是不是有更多的河被埋、更少的河被重新挖开?
RQ3
这些河还在起作用吗
河被埋了看不见了,但河谷还在,水还是往低处流。查三件事:(a)淹水——市政投诉和保险理赔,是不是正好沿着这些老河道扎堆?(b)热——被埋的河段失去了岸边那排树,那在扣掉水泥地的影响之后,它们是不是更热?(c)树少了多少
RQ4
可选 · 最漂亮的一问
去问住在老河道上面的居民:你知道你家街底下有一条河吗?然后看「离老河道多近」和「住了多少年」能不能解释他们知不知道。这是在用数据测量「遗忘」——几乎就是在检验电影里那件事。

具体怎么做

  1. 先拿老地图。美国地质调查局有个免费网站叫 topoView,上面有一百年前的地形图。把老地图跟今天的坐标对上(这一步叫「配准」),然后把上面的蓝线一条条描出来——那些就是以前画在图上的河。
  2. 再算水往哪流。拿 3DEP 的激光测高数据,让电脑算「水会汇到哪里」。用 Python 的 richdemwhitebox,也可以直接用 QGIS 这个免费软件。这一步只看地面的形状,就能告诉你河应该在哪。
  3. 然后判断哪一段被埋了。三个条件同时成立就算:地形说这里有河 + 老地图说这里有河 + 现在的官方水系图(叫 NHD)什么都没有。
    这个做法是跟着 Elmore 和 Kaushal 走的,所以是站得住脚的,不是你自己发明的。
  4. 再把别的信息叠上去。人口普查的收入和族裔、以前的红线区等级、水泥地和树冠比例、市政投诉数据、还有卫星测的地表温度。
  5. 最后跑统计。把被埋的河段和露天的河段配对来比(按水泥地比例、坡度、上游面积配对)。然后检查一件事:挨着的地方会不会因为挨着而长得像?这个检查叫 Moran's I。如果有,就换成专门处理这种情况的模型。
统计上有个坑

空间数据不能直接跑最普通的那种回归(OLS)。因为挨着的两个地方本来就像,不算两份独立的证据。直接跑会算出假的「显著」。

一定要做 Moran's I 检查,而且要写在论文里。评委会问的。准备好这个答案,比多算一位小数有用得多。

空白在哪里

已经有人做了还没人做
Elmore 和 Kaushal 算清了巴尔的摩埋了多少社区收入和族裔系统地算填埋比例
底特律那边发现,被埋的河道是最常见的淹水原因同一个研究里,把老河道同时连到淹水高温
有人讨论过河道修复的公平问题,还警告说修复可能反而加大了不公平那几座已经被研究过的城市之外,任何一座城市
纽约有人用市政投诉研究街道积水,但他们看的是雨水口和水泥地被埋的河道当成原因,再用投诉数据来验证
有人研究过河道重新挖开之后,水里的小虫多快恢复用数据测居民到底知不知道脚下有河

避开巴尔的摩和底特律。你自己的城市既更新,也是更好的故事。

另外提醒一句:巴尔的摩有个公共艺术项目就叫「Ghost Rivers」,讲的是被埋掉的 Sumwalt Run。这是很好的引用例子,但也说明那个名字在当地被占了。

做得出来吗?做得出来

要用的东西:QGIS(免费)加 Python 的几个库(geopandasrichdemwhitebox)。数据全免费,而且不像 H‑2 那个项目那样有取数据的麻烦。

把老地图一张张对上坐标,确实很枯燥。但这恰好是一个优点。这是看得见的、老实的劳动,评审和评委都认这个。而且这一部分没法让机器替你做。

备选方案:《清理河流的半衰期》

如果你更想把手伸进水里,而不是伸进电脑,那就抓另一幕。这一幕跟宫崎骏本人的关系最直接。

河神变成臭气熏天的「腐烂神」来到汤屋。千寻发现它身上插着一根刺,刺一拔出来,垃圾像洪水一样喷出来——里面还有一辆自行车

宫崎骏本人确认过:这来自他在家乡清理一条脏河的经历,当时大家真的从泥里拖出了一辆自行车。他说:「我清理过一条河。」

真正没人好好回答的问题:清一次能干净多久?

志愿者清河这件事到处都有,钱也不少,做完还很有成就感。但是——垃圾多快会回来?几乎没有人测过。

对一件这么普遍的事来说,这是个惊人的空白。

怎么做:

  1. 在本地一条城市小河上选 6 到 10 段。
  2. 先数一遍垃圾。要有固定的样带,按材料分类计数,照着一个现成的规范做。
  3. 把每一段彻底清干净。
  4. 之后按固定时间回去重新数:第 2、4、8、16 周
  5. 画出「垃圾回来」的曲线,算出一个半衰期(也就是垃圾回到一半要多久)。
  6. 再看什么因素决定它回得快:上游水泥地多不多、这期间下了几场雨、离马路多近、旁边是什么用途的地、附近有没有排水口。

这个研究能给出一个带误差范围的真数字,成本很低,而且能直接给出一条建议:

这里清一次能维持三个月,那里只能维持三个星期。所以拦垃圾的装置应该装在第二个地方。

一个展示小技巧

把你从水里捞出来最离谱的那件东西拍下来。你一定会捞到什么荒唐玩意儿。那张照片就是你演讲的第一张幻灯片。

大学申请文书可以怎么写

  1. 你注意到的是一个很具体的东西。不是「这部电影讲自然」,而是一个因为自己的河被铺平、所以丢了名字的神
  2. 你去查了,发现现实里这件事有名字:河道填埋。而「忘记」也有名字:基线漂移
  3. 你开始找你自己城市的幽灵河流。对一百年前的地图,跑水流计算。
  4. 你找到了。而且你还查出了是谁失去了它们。
  5. 白龙拿回名字,得到自由。你把你的城市的河的名字还给了它们。
两句实话

招生官看过非常多吉卜力主题的文书。你的能活下来,是因为下面压着真数据。

所以:讲电影只用一两句话,然后马上走开。不要复述剧情。

让发现本身带情绪,你自己别加。如果结果真的是低收入社区失去了更多的河,就平平地把它写出来,让它自己落地。在这里,说得越淡越有力量。

第 H‑1 页 / 共 12 页 第一部分 · 研究 首选方案

第 H‑2 页·城市气候·反面教材

降不下温的那个晚上

一个很好的点子,但大部分在 2025 年 5 月被人发表了。这一页值得读,一半是看还剩什么,一半是看那个教训。

新颖程度
窄,大部分被占了
数据要花钱吗
不用,但拿起来别扭
难度
干活方式
坐电脑前,统计很重
最适合投
ISEF、AGU 海报
最大风险
夜间照片不够,画不出曲线

本来的点子

几乎所有研究城市热岛的人,用的都是 Landsat 卫星。而这颗卫星大约在上午十点半经过。

但热不是在上午十点半害死人的。

真正危险的是那种一整晚都降不下温的夜晚。人的身体一夜都没得到休息,第二天接着热。

所以问题是:什么样的街区晚上降温慢?这跟收入或者以前的红线区有关系吗?

能做这件事的仪器叫 ECOSTRESS,装在国际空间站上,专门测温度。

它有个特别之处:因为空间站的轨道会慢慢转,它每次经过同一个地方的时间都不一样。平时这算个麻烦,但在这里正好是关键——它能拍到夜里。

我们查到第四条时发现的东西

Shreevastava 等人,2025,《Nature Communications》

他们用 ECOSTRESS 的地表温度,70 米分辨率,345 张无云照片,2018 到 2023 年。分成四个时段 × 四个季节,一共十六种组合。

他们用来解释温度的因素:红线区等级、收入、植被多少、水泥地比例。统计方法用了好几种。

主要结论:现在的收入比历史上的红线区更能解释温度差异;夏天下午的温差有 5 到 7 °C;平均温度每升 6 °C,这个差距还要再拉大 1 °C 左右。

这基本上就是我们想做的那个研究。我们还在打草稿的时候,它已经发表了。

那还剩下什么?

剩两样,都很窄,但都是真的。

第一:所有人都在测温度有多高,没人测降温有多快。

这是这个领域一贯的做法——在某个时刻测一下温度,然后比较不同社区。

但真正有意思的是降温速度:太阳下山之后,一个地方多快能把热量放掉?

要算这个,你得把卫星那些零散的观测时刻拟合成一条曲线(白天一段、夜里一段),然后看夜里那一段掉得多快。

为什么这是个不同的问题?因为背后的物理不一样:

  • 白天有多热,取决于晒进来多少:地面颜色深浅、有没有树荫、水泥地多不多。
  • 晚上降得多快,取决于两件事。一是建筑材料攒了多少热(水泥和砖攒热特别厉害)。二是这块地面能看到多少天空——热量是往天上散的,如果四周都是高楼,热就散不出去。

所以一条又窄又高的街道,不管你把墙刷得多白,晚上都凉不下来。

第二:那篇论文只做了一座城市。

作者自己在论文里就写了:洛杉矶的位置比较特殊,结论不一定能推到美国其他城市。

所以做一个多城市的版本,看看这个规律在不同城市之间是不是一样——这是一个真的不一样的贡献。

拿数据时的一个意外

ECOSTRESS 不在你以为的地方

Google Earth Engine 是最常用的免费卫星数据平台。但 ECOSTRESS 的温度数据不在它的目录里,只有别的产品。

这看起来像一堵墙,其实是条捷径。

改用 NASA 的 AppEEARS,选「点采样」模式:你上传一个经纬度表格,它给你回一个整整齐齐的表格。栅格处理那一大堆麻烦事你完全跳过了——而对一个「拟合曲线」的项目来说,这正好是你想要的。

注意一个小坑:新版数据里那个标记云的字段(cloud_mask)规则变了,弄错了结果会悄悄算错。

一开始就要说清楚的一件事

卫星测的是地表温度,不是气温。

卫星量的是地面和屋顶那层「皮」有多烫。而人呼吸的是离地一米半左右的空气。

这两个数字有关系,但不是一回事,而且差多少还随地面类型变。在别人问你之前,先把这一条写进你的「局限」那一节。

第一周就该做的判断:这个题目到底能不能做

投入之前只查一件事:你想研究的那座城市上方,到底有多少张能用的夜间 ECOSTRESS 照片?

如果夜间的观测太少,或者时间点太集中,你就画不出那条降温曲线,整个项目就不成立。

这件事你要在第一周就知道,不要等到第三个月。

另外注意:这颗仪器只覆盖大约南北纬 52 度之间。

第 H‑2 页 / 共 12 页 第一部分 · 研究 为教训而读

第 H‑3 页·目录

十三个点子,都用大白话说

所有候选题目都在这里。每个都写清楚:你要看什么,为什么它是新的。按「为什么新」分组,不是按好坏排名。

一共
13 个
数据要花钱吗
全都不用
怎么分组
按「为什么新」
查账 以前的卫星看不见 大家测错了东西 要下野外

查账 · 有人说自己做了好事,你去查

碳信用说种的那片林子

查账
你查什么
公司想「抵消」自己的碳排放,就花钱资助别人种树或保护森林。这些项目的地理边界是公开的。那块地上的树,真的变多了吗?
关键那一步
只看项目区什么都证明不了,因为树本来可能也会长。你要再找几块条件差不多、但没被资助的地来当对照——海拔像、坡度像、原来树的密度也像。两边比,才说明问题。
用什么数据
Verra 和 Gold Standard 的项目登记册;Landsat 和 Sentinel‑2 卫星图;Hansen 全球森林变化数据;想测树高就用 GEDI 或 ICESat‑2。
难度
⚠ 注意
这个方向最近很热,2023 到 24 年有《Science》《Nature》级别的论文。你会和资金充足的团队正面撞上。

农业补贴,农民真照做了吗

查账 最好上手
你查什么
美国农业部发钱给农民,让他们冬天在地里种一层作物。不是为了收成,是为了不让土被风雨刮走。那些田冬天真的是绿的吗?
怎么比
拿到钱多的县,对比拿到钱少的县。钱多的那些,冬天真的更绿吗?
用什么数据
Sentinel‑2 卫星的冬季植被指数;美国农业部的农作物分布图;每个县拿了多少补贴(公开的)。
难度
这一列里最容易上手的。基本就是 Earth Engine 加一点 Python。
为什么算新
用卫星看这种作物的方法早就有了。但把它当成「查政府补贴有没有效」来用,而且是全国范围,做的人少得多。

废弃的油井在偷偷漏气吗

查账
你查什么
甲烷是比二氧化碳厉害得多的温室气体。很多老油井被公司抛下之后没封好,一直在漏。政府拨了钱去封它们。封完之后,卫星看到的漏气真的少了吗?
用什么数据
EMIT(装在空间站上的仪器,漏气羽流目录免费);Sentinel‑2 和 Landsat 的反演结果;各州的废井名单;封井拨款记录。
难度
必须老实的地方
卫星只看得见漏得最厉害的那些井,小的看不见。这没关系——把「我能看到多大的漏点」说清楚,再老实报告「小井我查不出来」,这本身就是好科学,而且会打动好评委。千万不要为了结论好看而夸大。

海洋保护区真的挡住偷捕了吗

查账
你查什么
底拖网就是把大网在海底拖,会把泥沙搅起来。搅起来的浑水,卫星从天上看得见。那保护区里到底有没有人在捕鱼?
三条证据
一、卫星图上的浑水带。二、雷达卫星直接看到船。三、渔船的定位信号在哪些时段「神秘失踪」了。三条对上,就是证据。
用什么数据
Sentinel‑1 雷达、Sentinel‑2 光学、Global Fishing Watch 的船舶定位数据、世界保护区数据库。
难度
为什么算新
业内有个说法叫「纸上公园」——保护区只存在于纸面上。用浑水当拖网的证据,是一条新鲜而且看起来很有说服力的路。

地下水管得住吗:地面在下沉

查账 最难
你查什么
地下水抽太多,地面会真的往下塌。雷达卫星能测出几毫米的下沉。加州立法划了地下水管理区。下沉速度在管理区的边界上,会不会突然变了?
妙在哪
如果在一条人为画出来的法律边界上出现突变,那几乎只能是法规起了作用——因为大自然不会正好在那条线上放一道悬崖。这是很强的因果证据。
用什么数据
Sentinel‑1 雷达。一定要用别人已经处理好的产品(ARIA 或 OPERA),不要自己从原始数据算。
难度
这一列里最难的。

水稻田的减排措施有人做吗

查账
你查什么
稻田一直泡着水会排甲烷。所以有一种做法是「时干时湿」,定期把水放掉,能明显减排。问题是:有人真的在做吗?
诀窍
雷达卫星能穿过稻叶,看到下面有没有积水。光学卫星做不到这一点。
难度

盲区 · 没人看,因为老卫星看不见

小湖泊

盲区 很强
关键洞察
以前的卫星,一个像素就有 300 米到 1 公里宽。一个小湖整个装不满一个像素,所以根本看不见。结果几十年来,藻华研究全集中在太湖、伊利湖这种大湖上——因为只有那些湖,老仪器看得清。
你做什么
Sentinel‑2 一个像素只有 10 到 20 米。所以你可以给你们省里所有面积不到 1 平方公里的小湖,做出史上第一份藻华记录。
然后是有意思的部分
再看:藻华多的湖,附近是不是养猪场特别多、或者化粪池特别密?
用什么数据
Sentinel‑2;NHD 湖泊边界;美国地质调查局的水质记录(用来核对)。
难度

山火之后,雪化得更早吗

盲区
原理
树被烧掉之后有两个后果。一、没有树冠给雪遮阴了。二、烧黑的地面颜色深,更吸热。两个都让雪提前化。
你测什么
火烧过的地方,雪比周围早化多少天?以及这个影响在火后十年里,随着树长回来,是怎么慢慢消失的?
为什么重要
美国西部城市喝的水,很大程度靠山上的雪春天慢慢融化来供应。雪四月就化完而不是六月,夏天就会缺水。这不只是生态问题,是供水问题。
用什么数据
Sentinel‑2 和 MODIS 的积雪覆盖;MTBS 的火烧严重度边界;Landsat 的地表反光数据。
难度

停电了,谁先修好

盲区
你查什么
夜光卫星能看出飓风过后哪些社区先恢复供电。穷社区是不是等得更久?
必须控制的因素
受灾有多严重。灾情更重的社区本来就修得慢,那跟公平无关。所以你必须先把这个因素固定住,才能下任何结论。
用什么数据
VIIRS Black Marble 每天的夜光数据,跨好几次风暴来看。
难度

光伏电站会让周围变热吗

还在吵
问题
大片太阳能板会让周边的地变热吗?学界现在还在吵,而且几乎没有大规模的实测。
你做什么
找几百个大型电站,比较「建之前 / 建之后」的地表温度和植被,再对比条件差不多但没建电站的地方。
难度

手工小规模金矿

盲区
你测什么
亚马逊或者加纳的河水有多浑,加上森林砍了多少,然后跟金价的变化对起来看。金价一涨,河是不是就变浑了?
难度

测错了东西 · 大家都去测那个容易测的

幽灵河流 —— 被埋掉的河

推荐
一句话
大家都在画还在的河。没人去画被抹掉的那些。完整方案看 第 H‑1 页
难度

晚上降温有多快

大部分被占了
一句话
大家都在某个时刻测温度有多高。没人测降温有多快。完整方案,以及被谁抢先了,看 第 H‑2 页
难度

给别人已发表的方法挑错

被低估
你做什么
拿一个已经发表的方法——「用卫星识别海上塑料垃圾」是最好的候选——换一片新海域去试,看它还灵不灵。它会不会把海藻、泡沫、或者水面反光当成塑料?
为什么这算贡献
在遥感领域,「负结果」和「找出方法的局限」是可以正经发表的。证明一个方法离开原来的条件就失效,本身就是贡献。而且这种研究很容易做。
难度

要下野外 · 靠雨靴,不靠代码

清理河流的半衰期

野外
你测什么
把 6 到 10 段小河彻底清干净,然后在第 2、4、8、16 周回去重新数垃圾。画出曲线,算出半衰期。完整做法看 第 H‑1 页
为什么算新
志愿者清河到处都有、钱也不少,但几乎没人测过垃圾回来得有多快。
难度
技术上简单,安排上麻烦——要定死时间表,可能还需要一个负责安全的大人。

大家以为自己浪费了多少食物

野外
你测什么
先去称你们学校实际扔了多少。再去问大家以为自己扔了多少。两个数字之间的差,就是你的发现。
为什么算新
单纯称垃圾的研究很多,但比较「实际 vs. 以为」的研究少得多。而这个差距,正是任何「让大家少浪费」的活动真正要对付的东西。
和吉卜力的连接
无脸男不停地吞,越吞越像怪物。最后是把吞下去的全部吐出来,才好起来。
难度
但要看 第 H‑4 页关于「要调查人就得先报批」那一条。
第 H‑3 页 / 共 12 页 第一部分 · 研究 13 个

第 H‑4 页·流程

从点子到投稿

做完了投去哪里、按什么顺序做,还有四条能保住项目的规矩。

实际要多久
一到两个学期
第一个发表目标
Journal of Emerging Investigators
先公开稿子
传到 EarthArXiv,无论如何先传

按这个顺序做

  1. 1

    先定研究哪座城市

    后面每一步都得等这个——查重、查数据、还有故事本身。

    你要找的城市:有真的河、有公开的市政投诉数据、有激光测高数据、有 1900 年左右的老地图,而且跟你本人有关系。

    避开巴尔的摩和底特律。

  2. 2

    查有没有人做过 —— 留一个星期

    在 Google Scholar 上搜 "buried stream" OR "stream burial" OR daylighting + [城市名]

    然后再搜这座城市的流域保护协会,还有最近那所大学的环境科学系。因为这类研究很多是没正式发表的报告和硕士论文。

    最后把最接近的三篇的参考文献看完。

  3. 3

    查数据能不能拿到 —— 一个下午

    • USGS topoView —— 看有没有你那个城市的老地图,最早到哪一年
    • USGS 3DEP —— 看有没有激光测高数据,精度多少
    • 市政数据网站 —— 看有没有「积水」这类投诉,而且带地址坐标
    • NHD —— 下载现在的官方水系图
    • Mapping Inequality —— 看这座城市有没有老的红线区地图
  4. 4

    写正式的研究方案

    要包括:你的假设(写成「如果错了,什么证据能推翻它」的样子)、方法、统计怎么做、时间表。

    统计方案要在看到结果之前就定下来。不然你很容易不知不觉地挑一个「结果好看」的算法。

    另外,这份文件本身就是你竞赛报名材料的大部分内容。

  5. 5

    先在一个小流域上试一遍

    不要一上来就铺开整座城市。

    先对一张地图、在一个小流域上跑一次水流计算、把一条幽灵河段从头到尾走通。

    你会发现有三件事比你想的难——而这时候改还很便宜。

  6. 6

    铺开,然后写

    分析一稳定就把稿子传到 EarthArXiv。这是个免费网站,能让别人引用你,还能给你的工作打上时间戳(证明你先做的)。

    然后去查 AGU 的摘要截止日期和各个竞赛的时间。

可以投的竞赛

竞赛合不合适说明
斯德哥尔摩青少年水奖几乎完美专门收水相关的题目,而且很看重「能不能用在现实里」。这是首要目标。
Regeneron ISEF很合适投「地球与环境科学」组。如果要做问卷调查,一定要早点查规则——见下面。
Genius Olympiad很合适专门以环境为主题。而且它欢迎带价值观的表达,不会因为你「有立场」扣分。
Regeneron STS有点难只收高三,要完整研究报告。
JSHS不错先地区赛再全国赛,很看现场讲得怎么样。
NASA Space Apps形式不一样是编程马拉松。适合用来快速做出第一个原型。
IEEE GRSS偏技术有学生论文比赛,正好在遥感这个方向。

可以投的期刊

期刊类型说明
EarthArXiv先公开的稿子免费、能被引用、马上就能挂上去。不管别的怎样,先做这个。
Journal of Emerging Investigators正经同行评审专门为还没上大学的作者设立的。最现实的第一站。
AGU / AMS 年会学生海报接受摘要投稿。投水文组,或者地球信息学组。
Freshwater Science期刊被埋河道这个题目最对口的地方。
Urban Climate / Landscape and Urban Planning期刊如果完整版本做成了,这两个是现实的选择。
Remote Sensing(MDPI)期刊够得上,但要交版面费。投之前先确认导师所在的学校能不能报销。
Environmental Research Letters期刊比较难,但如果多城市的结果很强,也不算异想天开。

四条一直要记着的规矩

规矩一 · 写代码之前先查重

留整整一个星期。这件事已经让我们丢掉过一次夜间降温项目了。

规矩二 · 永远要有配对好的对照组

对幽灵河流来说:按水泥地比例、坡度、上游集水面积,把被埋的河段和露天的河段配起来比。

不配对的话,你只是重新发现了「城市铺了水泥」。

规矩三 · 检查「挨着的地方会不会长得像」

先算 Moran's I。如果确实有这个问题,就换成专门处理它的模型。

空间数据直接跑最普通的回归,会算出假的「显著」。敏锐的评委会抓住这一点。

规矩四 · 要调查人,手续必须走在最前面

如果你要做 RQ4(问居民知不知道脚下有河),或者食物浪费那个问卷,那就属于「拿人做研究」。

这可能需要学校或者伦理委员会批准。而且ISEF 有专门的表格,必须在你收集任何数据之前就交上去。

事后补批是不存在的。所以:在你决定要做问卷的那一周就去查 ISEF 的最新规则,不要等到截止前一周。

第 H‑4 页 / 共 12 页 第一部分 · 研究

第 W‑1 页·安装

在 Windows 上装 Claude Code

从一台什么都没装的 Windows 电脑,到能用起来。你不用会写代码,也不用管理员权限。

系统要求
Windows 10 v1809 以上
硬件
内存 4 GB 以上
要多久
大约 10 分钟
要管理员权限吗
不要
要什么账号
Pro、Max、Team 或 Console
能用哪些命令行
PowerShell、CMD、Git Bash
开始之前 · 先看账号

Claude Code 需要 Pro、Max、Team、Enterprise 或者 Claude Console 账号。

免费版的 Claude.ai 用不了 Claude Code。

先确认这一点。不然你全部装完,会卡在登录那一步。

完全不想碰命令行?

Claude Code 有 Windows 桌面版,有图形界面,不用命令行。去 claude.com/download 下载。

但这一页讲的是命令行版本。如果你要同时跑 Python 和 GIS 分析,命令行版才是你要的。

  1. 1

    装 Git for Windows —— 可选,但建议装

    装了它,Claude Code 就能用一个叫 Bash 的工具。不装的话,它会改用 PowerShell,也能工作。

    你自己不需要学 Git。装它只是为了让 Claude Code 多一个工具。

    1. 打开 git-scm.com/downloads/win 下载。
    2. 运行安装程序,每一屏都点「下一步」。屏数很多,但没有一屏需要你改东西。
    3. 如果问你选编辑器,保持默认。
    4. 看到「Adjusting your PATH environment」那一屏,保持它推荐的选项。

    已经装过、或者不确定装没装?再装一次也没关系,不会出问题。

  2. 2

    打开 PowerShell

    PowerShell 是 Windows 自带的命令行,每台电脑上都有。

    Win + X,在菜单里选 Windows PowerShell 或者 终端。会出现一个黑窗口,里面有个闪烁的光标。

    PowerShell 还是 CMD?这个一定要分清

    Windows 有两个命令行程序,长得很像,但吃的命令不一样。看每行开头就能分:

    • PowerShell:显示 PS C:\Users\你的名字>,前面有 PS
    • CMD:显示 C:\Users\你的名字>,没有 PS
    别选带 (x86) 的那个

    如果开始菜单里有 Windows PowerShell (x86),不要用。那个是 32 位版本,安装会失败,报错说不支持 32 位 Windows。

    选名字里没有 (x86) 的那一个。

  3. 3

    运行安装命令

    复制下面这一行,用 Ctrl + V 或者右键粘贴到 PowerShell 里,然后按回车。

    PowerShell
    irm https://claude.ai/install.ps1 | iex

    这行命令的意思是:irm 把安装脚本下载下来,iex 把它跑起来。

    你会看到一堆文字往上滚。装完会显示 Claude Code successfully installed!

    如果你开的是 CMD 不是 PowerShell,用这一行:

    CMD
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    两个报错,意思都是「你开错窗口了」
    • 看到 The token '&&' is not a valid statement separator → 你在 PowerShell 里跑了 CMD 的命令。换成上面 PowerShell 那条。
    • 看到 'irm' is not recognized as an internal or external command → 你在 CMD 里跑了 PowerShell 的命令。换成 CMD 那条,或者去开 PowerShell。

    这样装的版本会自己在后台更新,所以安装命令你只跑这一次就够了。

  4. 4

    检查装好了没有

    PowerShell
    claude --version

    装好的话,它会打印一个版本号,后面跟着 (Claude Code),比如 2.1.211 (Claude Code)

    想查得更全,用下面这条。它会告诉你安装有没有问题、配置文件有没有写错,还会给修复建议。而且它不会启动对话。

    PowerShell
    claude doctor

    如果出现 'claude' is not recognized,说明装好了但 Windows 不知道去哪找它。解决办法在 第 W‑4 页

  5. 5

    登录

    先切到你要工作的文件夹,再启动。在命令行里,cd 就是「进入某个文件夹」的意思:

    PowerShell
    cd C:\Users\YourName\Documents\ghost-rivers
    claude

    第一次运行会让你登录,并且自动打开浏览器。登录过一次之后就记住了,以后不用再登。

    以后想换账号,在对话里输入 /login

其他安装方式

方式命令会自己更新吗什么时候用
官方安装脚本
推荐
irm https://claude.ai/install.ps1 | iex 大部分人就用这个。
WinGet winget install Anthropic.ClaudeCode 不会 你本来就用 WinGet 管软件。更新要自己跑 winget upgrade Anthropic.ClaudeCode
npm npm install -g @anthropic-ai/claude-code 要手动 你已经装了 Node.js 22 以上。更新要跑 npm install -g @anthropic-ai/claude-code@latest
绝对不要用 sudo 装

不要跑 sudo npm install -g。会造成权限混乱,而且有安全风险。

另外提醒:用 npm 更新的时候,一定要写 @latest。直接跑 npm update -g 可能根本不会更新到最新版。

直接在 Windows 上跑,还是在 WSL 里跑?

WSL 是 Windows 里的一个 Linux 环境。你两种都可以选。

方式需要什么有沙箱吗什么时候用
直接在 Windows 上什么都不用;Git for Windows 可选没有你的项目和工具都是 Windows 的
WSL 2要开启 WSL 2你要用 Linux 那套工具,或者想要沙箱
WSL 1要开启 WSL 1没有只在 WSL 2 用不了的时候

对一个跑在 Windows 笔记本上的学生项目,直接在 Windows 上跑就对了。

因为你的 QGIS、你的 Python、你下载的地图文件,全都在 Windows 这一边。跨到 WSL 那一边去读文件既慢又容易搞混。

如果你还是要用 WSL:安装和启动 claude 都要在 WSL 的窗口里面做,不是在 PowerShell 里。而且用 WSL 就不需要装 Git for Windows 了。

告诉它 Git Bash 在哪

装了 Git for Windows 之后,Claude Code 会自己去找 Git Bash。如果找不到,就在这个文件里告诉它:%USERPROFILE%\.claude\settings.json

settings.json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

注意那两道斜杠 \\。这种文件里必须写两道,写一道会出错。

想知道你的 Git 装在哪,跑这个:

PowerShell
Get-Command git | Select-Object Source

怎么卸载

如果你是用官方脚本装的:

PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

用 WinGet 装的:winget uninstall Anthropic.ClaudeCode

用 npm 装的:npm uninstall -g @anthropic-ai/claude-code

删配置会把历史一起删掉

删掉 %USERPROFILE%\.claude 这个文件夹,会顺带清掉你所有的设置、授权规则和聊天历史。确定要删再删。

第 W‑1 页 / 共 12 页 第二部分 · Windows 上的 Claude Code 已对照官方文档核实:2026‑08‑08

第 W‑2 页·使用

第一次用

命令行怎么跟你打交道、你说一句话之后它会做什么,还有第一天真正需要会的那几个操作。

前提
第 W‑1 页做完了
要会写代码吗
不用
怎么操作
全靠打字,不能点

关于命令行的六件事

  • 什么都点不了。用方向键移动。
  • Esc 可以把它打断。这是最有用的一个键。它一开始走错方向,就按 Esc 停掉,别等它做完。
  • Enter 发送。用大白话打字就行。
  • 调出上一条Tab 自动补全。
  • 打一个 / 就会列出所有能用的命令。
  • exit,或者在空行上按两次 Ctrl + D,就退出。

启动之后长这样

PowerShell
PS C:\Users\You> cd Documents\ghost-rivers
PS C:\Users\You\Documents\ghost-rivers> claude

  ╭──────────────────────────────────────────╮
  │  Claude Code v2.1.211                    │
  │  model: claude-opus-5                    │
  │  cwd:   C:\Users\You\Documents\...       │
  ╰──────────────────────────────────────────╯

  /help for commands · /resume to continue a previous conversation
> 

上面那个框里显示:版本、现在用的模型、还有当前文件夹(cwd)。

最后那一项很关键:它只能看到你启动它时所在的那个文件夹,以及里面的子文件夹。在错的地方启动,它就找不到你的文件。

先让它了解项目,再让它改东西

它会自己去读你的文件,你不用复制粘贴给它。先让它转一圈:

你打字这个项目是干什么的?
你打字解释一下文件夹结构
你打字这个项目用了哪些技术?

它也会回答关于它自己的问题。这是了解它能干什么最快的办法:

你打字Claude Code 能做什么?

第一次让它改东西

用大白话说你想要什么结果。

你打字在主文件里加一个 hello world 函数

它会:找到该改的文件 → 把改动给你看 → 问你同不同意 → 然后才动手。

会不会每次都问你,取决于下面这个设置。

权限模式:按 Shift + Tab 切换

这个设置决定「给它多大自由」。按 Shift + Tab 循环切换。

模式它会怎么做什么时候用
default每次改动前都问你从这个开始。在你还看不太懂它在干什么之前,就一直用这个。
acceptEdits改文件不再问你长时间的机械活。比如批量处理地图、重命名一百个文件。
plan只给方案,不动任何文件大改之前,或者你想先看看它打算怎么做。
auto后台自动检查,危险操作会被挡下部分账号才有。

不用学 Git 也能用 Git

Git 是记录「你什么时候改了什么」的工具。研究项目值得用它,因为它就是你的「撤销一整个糟糕下午」按钮。

你可以直接用说话的方式让它做:

你打字我改了哪些文件?
你打字把我的改动提交上去,写清楚改了什么
你打字新建一个叫 feature/flow-accumulation 的分支

值得马上养成的四个习惯

一 · 说具体

不要说「修一下 bug」。

要说「修一下登录的 bug:密码输错之后,用户看到的是一片空白」。

差别比你想的大得多。

二 · 大事情拆成编号步骤

给它一串步骤,不要给它一个愿望:

1. 载入 1903 年的地图和现在的官方水系图 2. 从高程数据算出水往哪流 3. 找出「水流量大、但官方水系图上 30 米内什么都没有」的地方
三 · 先让它看,再让它做

在让它分析之前,先说「读一下 data/ 里那三个表格,告诉我里面是什么」。

先有背景,再干活。

四 · 每个项目跑一次 /init

它会生成一个叫 CLAUDE.md 的文件。这是一份关于你项目的笔记,它每次开始都会先读一遍。

把你的约定写进去:用哪个坐标系、文件怎么命名、最后决定用哪个库。

这样你就不用一遍遍重复解释同样的事。

第 W‑2 页 / 共 12 页 第二部分 · Windows 上的 Claude Code

第 W‑3 页·速查

命令速查表

上面一类在 PowerShell 里打,用来启动它。下面一类在对话里打,用来控制它。

注意:不是每个命令每个人都有。跟你的账号类型和系统有关。

启动命令
5 个够用
斜杠命令
/ 看你有哪些
不确定就打
/help

在 PowerShell 里打的命令

命令作用例子
claude开始对话claude
claude "任务"开始时直接给它一个任务claude "fix the build error"
claude -p "问题"只问一次,打印答案就退出claude -p "explain this function"
claude -c接着这个文件夹里最近那次对话继续claude -c
claude -r从列表里挑一次以前的对话继续claude -r
claude --version看版本号claude --version
claude doctor检查安装和配置有没有问题claude doctor
claude update马上更新claude update

快捷键

按键作用
Esc打断它
Shift + Tab切换权限模式
/列出所有命令
Tab自动补全
上一条历史命令
Ctrl + D ×2在空行上退出
Ctrl + V粘贴

你真的会用到的那十几个

命令作用为什么有用
/help看有哪些命令卡住了就先打这个
/init生成项目笔记 CLAUDE.md每个项目跑一次,省得反复解释
/clear清空,重新开始换一个不相关的任务时用,回答会更准
/compact把之前的对话压缩成摘要聊太久开始跑偏的时候
/context看它现在记了多少东西让你知道为什么开始跑偏
/resume回到以前某次对话接着昨天的分析继续
/rewind把代码和对话退回到之前某个点这就是撤销键。早点学会它。
/diff看还没提交的改动提交之前先看一眼
/plan切到「只给方案不动手」模式大改之前先把思路定对
/model换一个模型跑统计用强的,整理文件用快的
/permissions设置哪些操作不用再问你省得同一条安全命令批准四十次
/memory编辑项目笔记想到一条约定就随手记下
/usage看用了多少、花了多少知道自己花了多少钱
/doctor检查配置有东西不对劲的时候
/exit退出

其他值得知道的

命令作用
/add-dir <路径>让它这次也能访问另一个文件夹
/cd <路径>换到另一个文件夹
/config打开设置界面
/effort设置它想得多深
/fast开关快速模式(还是同一个模型,只是输出更快)
/code-review让它审查代码有没有错、能不能简化
/verify <路径>在你依赖这段代码之前,先核对它对不对
/simplify把代码改简单一点
/security-review检查有没有安全漏洞
/dataviz问它图表该怎么设计
/deep-research让它上网多方查资料,写一份带引用的报告
/export把这次对话导出成文本
/copy复制它最后一条回答
/theme换配色(浅色 / 深色 / 自动)
/mcp管理外部工具连接
/login登录或换账号
/bug报告问题
除了命令行,还能在哪用

同一个账号也能用在 VS CodeJetBrains 插件里、桌面版网页版claude.ai/code),还有 GitHub Actions

在命令行里打 /desktop/web/teleport,可以把当前这次对话搬过去继续。

第 W‑3 页 / 共 12 页 第二部分 · Windows 上的 Claude Code

第 W‑4 页·报错

报错了怎么办

在下面找你看到的那句报错。这些都是 Windows 上真的会碰到的。

先做这个
claude doctor
最常见的原因
开错了窗口,或者路径没设好
第二常见
用的是免费账号
先跑这一条

claude doctor 会告诉你安装有没有问题、配置有没有写错,还会给修复建议。而且它不会启动对话。

往下逐条排查之前,先跑一次它。

'claude' is not recognized

意思是:装是装好了,但 Windows 不知道去哪找它。

在 PowerShell 里跑这两行:

PowerShell
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

然后把 PowerShell 整个关掉,重新开一个新窗口。这一步不能省——已经开着的窗口不会知道路径变了。

再试一次 claude

'irm' is not recognized as an internal or external command

意思是:你在 CMD 里,不是 PowerShell。

关掉这个窗口,按 Win + X 开 PowerShell。或者用 CMD 版本的命令:

CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

The token '&&' is not a valid statement separator

意思是:正好反过来——你在 PowerShell 里跑了 CMD 的命令。

改用 irm https://claude.ai/install.ps1 | iex

Could not create SSL/TLS secure channel

意思是:你的 Windows 比较老,用的加密方式过时了,连不上服务器。

先在同一个窗口里跑第一行,然后再跑安装:

PowerShell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Claude Code does not support 32-bit Windows

意思是:如果你的电脑是 64 位的(现在基本都是),那这个报错几乎肯定是因为你开的是 Windows PowerShell (x86)

关掉它,从开始菜单里开那个名字不带 (x86) 的,重新跑一次。

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

意思是:它一个能用的命令行工具都没找到,但它至少需要一个。

按顺序试:

  1. 确认 powershell.exe 在系统路径里。它一般在 C:\Windows\System32\WindowsPowerShell\v1.0\。或者去装 PowerShell 7
  2. 或者装 Git for Windows,这样就有 Git Bash 了。
  3. 如果 Git 已经装了但它找不到,就直接告诉它位置:
PowerShell
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

但这一行只对当前窗口有效。想让它永久生效,就按 第 W‑1 页的办法写进 settings.json

如果你的 Git 装在别的地方,用 Get-Command git | Select-Object Source 找出来。

屏幕上出现一堆 HTML 代码

意思是:下载地址返回的是一个网页,不是安装脚本。

如果那个网页写着 App unavailable in region,说明 Claude Code 在你所在的国家还不能用。

如果不是,就再跑一次命令。偶尔会失败一次。

登录失败,或者根本没有 Claude Code 这个选项

先看你的账号类型

Claude Code 需要 Pro、Max、Team、Enterprise 或者 Claude Console 账号。

免费版 Claude.ai 用不了。

账号问题重装多少次都没用。

它搜不到你的文件

Claude Code 自带一个搜索工具叫 ripgrep。如果在你的项目里搜索总是什么都搜不到,一般就是这个东西出问题了。去查官方的搜索排错页面。

本来都好,突然卡住不动了

意思是:很可能有个程序在等你输入什么,但那个提示 Claude 看不见。

Esc 打断它。

以后让它跑工具的时候,尽量让它加上「不需要交互」的参数。

同时装了两份

如果你卸载之后 claude 还能跑,那你可能用另一种方式又装了一份。

claude doctor 会告诉你它现在实际用的是哪一份。

第 W‑4 页 / 共 12 页 第二部分 · Windows 上的 Claude Code

第 W‑5 页·实战

用它来做这个研究

这份手册的两半在这里合起来。幽灵河流每一步该怎么问它,以及哪些地方你绝对不能直接相信它。

用什么
Python · QGIS · Earth Engine
主要的库
geopandas · richdem · rasterio
先跑
/init

项目开头设置一次就好

在项目文件夹里启动,跑一次 /init。然后把它猜不到的事告诉它。这些以后每次都生效:

你打字写进 CLAUDE.md:这个项目要找出 [城市] 被埋掉的河道。 所有空间数据用 EPSG:26918 这个坐标系。 栅格放 data/raster/,矢量放 data/vector/,notebook 放 notebooks/。 用 geopandas 和 rasterio,不要用 arcpy。 中间结果一律写到 data/derived/, 永远不要覆盖 data/raw/ 里的东西。

一步一步来

第一步:装 Python 环境

这一步历来最能吃时间,因为处理地图的那几个库特别难装。所以要说清楚你要什么:

你打字在 Windows 上帮我配一个处理地理数据的 Python 环境。 我要 geopandas、rasterio、richdem、rioxarray、matplotlib。 每一步在跑之前先解释给我听。 还有:这里用 conda 是不是比 pip 好?为什么?

第二步:把老地图对上坐标

你打字我有一张 1903 年的老地形图扫描件,JPEG 格式,没有坐标信息。 带我用 QGIS 把它对到正确的位置上—— 该选哪些参照点、选几个、 对完之后怎么看误差有多大。 我需要知道我引入了多少误差。

注意最后一句。你的论文里要写「局限」这一节,那时候需要这个误差数字。所以做的时候就问出来,不要等到最后再回头补。

第三步:算水往哪流

你打字写个脚本,读 data/raster/dem.tif 这个高程文件, 先把里面的坑填掉,再用 richdem 算水流方向和汇流量, 最后输出一张河网图,只保留集水面积大于 5 公顷的。 每一步都写注释,好让我能在论文的方法部分解释清楚。
最重要的一句话

「每一步都写注释,好让我能在论文里解释清楚」——这是这一整页里最值钱的一句。

因为你以后要向评委解释这套分析,而评委可能比你更懂水文。

你解释不了的代码,比没有代码更糟。

第四步:判断哪些河段被埋了

你打字我有三个图层:算出来的河网、描出来的 1903 年河道、 还有现在的官方水系图。 找出前两个都说有河、但官方水系图 30 米内什么都没有的河段。 然后告诉我这条规则可能在哪里出错—— 我想先看到有哪些是误判,再决定信不信这个数字。

第五步:配对比较

你打字我要把被埋的河段和露天的河段比较, 同时要按水泥地比例、坡度、上游集水面积配对。 告诉我有哪几种配对方法可以选, 针对大约 200 个河段推荐一种, 并且说清楚每种方法各自假设了什么。

第六步:统计

你打字对这个回归模型的残差算一下 Moran's I。 如果确实存在空间自相关,就换成合适的空间模型, 并且解释你为什么选那一种。

第七步:画图

你打字画一张能放进论文的图:把幽灵河网叠在收入分区图上, 要有比例尺、指北针,配色要对色盲友好。 标注用衬线字体。不要任何多余装饰。

哪些地方不能直接信它

三条硬规矩

一、绝对不要引用你没读过的论文。

如果它给你一篇参考文献,你要自己去找到、打开、至少把摘要和方法读一遍。

这不是怀疑那篇论文存不存在。而是——你没法为一个你没读过的东西辩护。评委一问细节你就完了。

二、统计方法要由你来解释。

问它「有哪些选择、各自的前提是什么」,不要问它「我该用哪个」。

评委问你「为什么用这个模型不用那个」的时候,「它推荐的」是不及格的回答。

三、至少手工核对一次。

挑一条幽灵河段,在 QGIS 里用尺子量一下长度,看跟脚本算出来的一样不一样。人口数据的对接也这样核对一次。

单位搞错、坐标系搞错,是地图分析「从头错到尾但没人发现」的最常见方式。

还有:要如实说明你用了 AI

现在竞赛越来越会问你「你怎么用 AI 工具的」。如实说明是正常的,不会因此吃亏。

做的时候就随手记下来:哪些部分是它帮的(装环境、写代码草稿、调图表样式),哪些是你自己的分析和判断。

边做边记,只要几分钟。等到四月再回头想,就想不起来了。

第 W‑5 页 / 共 12 页 第二部分 · Windows 上的 Claude Code

第 A‑1 页·附录

参考资料

做这些方案时查过的所有材料,按用途分组。标了核心的,写研究方案之前一定要读。

查过的日期
2026‑08‑08
要付费才能看的
1 篇,下面标出来了

河道填埋和「遗忘」· 核心

  1. Elmore & Kaushal(2008),《Frontiers in Ecology and the Environment》。esajournals.onlinelibrary.wiley.com/doi/10.1890/070101 河道填埋最基础的一篇,也是你要用的那套方法的来源。这篇要认真读完。
  2. Soga & Gaston(2018),讲基线漂移。esajournals.onlinelibrary.wiley.com/doi/10.1002/fee.1794 「环境代际失忆」这个说法的定义出自这里。
  3. 关于基线漂移到处都有的全球综述。pmc.ncbi.nlm.nih.gov/articles/PMC11494512 证明这个现象是普遍的。你要论证 RQ4 有意义,就需要这个。
  4. UMCES 的被埋河道模型。umces.edu/campuses/al/buried-streams 具体怎么建模的实操细节。

河道修复公平不公平

  1. PLOS Water:修复可能反而加大了不公平。journals.plos.org/water — pwat.0000308 正是这个不太舒服的发现,让 RQ2 不只是走个形式。
  2. 《Freshwater Science》:河流修复中的公平问题。journals.uchicago.edu/doi/full/10.1086/721651
  3. 河道重新挖开之后,水里小虫多快恢复。researchgate.net — Re-engineering buried urban streams
  4. 全球南方和北方开盖工程的对比。frontiersin.org — fevo.2022.838794

幽灵河道和城市淹水

  1. Planet Detroit:被埋的河道是淹水的主要原因。planetdetroit.org/2025/07/detroit-ghost-streams-flooding 在底特律已经把 RQ3(a)做掉一部分了——所以你换一座城市。
  2. 纽约用市政投诉研究街道积水。sciencedirect.com — S0022169421013500 证明市政投诉数据可以用来找淹水点。但他们看的是雨水口和水泥地,不是被埋的河道——那个空白是你的。

城市高温和夜间温度

  1. Shreevastava 等(2025),《Nature Communications》,洛杉矶的研究。 动手做 H‑2 之前,先把这篇读了。它就是那篇抢先做完的论文。
  2. 2025 年的夜间温度综述,《GIScience & Remote Sensing》,编号 10.1080/15481603.2025.2527990要付费 本来是最理想的资料。如果你能通过学校或图书馆账号拿到,值得去拿。
  3. Chakraborty(2019)、Hsu(2021)、Chang(2022)、Li(2023)—— 城市高温公平性的一系列研究。 这些全都在测温度有多高。它们合起来,就是「没人测降温速度」这个说法的证据。
  4. Ramamurthy & Bou‑Zeid(2017)—— 湿热和城市热压力。
  5. Lu(2021)和 Wen(2022)—— 关于温度日变化曲线的模型。 「降温速度」这个指标就是从这里来的。
  6. 健康方面的文献:《Lancet Planetary Health》《European Heart Journal》《Environmental Epidemiology》。 这些是「为什么要专门关心夜间温度」的理由。
  7. 《Science Advances》关于众包气温数据的研究。 和「地表温度不等于气温」这件事有关。

数据和工具

  1. USGS topoView —— 老地形图,免费下载。
  2. USGS 3DEP —— 激光测高数据。
  3. NHD —— 美国官方水系图。
  4. NLCD —— 水泥地比例和树冠覆盖数据。
  5. Mapping Inequality —— 数字化的老红线区地图。
  6. Sanborn 火险保险图 —— 精细到每栋楼的老地图。
  7. NASA AppEEARS —— 点采样模式,直接给你整齐的表格。 ECOSTRESS 不在 Earth Engine 里的绕路办法。
  8. NASA ECOSTRESS‑Data‑Resources。
  9. CAPA Heat Watch / NIHHIS,网址 heat.gov —— 地面实测的气温。
  10. Google Earth Engine 配 geemap;Microsoft Planetary Computer;QGIS;geopandasrichdem / whitebox

《千与千寻》那些事是真的吗

  1. Looper 关于河神那一幕真实来源的报道。looper.com/1018413 宫崎骏清河的经历,和那辆自行车。他说:「我清理过一条河。」
  2. GKIDS Films 的确认。x.com/GKIDSfilms/status/1054809687726555136
  3. 巴尔的摩的「Ghost Rivers」公共艺术项目。 可以引用的好例子。也说明这个名字在巴尔的摩被占了。

Claude Code 官方文档

  1. 安装说明。code.claude.com/docs/en/setup
  2. 快速上手。code.claude.com/docs/en/quickstart
  3. 新手命令行指南,里面有完整的 Windows 步骤。code.claude.com/docs/en/terminal-guide
  4. 命令速查。code.claude.com/docs/en/commands
  5. 安装和登录报错处理。code.claude.com/docs/en/troubleshoot-install
第 A‑1 页 / 共 12 页 附录 所有链接查过:2026‑08‑08