Skip to main content
GET
/
sem
/
histograms
/
{data_id}
/
import requests

response = requests.get(
    "https://api.atomscale.ai/sem/histograms/d290f1ee-6c54-4b01-90e6-d701748f0851/",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    params={"return_features": ["area", "circularity"]}
)
histograms = response.json()

{
  "data_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "series_by_feature": [
    {
      "name": "area",
      "unit": "nm^2",
      "facet": null,
      "histogram_bins": [
        {"x0": 0.0, "x1": 100.0, "count": 12},
        {"x0": 100.0, "x1": 200.0, "count": 45},
        {"x0": 200.0, "x1": 300.0, "count": 30}
      ]
    }
  ]
}
Returns binned distributions of the morphological features detected in an SEM image (for example, feature area, diameter, and circularity). Each requested feature is returned as its own histogram series.
​
data_id
string
required
The data entry UUID for the SEM image
​
return_features
array
Which feature histograms to return. Defaults to all supported features.

​
Response

​
data_id
string
Data entry UUID
​
series_by_feature
array
One histogram series per requested feature
import requests

response = requests.get(
    "https://api.atomscale.ai/sem/histograms/d290f1ee-6c54-4b01-90e6-d701748f0851/",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    params={"return_features": ["area", "circularity"]}
)
histograms = response.json()

{
  "data_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "series_by_feature": [
    {
      "name": "area",
      "unit": "nm^2",
      "facet": null,
      "histogram_bins": [
        {"x0": 0.0, "x1": 100.0, "count": 12},
        {"x0": 100.0, "x1": 200.0, "count": 45},
        {"x0": 200.0, "x1": 300.0, "count": 30}
      ]
    }
  ]
}