maps4fs 0.7.0__py3-none-any.whl → 0.7.3__py3-none-any.whl

maps4fs/generator/component.py

@@ -4,17 +4,20 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
 
+import osmnx as ox  # type: ignore
+
 if TYPE_CHECKING:
     from maps4fs.generator.game import Game
 
 
-# pylint: disable=R0801, R0903
+# pylint: disable=R0801, R0903, R0902
 class Component:
     """Base class for all map generation components.
 
     Args:
         coordinates (tuple[float, float]): The latitude and longitude of the center of the map.
-        distance (int): The distance from the center to the edge of the map.
+        map_height (int): The height of the map in pixels.
+        map_width (int): The width of the map in pixels.
         map_directory (str): The directory where the map files are stored.
         logger (Any, optional): The logger to use. Must have at least three basic methods: debug,
             info, warning. If not provided, default logging will be used.
@@ -24,18 +27,21 @@ class Component:
         self,
         game: Game,
         coordinates: tuple[float, float],
-        distance: int,
+        map_height: int,
+        map_width: int,
         map_directory: str,
         logger: Any = None,
         **kwargs,  # pylint: disable=W0613, R0913, R0917
     ):
         self.game = game
         self.coordinates = coordinates
-        self.distance = distance
+        self.map_height = map_height
+        self.map_width = map_width
         self.map_directory = map_directory
         self.logger = logger
         self.kwargs = kwargs
 
+        self.save_bbox()
         self.preprocess()
 
     def preprocess(self) -> None:
@@ -61,3 +67,35 @@ class Component:
             NotImplementedError: If the method is not implemented in the child class.
         """
         raise NotImplementedError
+
+    def get_bbox(self, project_utm: bool = False) -> tuple[int, int, int, int]:
+        """Calculates the bounding box of the map from the coordinates and the height and
+        width of the map.
+
+        Args:
+            project_utm (bool, optional): Whether to project the bounding box to UTM.
+
+        Returns:
+            tuple[int, int, int, int]: The bounding box of the map.
+        """
+        north, south, _, _ = ox.utils_geo.bbox_from_point(
+            self.coordinates, dist=self.map_height / 2, project_utm=project_utm
+        )
+        _, _, east, west = ox.utils_geo.bbox_from_point(
+            self.coordinates, dist=self.map_width / 2, project_utm=project_utm
+        )
+        bbox = north, south, east, west
+        self.logger.debug(
+            "Calculated bounding box for component: %s: %s, project_utm: %s",
+            self.__class__.__name__,
+            bbox,
+            project_utm,
+        )
+        return bbox
+
+    def save_bbox(self) -> None:
+        """Saves the bounding box of the map to the component instance from the coordinates and the
+        height and width of the map.
+        """
+        self.bbox = self.get_bbox(project_utm=False)
+        self.logger.debug("Saved bounding box: %s", self.bbox)

maps4fs/generator/config.py

@@ -14,7 +14,8 @@ class Config(Component):
 
     Args:
         coordinates (tuple[float, float]): The latitude and longitude of the center of the map.
-        distance (int): The distance from the center to the edge of the map.
+        map_height (int): The height of the map in pixels.
+        map_width (int): The width of the map in pixels.
         map_directory (str): The directory where the map files are stored.
         logger (Any, optional): The logger to use. Must have at least three basic methods: debug,
             info, warning. If not provided, default logging will be used.
@@ -22,7 +23,7 @@ class Config(Component):
 
     def preprocess(self) -> None:
         self._map_xml_path = self.game.map_xml_path(self.map_directory)
-        self.logger.debug(f"Map XML path: {self._map_xml_path}")
+        self.logger.debug("Map XML path: %s.", self._map_xml_path)
 
     def process(self):
         self._set_map_size()
@@ -36,10 +37,11 @@ class Config(Component):
         self.logger.debug("Map XML file loaded from: %s.", self._map_xml_path)
         root = tree.getroot()
         for map_elem in root.iter("map"):
-            width = height = str(self.distance * 2)
-            map_elem.set("width", width)
-            map_elem.set("height", height)
-            self.logger.debug("Map size set to %sx%s in Map XML file.", width, height)
+            map_elem.set("width", str(self.map_width))
+            map_elem.set("height", str(self.map_height))
+            self.logger.debug(
+                "Map size set to %sx%s in Map XML file.", self.map_width, self.map_height
+            )
         tree.write(self._map_xml_path)
         self.logger.debug("Map XML file saved to: %s.", self._map_xml_path)
 

