Using Marigold
      Back to home
      1. Knowledge Base
      2. Marigold
      3. Using Marigold

      Vector Upload Guidelines

      With the 2.6.0 update, Marigold now supports more vector upload formats and coordinate systems than ever. A complete compatibility list is provided below.

      Supported Formats

      Previous versions of Marigold exclusively supported vector uploads in .geojson file format and required these uploads to be registered in the WGS84 latitude longitude coordinate reference system (EPSG:4326). While this open source format is highly compatible with Descartes Labs python-based platform, support for additional file formats and coordinate systems was a highly requested feature by Marigold users. With the new changes, vectors in most common formats and projections can now be uploaded to Marigold directly without the need for reformatting or reprojection.

      Remember: Vector formats that consist of multiple individual files, like ESRI Shapefiles and MapInfo Tab files, must be compressed into a .zip folder before they are uploaded 

      The list of supported formats includes: 

      • .geojson
        • Geojsons remain fully compatible for vector uploads as a single .geojson file
        • Due to .geojson convention, this format still requires exclusively EPSG:4326
          • Uploading .geojson files in different coordinate systems may result in the vectors appearing in the incorrect location.
      • .shp
        • ESRI shapefiles must be uploaded in a .zip archive folder.
        • The .zip must include all associated files in addition to the .shp file (e.g., .shx, .dbf, .prj, .cpg)
        • Most coordinate systems are supported.
      • .tab
        • MapInfo tab files must be uploaded in a zip archive folder.
        • The .zip must include all associated files in addition to the .tab file (e.g., .dat, .id, .map).
        • Most coordinate systems are supported.
      • .gpkg
        • Geopackage files are highly flexible and can contain numerous spatial and non-spatial table files.
        • Current support for .gpkg files will open and display the first spatial table within the .gpkg file.
          • We recommend separating complex .gpkg files into individual tables prior to uploading to Marigold.
        • Most coordinate systems are supported.
      • .parquet
        • Parquet files are a relatively new and highly efficient vector table format gaining traction as an open source option for large vector databases.
        • Exports from Descartes Lab's Iris software for ground deformation monitoring are provided in .parquet format and can now be uploaded directly into Marigold.
        • Most coordinate systems are supported.
      • .dxf
        • AutoCAD DXF files are a common output from 3D modeling software programs like Seequent's Leapfrog.
          • Marigold remains limited to 2D geographical coordinates, and 3D DXF files may not behave as expected
        • Due to the nature of the DXF format, no coordinate reference system is provided with these files and therefore the CRS cannot be determined by Marigold. Currently DXF files are only supported in WGS84 latitude-longitude (EPSG:4326).
          • Uploading DXF files in different coordinate systems may result in the vectors appearing in the incorrect location.