LoadTableField

Overview

LoadTableField is a field widget to load points data. The user will provide a .csv or .txt file containing labeled dataset. The relevant columns (lat, long and id) can then be identified in the updated select. Once everything is set, the widget will populate itself with a json dict. {pathname, id_column, lat_column,lng_column}. It inherits from the SepalWidget class. Any argument from the original Layout ipyvuetify class can be used to complement it.

from pysepal import sepalwidgets as sw

# correct colors for the documentation
# set to dark in SEPAL by default
import ipyvuetify as v
v.theme.dark = False

point_file = sw.LoadTableField()
point_file

/home/docs/checkouts/readthedocs.org/user_builds/sepal-ui/envs/latest/lib/python3.10/site-packages/google/api_core/_python_version_support.py:273: FutureWarning: You are using a Python version (3.10.19) which Google will stop supporting in new releases of google.api_core once it reaches its end of life (2026-10-04). Please upgrade to the latest Python version, or at least Python 3.11, to continue receiving updates for google.api_core past that date.
  warnings.warn(message, FutureWarning)

the value can be retrieve from the v_model trait.

# will return the value of the widget
point_file.v_model

# will be thrown when v_model change
point_file.observe(lambda change: print(change['new']))

# bin the value to a io object using an Alert widget
sw.Alert().bind(point_file, io, 'point_file_attr')

Warning

Remember that the v_model value will contain information to read the point file with geopandas in the following format : {pathname, id_column, lat_column,lng_column}. No points are actually red by the widget.

Note

More information can be found here.