DEVS-Fire API

loadAspect

Upload a custom aspect map from a space- or tab-separated .txt file. Sent as a raw `text/plain` body with a `fileName` header. Also updates `cellResolution` from the file's `cellsize` field if present. **File format:** space- or tab-separated grid of double-precision aspect values (degrees), one row per line. Must match the dimensions of any uploaded fuel or slope map.

POST
/loadAspect

Request Body

text/plain

body*string

Space- or tab-separated .txt file of aspect values.

Query Parameters

Prop

Type

Header Parameters

Prop

Type

import requestsbase_url: str = "https://firesim.cs.gsu.edu/api/loadAspect/"response = requests.post(    base_url,    params={"userToken": "abc123xyz"},    files={"file": open("aspect.txt", "rb")},    headers={"fileName": "aspect.txt"},)print(response.text)
"Aspect Map Updated"
""
{
  "timestamp": "2026-05-20T16:42:15.604+00:00",
  "status": 500,
  "error": "Internal Server Error",
  "path": "/api/loadAspect"
}

Response Body

text/plain

text/plain

application/json