maps4fs/generator/dem.py

@@ -7,13 +7,14 @@ import shutil
 
 import cv2
 import numpy as np
-import osmnx as ox  # type: ignore
 import rasterio  # type: ignore
 import requests
 
 from maps4fs.generator.component import Component
 
 SRTM = "https://elevation-tiles-prod.s3.amazonaws.com/skadi/{latitude_band}/{tile_name}.hgt.gz"
+DEFAULT_MULTIPLIER = 3
+DEFAULT_BLUR_RADIUS = 21
 
 
 # pylint: disable=R0903
@@ -22,16 +23,14 @@ class DEM(Component):
 
     Args:
         coordinates (tuple[float, float]): The latitude and longitude of the center of the map.
-        distance (int): The distance from the center to the edge of the map.
+        map_height (int): The height of the map in pixels.
+        map_width (int): The width of the map in pixels.
         map_directory (str): The directory where the map files are stored.
         logger (Any, optional): The logger to use. Must have at least three basic methods: debug,
             info, warning. If not provided, default logging will be used.
     """
 
     def preprocess(self) -> None:
-        self._blur_seed: int = self.kwargs.get("blur_seed") or 5
-        self._max_height: int = self.kwargs.get("max_height") or 200
-
         self._dem_path = self.game.dem_file_path(self.map_directory)
         self.temp_dir = "temp"
         self.hgt_dir = os.path.join(self.temp_dir, "hgt")
@@ -39,24 +38,27 @@ class DEM(Component):
         os.makedirs(self.hgt_dir, exist_ok=True)
         os.makedirs(self.gz_dir, exist_ok=True)
 
+        self.multiplier = self.kwargs.get("multiplier", DEFAULT_MULTIPLIER)
+        self.blur_radius = self.kwargs.get("blur_radius", DEFAULT_BLUR_RADIUS)
+        self.logger.debug(
+            "DEM multiplier is %s, blur radius is %s.", self.multiplier, self.blur_radius
+        )
+
     # pylint: disable=no-member
     def process(self) -> None:
         """Reads SRTM file, crops it to map size, normalizes and blurs it,
         saves to map directory."""
-        north, south, east, west = ox.utils_geo.bbox_from_point(  # pylint: disable=W0632
-            self.coordinates, dist=self.distance
-        )
-        self.logger.debug(
-            f"Processing DEM. North: {north}, south: {south}, east: {east}, west: {west}."
-        )
+        north, south, east, west = self.bbox
 
-        dem_output_size = self.distance * self.game.dem_multipliyer + 1
+        dem_height = self.map_height * self.game.dem_multipliyer + 1
+        dem_width = self.map_width * self.game.dem_multipliyer + 1
         self.logger.debug(
-            "DEM multiplier is %s, DEM output size is %s.",
+            "DEM multiplier is %s, DEM height is %s, DEM width is %s.",
             self.game.dem_multipliyer,
-            dem_output_size,
+            dem_height,
+            dem_width,
         )
-        dem_output_resolution = (dem_output_size, dem_output_size)
+        dem_output_resolution = (dem_width, dem_height)
         self.logger.debug("DEM output resolution: %s.", dem_output_resolution)
 
         tile_path = self._srtm_tile()
@@ -83,23 +85,48 @@ class DEM(Component):
             return
 
         self.logger.debug(
-            f"DEM data was read from SRTM file. Shape: {data.shape}, dtype: {data.dtype}. "
-            f"Min: {data.min()}, max: {data.max()}."
+            "DEM data was read from SRTM file. Shape: %s, dtype: %s. Min: %s, max: %s.",
+            data.shape,
+            data.dtype,
+            data.min(),
+            data.max(),
         )
 
-        normalized_data = self._normalize_dem(data)
-
         resampled_data = cv2.resize(
-            normalized_data, dem_output_resolution, interpolation=cv2.INTER_LINEAR
+            data, dem_output_resolution, interpolation=cv2.INTER_LINEAR
+        ).astype("uint16")
+
+        self.logger.debug(
+            "Maximum value in resampled data: %s, minimum value: %s.",
+            resampled_data.max(),
+            resampled_data.min(),
         )
+
+        resampled_data = resampled_data * self.multiplier
+        self.logger.debug(
+            "DEM data multiplied by %s. Shape: %s, dtype: %s. Min: %s, max: %s.",
+            self.multiplier,
+            resampled_data.shape,
+            resampled_data.dtype,
+            resampled_data.min(),
+            resampled_data.max(),
+        )
+
         self.logger.debug(
-            f"DEM data was resampled. Shape: {resampled_data.shape}, "
-            f"dtype: {resampled_data.dtype}. "
-            f"Min: {resampled_data.min()}, max: {resampled_data.max()}."
+            "DEM data was resampled. Shape: %s, dtype: %s. Min: %s, max: %s.",
+            resampled_data.shape,
+            resampled_data.dtype,
+            resampled_data.min(),
+            resampled_data.max(),
         )
 
-        blurred_data = cv2.GaussianBlur(resampled_data, (self._blur_seed, self._blur_seed), 0)
-        cv2.imwrite(self._dem_path, blurred_data)
+        resampled_data = cv2.GaussianBlur(resampled_data, (self.blur_radius, self.blur_radius), 0)
+        self.logger.debug(
+            "Gaussion blur applied to DEM data with kernel size %s.",
+            self.blur_radius,
+        )
+
+        cv2.imwrite(self._dem_path, resampled_data)
         self.logger.debug("DEM data was saved to %s.", self._dem_path)
 
     def _tile_info(self, lat: float, lon: float) -> tuple[str, str]:
@@ -162,7 +189,8 @@ class DEM(Component):
         decompressed_file_path = os.path.join(self.hgt_dir, f"{tile_name}.hgt")
         if os.path.isfile(decompressed_file_path):
             self.logger.info(
-                f"Decompressed tile already exists: {decompressed_file_path}, skipping download."
+                "Decompressed tile already exists: %s, skipping download.",
+                decompressed_file_path,
             )
             return decompressed_file_path
 
@@ -182,30 +210,6 @@ class DEM(Component):
         cv2.imwrite(self._dem_path, dem_data)  # pylint: disable=no-member
         self.logger.warning("DEM data filled with zeros and saved to %s.", self._dem_path)
 
-    def _normalize_dem(self, data: np.ndarray) -> np.ndarray:
-        """Normalize DEM data to 16-bit unsigned integer using max height from settings.
-
-        Args:
-            data (np.ndarray): DEM data from SRTM file after cropping.
-
-        Returns:
-            np.ndarray: Normalized DEM data.
-        """
-        max_dev = data.max() - data.min()
-        scaling_factor = max_dev / self._max_height if max_dev < self._max_height else 1
-        adjusted_max_height = int(65535 * scaling_factor)
-        self.logger.debug(
-            f"Maximum deviation: {max_dev}. Scaling factor: {scaling_factor}. "
-            f"Adjusted max height: {adjusted_max_height}."
-        )
-        normalized_data = (
-            (data - data.min()) / (data.max() - data.min()) * adjusted_max_height
-        ).astype("uint16")
-        self.logger.debug(
-            f"DEM data was normalized to {normalized_data.min()} - {normalized_data.max()}."
-        )
-        return normalized_data
-
     def grayscale_preview(self) -> str:
         """Converts DEM image to grayscale RGB image and saves it to the map directory.
         Returns path to the preview image.

