geobase/building-footprint-segmentation

	@geobase-js/geoai

task = building-footprint-segmentation

🛠 Model Purpose

This model is part of the @geobase-js/geoai javascript library.

GeoAi enables geospatial AI inference directly in the browser or Node.js without requiring a heavy backend.

GeoAi pipeline accepts geospatial polygons as input (in GeoJSON format) and outputs results as a GeoJSON FeatureCollection, ready for use with libraries like Leaflet and Mapbox GL.

---

🚀 Demo

Explore the model in action with the interactive Demo.

📦 Model Information

• Architecture: U-Net–style Convolutional Neural Network (CNN)
• Source Model: gunayk3/building_footprint_segmentation
• Quantization: Yes

---

💡 Example Usage

import { geoai } from "@geobase-js/geoai";

// Example polygon (GeoJSON)
const polygon = {
  type: "Feature",
  properties: {},
  geometry: {
    coordinates: [
      [
        [-117.42351735397804, 47.659839523657155],
        [-117.42351735397804, 47.6533360375098],
        [-117.41165191515506, 47.6533360375098],
        [-117.41165191515506, 47.659839523657155],
        [-117.42351735397804, 47.659839523657155]
      ],
    ],
    type: "Polygon",
  },
} as GeoJSON.Feature;

// Initialize pipeline
const pipeline = await geoai.pipeline(
  [{ task: "building_footprint_segmentation" }],
  providerParams
);
 
// Run detection
const result = await pipeline.inference({
  inputs: { polygon }
});
 
// Sample output format
// {
//     "detections": {
//         "type": "FeatureCollection",
//         "features": [
//             {
//                 "type": "Feature",
//                 "properties": {
//                     "confidence": 0.8438083529472351
//                 },
//                 "geometry": {
//                     "type": "Polygon",
//                     "coordinates": [
//                        [
//                          [-117.41771164648438, 47.650790343749996],
//                          [-117.41766873046875, 47.650790343749996],
//                          [-117.41762581445313,47.650790343749996],
//                          ...
//                          [-117.41771164648438, 47.650790343749996]
//                        ]
//                     ]
//                 }
//             },
//             {"type": 'Feature', "properties": {…}, "geometry": {…}}, 
//             {"type": 'Feature', "properties": {…}, "geometry": {…}},
//         ]
//     },
//     "geoRawImage": GeoRawImage {data: Uint8ClampedArray(1048576), width: 512, height: 512, channels: 4, bounds: {…}, …}
// }

📖 Documentation & Demo

• GeoBase Docs: https://docs.geobase.app/geoai
• NPM Package: https://www.npmjs.com/package/@geobase-js/geoai
• Demo Playground: https://docs.geobase.app/geoai-live/tasks/building-footprint-segmentation
• GitHub Repo: https://github.com/decision-labs/geobase-ai.js