Skip to content

Geospatial/Geometry

src.dx.datatypes.geometry.generate_lat_float_series(num_rows)

Generate a series of random float values representing latitude values.

Parameters:

Name Type Description Default
num_rows int

Number of rows to generate

 required
Source code in src/dx/datatypes/geometry.py 
26
27
28
29
30
31
32
33
34
35
def generate_lat_float_series(num_rows: int):
    """
    Generate a series of random `float` values representing latitude values.

    Parameters
    ----------
    num_rows: int
        Number of rows to generate
    """
    return pd.Series([random.randint(-90, 89) + np.random.rand() for _ in range(num_rows)])

src.dx.datatypes.geometry.generate_lon_float_series(num_rows)

Generate a series of random float values representing longitude values.

Parameters:

Name Type Description Default
num_rows int

Number of rows to generate

 required
Source code in src/dx/datatypes/geometry.py 
38
39
40
41
42
43
44
45
46
47
def generate_lon_float_series(num_rows: int):
    """
    Generate a series of random `float` values representing longitude values.

    Parameters
    ----------
    num_rows: int
        Number of rows to generate
    """
    return pd.Series([random.randint(-180, 179) + np.random.rand() for _ in range(num_rows)])

src.dx.datatypes.geometry.generate_latlon_series(num_rows)

Generate a series of shapely.geometry.Points with latitude and longitude values.

Parameters:

Name Type Description Default
num_rows int

Number of rows to generate

 required
Source code in src/dx/datatypes/geometry.py 
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
def generate_latlon_series(num_rows: int):
    """
    Generate a series of `shapely.geometry.Point`s with latitude and longitude values.

    Parameters
    ----------
    num_rows: int
        Number of rows to generate
    """
    if not geopandas_installed():
        logger.warning("geopandas is not installed, skipping generate_latlon_series")
        return np.nan

    lats = [random.randint(-90, 89) + np.random.rand() for _ in range(num_rows)]
    lons = [random.randint(-180, 179) + np.random.rand() for _ in range(num_rows)]
    return gpd.GeoSeries(gpd.points_from_xy(lons, lats))

src.dx.datatypes.geometry.generate_filled_geojson_series(num_rows, existing_latlon_series=None)

Generate a series of shapely.geometry.Polygon values by creating shapely.geometry.Point values and applying a randomized .buffer() on them, resulting in circular filled Polygon objects.

Parameters:

Name Type Description Default
num_rows int

Number of rows to generate

 required
existing_latlon_series Optional[Series]

If provided, use this series of shapely.geometry.Point values

 None
Source code in src/dx/datatypes/geometry.py 
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
def generate_filled_geojson_series(
    num_rows: int,
    existing_latlon_series: Optional[pd.Series] = None,
):
    """
    Generate a series of `shapely.geometry.Polygon` values by
    creating `shapely.geometry.Point` values and applying a randomized
    `.buffer()` on them, resulting in circular filled `Polygon` objects.

    Parameters
    ----------
    num_rows: int
        Number of rows to generate
    existing_latlon_series: Optional[pd.Series]
        If provided, use this series of `shapely.geometry.Point` values
    """
    if not geopandas_installed():
        logger.warning("geopandas is not installed, skipping filled_geojson_column")
        return np.nan

    if existing_latlon_series is None:
        latlon_series = generate_latlon_series(num_rows)
    else:
        latlon_series = existing_latlon_series
    buffer_series = gpd.GeoSeries(latlon_series).apply(lambda x: x.buffer(np.random.rand()))
    return gpd.GeoSeries(buffer_series)

src.dx.datatypes.geometry.generate_exterior_bounds_geojson_series(num_rows, existing_latlon_series=None)

Generate a series of shapely.geometry.Polygon values by create shapely.geometry.Point values, applying a randomized .buffer() on them, and getting the exterior of the resulting object's .envelope, resulting in rectangular LineString objects.

Parameters:

Name Type Description Default
num_rows int

Number of rows to generate

 required
existing_latlon_series Optional[Series]

If provided, use this series of shapely.geometry.Point values

 None
Source code in src/dx/datatypes/geometry.py 
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
def generate_exterior_bounds_geojson_series(
    num_rows: int,
    existing_latlon_series: Optional[pd.Series] = None,
):
    """
    Generate a series of `shapely.geometry.Polygon` values by
    create `shapely.geometry.Point` values, applying a randomized `.buffer()`
    on them, and getting the exterior of the resulting object's `.envelope`,
    resulting in rectangular `LineString` objects.

    Parameters
    ----------
    num_rows: int
        Number of rows to generate
    existing_latlon_series: Optional[pd.Series]
        If provided, use this series of `shapely.geometry.Point` values
    """
    if not geopandas_installed():
        logger.warning("geopandas is not installed, skipping exterior_geojson_column")
        return np.nan

    if existing_latlon_series is None:
        latlon_series = generate_latlon_series(num_rows)
    else:
        latlon_series = existing_latlon_series

    envelope_series = gpd.GeoSeries(latlon_series).apply(
        lambda x: x.buffer(np.random.rand()).envelope.exterior
    )
    return gpd.GeoSeries(envelope_series)