maps4fs/generator/map.py

@@ -18,10 +18,9 @@ class Map:
     Args:
         game (Type[Game]): Game for which the map is generated.
         coordinates (tuple[float, float]): Coordinates of the center of the map.
-        distance (int): Distance from the center of the map.
+        height (int): Height of the map in pixels.
+        width (int): Width of the map in pixels.
         map_directory (str): Path to the directory where map files will be stored.
-        blur_seed (int): Seed used for blur effect.
-        max_height (int): Maximum height of the map.
         logger (Any): Logger instance
     """
 
@@ -29,16 +28,17 @@ class Map:
         self,
         game: Game,
         coordinates: tuple[float, float],
-        distance: int,
+        height: int,
+        width: int,
         map_directory: str,
-        blur_seed: int,
-        max_height: int,
         logger: Any = None,
+        **kwargs,
     ):
         self.game = game
         self.components: list[Component] = []
         self.coordinates = coordinates
-        self.distance = distance
+        self.height = height
+        self.width = width
         self.map_directory = map_directory
 
         if not logger:
@@ -46,6 +46,8 @@ class Map:
         self.logger = logger
         self.logger.debug("Game was set to %s", game.code)
 
+        self.kwargs = kwargs
+
         os.makedirs(self.map_directory, exist_ok=True)
         self.logger.debug("Map directory created: %s", self.map_directory)
 
@@ -55,15 +57,6 @@ class Map:
         except Exception as e:
             raise RuntimeError(f"Can not unpack map template due to error: {e}") from e
 
-        # Blur seed should be positive and odd.
-        if blur_seed <= 0:
-            raise ValueError("Blur seed should be positive.")
-        if blur_seed % 2 == 0:
-            blur_seed += 1
-
-        self.blur_seed = blur_seed
-        self.max_height = max_height
-
     def generate(self) -> None:
         """Launch map generation using all components."""
         with tqdm(total=len(self.game.components), desc="Generating map...") as pbar:
@@ -71,11 +64,11 @@ class Map:
                 component = game_component(
                     self.game,
                     self.coordinates,
-                    self.distance,
+                    self.height,
+                    self.width,
                     self.map_directory,
                     self.logger,
-                    blur_seed=self.blur_seed,
-                    max_height=self.max_height,
+                    **self.kwargs,
                 )
                 try:
                     component.process()
@@ -86,7 +79,6 @@ class Map:
                         e,
                     )
                     raise e
-                # setattr(self, game_component.__name__.lower(), component)
                 self.components.append(component)
 
                 pbar.update(1)
@@ -97,9 +89,6 @@ class Map:
         Returns:
             list[str]: List of preview images.
         """
-        # texture_previews = self.texture.previews()  # type: ignore # pylint: disable=no-member
-        # dem_previews = self.dem.previews()  # type: ignore # pylint: disable=no-member
-        # return texture_previews + dem_previews
         previews = []
         for component in self.components:
             previews.extend(component.previews())

maps4fs/generator/texture.py

@@ -16,6 +16,8 @@ from shapely.geometry.base import BaseGeometry  # type: ignore
 
 from maps4fs.generator.component import Component
 
+PREVIEW_MAXIMUM_SIZE = 2048
+
 
 # pylint: disable=R0902
 class Texture(Component):
@@ -116,7 +118,6 @@ class Texture(Component):
         self.logger.info("Loaded %s layers.", len(self.layers))
 
         self._weights_dir = os.path.join(self.map_directory, "maps", "map", "data")
-        self._bbox = ox.utils_geo.bbox_from_point(self.coordinates, dist=self.distance)
         self.info_save_path = os.path.join(self.map_directory, "generation_info.json")
 
     def process(self):
@@ -132,9 +133,8 @@ class Texture(Component):
         - map dimensions in meters
         - map coefficients (meters per pixel)
         """
-        north, south, east, west = ox.utils_geo.bbox_from_point(  # pylint: disable=W0632
-            self.coordinates, dist=self.distance, project_utm=True
-        )
+        north, south, east, west = self.get_bbox(project_utm=True)
+
         # Parameters of the map in UTM format (meters).
         self.minimum_x = min(west, east)
         self.minimum_y = min(south, north)
@@ -147,8 +147,8 @@ class Texture(Component):
         self.width = abs(east - west)
         self.logger.info("Map dimensions (HxW): %s x %s.", self.height, self.width)
 
-        self.height_coef = self.height / (self.distance * 2)
-        self.width_coef = self.width / (self.distance * 2)
+        self.height_coef = self.height / self.map_height
+        self.width_coef = self.width / self.map_width
         self.logger.debug("Map coefficients (HxW): %s x %s.", self.height_coef, self.width_coef)
 
     def info_sequence(self) -> None:
@@ -157,7 +157,8 @@ class Texture(Component):
         Info sequence contains following attributes:
             - coordinates
             - bbox
-            - distance
+            - map_height
+            - map_width
             - minimum_x
             - minimum_y
             - maximum_x
@@ -170,7 +171,8 @@ class Texture(Component):
         useful_attributes = [
             "coordinates",
             "bbox",
-            "distance",
+            "map_height",
+            "map_width",
             "minimum_x",
             "minimum_y",
             "maximum_x",
@@ -201,7 +203,7 @@ class Texture(Component):
             texture_name (str): Name of the texture.
             layer_numbers (int): Number of layers in the texture.
         """
-        size = self.distance * 2
+        size = (self.map_height, self.map_width)
         postfix = "_weight.png"
         if layer_numbers == 0:
             filepaths = [os.path.join(self._weights_dir, texture_name + postfix)]
@@ -212,7 +214,7 @@ class Texture(Component):
             ]
 
         for filepath in filepaths:
-            img = np.zeros((size, size), dtype=np.uint8)
+            img = np.zeros(size, dtype=np.uint8)
             cv2.imwrite(filepath, img)  # pylint: disable=no-member
 
     @property
@@ -356,7 +358,7 @@ class Texture(Component):
         try:
             with warnings.catch_warnings():
                 warnings.simplefilter("ignore", DeprecationWarning)
-                objects = ox.features_from_bbox(bbox=self._bbox, tags=tags)
+                objects = ox.features_from_bbox(bbox=self.bbox, tags=tags)
         except Exception as e:  # pylint: disable=W0718
             self.logger.warning("Error fetching objects for tags: %s.", tags)
             self.logger.warning(e)
@@ -387,7 +389,20 @@ class Texture(Component):
         Returns:
             str: Path to the preview.
         """
-        preview_size = (2048, 2048)
+        scaling_factor = min(
+            PREVIEW_MAXIMUM_SIZE / self.map_width, PREVIEW_MAXIMUM_SIZE / self.map_height
+        )
+
+        preview_size = (
+            int(self.map_width * scaling_factor),
+            int(self.map_height * scaling_factor),
+        )
+        self.logger.debug(
+            "Scaling factor: %s. Preview size: %s.",
+            scaling_factor,
+            preview_size,
+        )
+
         images = [
             cv2.resize(
                 cv2.imread(layer.path(self._weights_dir), cv2.IMREAD_UNCHANGED), preview_size
@@ -402,7 +417,9 @@ class Texture(Component):
             color_images.append(color_img)
         merged = np.sum(color_images, axis=0, dtype=np.uint8)
         self.logger.debug(
-            f"Merged layers into one image. Shape: {merged.shape}, dtype: {merged.dtype}."
+            "Merged layers into one image. Shape: %s, dtype: %s.",
+            merged.shape,
+            merged.dtype,
         )
         preview_path = os.path.join(self.map_directory, "preview_osm.png")
         cv2.imwrite(preview_path, merged)  # pylint: disable=no-member

{maps4fs-0.7.0.dist-info → maps4fs-0.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: maps4fs
-Version: 0.7.0
+Version: 0.7.3
 Summary: Generate map templates for Farming Simulator from real places.
 Author-email: iwatkot <iwatkot@gmail.com>
 License: MIT License
@@ -16,7 +16,6 @@ License-File: LICENSE.md
 Requires-Dist: opencv-python
 Requires-Dist: osmnx<2.0.0
 Requires-Dist: rasterio
-Requires-Dist: python-dotenv
 Requires-Dist: tqdm
 
 <div align="center" markdown>
@@ -26,9 +25,8 @@ Requires-Dist: tqdm
   <a href="#Quick-Start">Quick Start</a> •
   <a href="#Overview">Overview</a> • 
   <a href="#How-To-Run">How-To-Run</a> • 
-  <a href="#Features">Features</a> • 
   <a href="#Supported-objects">Supported objects</a> • 
-  <a href="Settings">Settings</a> • 
+  <a href="#For-advanced-users">For advanced users</a> • 
   <a href="#Bugs-and-feature-requests">Bugs and feature requests</a>
 </p>
 
@@ -45,10 +43,13 @@ Requires-Dist: tqdm
 
 </div>
 
-### Supported Games
+🗺️ Supports 2x2, 4x4, 8x8, 16x16 and any custom size maps<br>
+🌍 Based on real-world data from OpenStreetMap<br>
+🏞️ Generates height using SRTM dataset<br>
+📦 Provides a ready-to-use map template for the Giants Editor<br>
+🚜 Supports Farming Simulator 22 and 25*<br>
 
-✅ Farming Simulator 22<br>
-🔃 Farming Simulator 25 (changes in the library are ready, waiting for the Giants to release the Giants Editor v10)<br>
+\* changes in the library are ready, waiting for the Giants to release the Giants Editor v10. Meanwhile the option to generate a map for FS25 is disabled.
 
 ## Quick Start
 There are several ways to use the tool. You obviously need the **first one**, but you can choose any of the others depending on your needs.<br>
@@ -87,16 +88,12 @@ The generator also creates a multiple previews of the map. Here's the list of th
 2. Grayscale DEM preview - a grayscale image of the height map (as it is).
 3. Colored DEM preview - a colored image of the height map (from blue to red). The blue color represents the lowest point, and the red color represents the highest point.
 
-So the colored DEM preview can be very handy when you're trying to find the best value for the `max_height` parameter. Learn more about it in the [Settings](#settings) section.
+![16 km map](https://github.com/user-attachments/assets/82543bcc-1289-479e-bd13-85a8890f0485)<br>
+*Preview of a 16 km map with a 500-meter mountain in the middle of it.*<br>
 
-![Previews](https://github.com/user-attachments/assets/69609169-834b-4269-ac6a-9a5c56b629dc)<br>
-In the second row of the image you can see the following images:<br>
-1. DEM preview with `max_height=200`.
-2. Colored DEM preview with `max_height=200`.
-3. Colored DEM preview with `max_height=50`.
-
-As you can see there's a huge difference between images 2 and 3. The third (with lower `max_height`) will have a higher terrain contrast, and the second one will have lower differences between the terrain heights.<br>
-There's no like "in real world" option, because FS system of coordinates does not work in meters or something like that when talking about DEM. So you need to experiment with the `max_height` parameter to get the desired result. To clarify: in the example above the difference on the platue is about 80 meters, so `max_height=50` made this like super mountainous terrain, and `max_height=200` made it like a plain.
+Parameters:
+- coordinates: 45.15, 19.71
+- size: 16 x 16 km
 
 ## How-To-Run
 
@@ -105,7 +102,6 @@ You'll find detailed instructions on how to run the project below. But if you pr
 <i>Video tutorial: How to generate a Farming Simulator 22 map from real-world data.</i>
 
 ### Option 1: StreamLit
-**🗺️ Supported map sizes:** 2x2, 4x4, 8x8, 16x16 km.<br>
 🟢 Recommended for all users, you don't need to install anything.<br>
 Using the [StreamLit](https://maps4fs.streamlit.app) version of the tool is the easiest way to generate a map template. Just open the link and follow the instructions.
 Note: due to CPU and RAM limitations of the hosting, the generation may take some time. If you need faster processing, use the [Docker version](#option-2-docker-version).<br>
@@ -113,7 +109,6 @@ Note: due to CPU and RAM limitations of the hosting, the generation may take som
 Using it is easy and doesn't require any guides. Enjoy!
 
 ### Option 2: Docker version
-**🗺️ Supported map sizes:** 2x2, 4x4, 8x8, 16x16 km.<br>
 🟠 Recommended for users who want faster processing, very simple installation.<br>
 You can launch the project with minimalistic UI in your browser using Docker. Follow these steps:
 
@@ -126,10 +121,9 @@ docker run -d -p 8501:8501 iwatkot/maps4fs
 4. Fill in the required fields and click on the `Generate` button.
 5. When the map is generated click on the `Download` button to get the map.
 
-![WebUI](https://github.com/user-attachments/assets/e3b48c9d-7b87-4ce7-8ad7-98332a558a88)
+![WebUI](https://github.com/user-attachments/assets/581e1206-2abd-4b3c-ad31-80554ad92d99)
 
 ### Option 3: Python package
-**🗺️ Supported map sizes:** 2x2, 4x4, 8x8, 16x16 km (and ANY other you may add).<br>
 🔴 Recommended for developers.<br>
 You can use the Python package to generate maps. Follow these steps:
 
@@ -161,10 +155,9 @@ import maps4fs as mfs
 map = mfs.Map(
   game,
   (52.5200, 13.4050),  # Latitude and longitude of the map center.
-  distance=1024,  # The DISTANCE from the center to the edge of the map in meters. The map will be 2048x2048 meters.
+  height=1024,  # The height of the map in meters.
+  width=1024,  # The width of the map in meters.
   map_directory="path/to/your/map/directory",  # The directory where the map will be saved.
-  blur_seed=5,  # The seed for the blur algorithm. The default value is 5, which means 5 meters.
-  max_height=400  # The maximum height of the map.
 )
 ```
 
@@ -175,17 +168,6 @@ map.generate()
 
 The map will be saved in the `map_directory` directory.
 
-## Settings
-Advanced settings are available in the tool's UI under the **Advanced Settings** tab. Here's the list of them:
-- `max_height` - the maximum height of the map. The default value is 400. Select smaller values for plain-like maps and bigger values for mountainous maps. You may need to experiment with this value to get the desired result.
-- `blur_seed` - the seed for the blur algorithm. The default value is 5, which means 5 meters. The bigger the value, the smoother the map will be. The smaller the value, the more detailed the map will be. Keep in mind that for some regions, where terrain is bumpy, disabling the blur algorithm may lead to a very rough map. So, I recommend leaving this value as it is.
-
-## Features
-- Allows to enter a location by lat and lon (e.g. from Google Maps).
-- Allows to select a size of the map (2x2, 4x4, 8x8 km, 16x16 km).
-- Generates a map template (check the list of supported objects in [this section](#supported-objects)).
-- Generates a height map.
-
 ## Supported objects
 The project is based on the [OpenStreetMap](https://www.openstreetmap.org/) data. So, refer to [this page](https://wiki.openstreetmap.org/wiki/Map_Features) to understand the list below.
 - "building": True
@@ -204,18 +186,34 @@ The list will be updated as the project develops.
 The script will also generate the `generation_info.json` file in the `output` folder. It contains the following keys: <br>
 `"coordinates"` - the coordinates of the map center which you entered,<br>
 `"bbox"` - the bounding box of the map in lat and lon,<br>
-`"distance"` - the size of the map in meters,<br>
+`"map_height"` - the height of the map in meters (this one is from the user input, e.g. 2048 and so on),<br>
+`"map_width"` - the width of the map in meters (same as above),<br>
 `"minimum_x"` - the minimum x coordinate of the map (UTM projection),<br>
 `"minimum_y"` - the minimum y coordinate of the map (UTM projection),<br>
 `"maximum_x"` - the maximum x coordinate of the map (UTM projection),<br>
 `"maximum_y"` - the maximum y coordinate of the map (UTM projection),<br>
-`"height"` - the height of the map in meters (it won't be equal to the distance since the Earth is not flat, sorry flat-earthers),<br>
-`"width"` - the width of the map in meters,<br>
+`"height"` - the height of the map in meters (it won't be equal to the parameters above since the Earth is not flat, sorry flat-earthers),<br>
+`"width"` - the width of the map in meters (same as above),<br>
 `"height_coef"` - since we need a texture of exact size, the height of the map is multiplied by this coefficient,<br>
 `"width_coef"` - same as above but for the width,<br>
 `"tile_name"` - the name of the SRTM tile which was used to generate the height map, e.g. "N52E013"<br>
 
 You can use this information to adjust some other sources of data to the map, e.g. textures, height maps, etc.
 
+## For advanced users
+The tool supports the custom size of the map. To use this feature select `Custom` in the `Map size` dropdown and enter the desired size. The tool will generate a map with the size you entered.<br>
+
+⛔️ Do not use this feature, if you don't know what you're doing. In most cases the Giants Editor will just crash on opening the file, because you need to enter a specific values for the map size.<br><br>
+
+![Advanced settings and custom size](https://github.com/user-attachments/assets/327b6065-09ed-41d0-86a8-7d904025707c)
+
+You can also apply some advanced settings to the map generation process. Note that they're ADVANCED, so you don't need to use them if you're not sure what they do.<br>
+
+Here's the list of the advanced settings:
+
+- DEM multiplier: the height of the map is multiplied by this value. So the DEM map is just a 16-bit grayscale image, which means that the maximum avaiable value there is 65535, while the actual difference between the deepest and the highest point on Earth is about 20 km. So, by default this value is set to 3. Just note that this setting mostly does not matter, because you can always adjust it in the Giants Editor, learn more about the [heightScale](https://www.farming-simulator.org/19/terrain-heightscale.php) parameter on the [PMC Farming Simulator](https://www.farming-simulator.org/) website.
+
+- DEM Blur radius: the radius of the Gaussian blur filter applied to the DEM map. By default, it's set to 21. This filter just makes the DEM map smoother, so the height transitions will be more natural. You can set it to 1 to disable the filter, but it will result as a Minecraft-like map.
+
 ## Bugs and feature requests
 If you find a bug or have an idea for a new feature, please create an issue [here](https://github.com/iwatkot/maps4fs/issues) or contact me directly on [Telegram](https://t.me/iwatkot).<br>

maps4fs-0.7.3.dist-info/RECORD

@@ -0,0 +1,14 @@
+maps4fs/__init__.py,sha256=da4jmND2Ths9AffnkAKgzLHNkvKFOc_l21gJisPXqWY,155
+maps4fs/logger.py,sha256=CneeHxQywjNUJXqQrUUSeiDxu95FfrfyK_Si1v0gMZ8,1477
+maps4fs/generator/__init__.py,sha256=zZMLEkGzb4z0xql650gOtGSvcgX58DnJ2yN3vC2daRk,43
+maps4fs/generator/component.py,sha256=BU_HNNyKXuEBohQJRTlXmNdSNrjolwX-ZzqqSSuzTrE,3463
+maps4fs/generator/config.py,sha256=luDYXkKjgOM4-Mft4mHDPP6v-DVIUyWZAMAsCKyvaoY,2108
+maps4fs/generator/dem.py,sha256=EJBXHZ0_G9nXZ-b1PmR9mjIdXjbKlYEUv-4IDGJPmdc,9779
+maps4fs/generator/game.py,sha256=IyXjNEC5epJmDdqjsrl4wKL85T1F23km73pUkBiuDWU,4468
+maps4fs/generator/map.py,sha256=Oyu45ONmSluidaUErsU6n28pqI-XYx1eVfPT9FurCTE,3522
+maps4fs/generator/texture.py,sha256=W2tMkCxyD7qesSuutPJ3N5InDza2Dzi5_yzewSl9e-E,15615
+maps4fs-0.7.3.dist-info/LICENSE.md,sha256=-JY0v7p3dwXze61EbYiK7YEJ2aKrjaFZ8y2xYEOrmRY,1068
+maps4fs-0.7.3.dist-info/METADATA,sha256=LimQqtHMDbvCq_hUNZg8ZmxHSIk-g8G6DRJ7Etu8F7E,11961
+maps4fs-0.7.3.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+maps4fs-0.7.3.dist-info/top_level.txt,sha256=Ue9DSRlejRQRCaJueB0uLcKrWwsEq9zezfv5dI5mV1M,8
+maps4fs-0.7.3.dist-info/RECORD,,

maps4fs-0.7.0.dist-info/RECORD

@@ -1,14 +0,0 @@
-maps4fs/__init__.py,sha256=da4jmND2Ths9AffnkAKgzLHNkvKFOc_l21gJisPXqWY,155
-maps4fs/logger.py,sha256=CneeHxQywjNUJXqQrUUSeiDxu95FfrfyK_Si1v0gMZ8,1477
-maps4fs/generator/__init__.py,sha256=zZMLEkGzb4z0xql650gOtGSvcgX58DnJ2yN3vC2daRk,43
-maps4fs/generator/component.py,sha256=Xq5yVFMqG1d1iHTtn2mn5RN-UntsutXIvV5eQYBuFLw,2046
-maps4fs/generator/config.py,sha256=wlGacB69fdcvggfEDvCpx5gzPRKq_4Sh6xuX-z-kwwE,2043
-maps4fs/generator/dem.py,sha256=xOKHvWIMD-7nIWGQNQi6Tan1Ovb1EPfHHVnUfUIC31k,10004
-maps4fs/generator/game.py,sha256=IyXjNEC5epJmDdqjsrl4wKL85T1F23km73pUkBiuDWU,4468
-maps4fs/generator/map.py,sha256=bqog38u2fltYdC1xgfeC0ehboL7Vp7V6nJq0NQOI9lA,4157
-maps4fs/generator/texture.py,sha256=f5dPD5q17CTg8aY6G3i33vFk9ckbpndVb1W3hbT1wL4,15318
-maps4fs-0.7.0.dist-info/LICENSE.md,sha256=-JY0v7p3dwXze61EbYiK7YEJ2aKrjaFZ8y2xYEOrmRY,1068
-maps4fs-0.7.0.dist-info/METADATA,sha256=559aJEFn3HctVKqakqaBoTVA6xLY8WTNQsKTlFG-icE,12187
-maps4fs-0.7.0.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
-maps4fs-0.7.0.dist-info/top_level.txt,sha256=Ue9DSRlejRQRCaJueB0uLcKrWwsEq9zezfv5dI5mV1M,8
-maps4fs-0.7.0.dist-info/RECORD,,