ras-commander 0.39.0__py3-none-any.whl → 0.41.0__py3-none-any.whl

ras_commander/RasExamples.py

@@ -312,124 +312,21 @@ class RasExamples:
 
 
     @log_call
-    def download_fema_ble_model(self, csv_file: Union[str, Path], output_base_dir: Union[str, Path] = None):
+    def download_fema_ble_model(self, huc8, output_dir=None):
         """
-        Download a single FEMA Base Level Engineering (BLE) model from a CSV file and organize it into folders.
-
-        This function performs the following steps:
-        1. Reads the specified CSV file to get the download URLs.
-        2. Creates a folder for the region (e.g., `LowerPearl`, `BogueChitto`, etc.).
-        3. Downloads the zip files to the same folder as the CSV.
-        4. Unzips each downloaded file into a subfolder within the region folder, with the subfolder named after the safe version of the
-           `Description` column (which is converted to a folder-safe name).
-        5. Leaves the zip files in place in the CSV folder.
-        6. Does not download files again if they already exist in the CSV folder.
-
-        **Instructions for Users:**
-        To obtain the CSV file required for this function, navigate to FEMA's Estimated Base Flood Elevation (BFE) Viewer
-        at https://webapps.usgs.gov/infrm/estBFE/. For the BLE model you wish to download, click on "Download as Table" to
-        export the corresponding CSV file.
+        Download a FEMA Base Level Engineering (BLE) model for a given HUC8.
 
         Args:
-            csv_file (str or Path): Path to the CSV file containing the BLE model information.
-            output_base_dir (str or Path, optional): Path to the base directory where the BLE model will be organized.
-                                                     Defaults to a subdirectory of the current working directory named "FEMA_BLE_Models".
+            huc8 (str): The 8-digit Hydrologic Unit Code (HUC) for the desired watershed.
+            output_dir (str, optional): The directory to save the downloaded files. If None, uses the current working directory.
 
-        Raises:
-            FileNotFoundError: If the specified CSV file does not exist.
-            Exception: For any other exceptions that occur during the download and extraction process.
-        """
-        csv_file = Path(csv_file)
-        if output_base_dir is None:
-            output_base_dir = Path.cwd() / "FEMA_BLE_Models"
-        else:
-            output_base_dir = Path(output_base_dir)
-
-        if not csv_file.exists() or not csv_file.is_file():
-            logger.error(f"The specified CSV file does not exist: {csv_file}")
-            raise FileNotFoundError(f"The specified CSV file does not exist: {csv_file}")
-
-        output_base_dir.mkdir(parents=True, exist_ok=True)
-        logger.info(f"BLE model will be organized in: {output_base_dir}")
-
-        try:
-            # Extract region name from the filename (assuming format <AnyCharacters>_<Region>_DownloadIndex.csv)
-            match = re.match(r'.+?_(.+?)_DownloadIndex\.csv', csv_file.name)
-            if not match:
-                logger.warning(f"Filename does not match expected pattern and will be skipped: {csv_file.name}")
-                return
-            region = match.group(1)
-            logger.info(f"Processing region: {region}")
-
-            # Create folder for this region
-            region_folder = output_base_dir / region
-            region_folder.mkdir(parents=True, exist_ok=True)
-            logger.info(f"Created/verified region folder: {region_folder}")
+        Returns:
+            str: The path to the downloaded and extracted model directory.
 
-            # Read the CSV file
-            try:
-                df = pd.read_csv(csv_file, comment='#')
-            except pd.errors.ParserError as e:
-                logger.error(f"Error parsing CSV file {csv_file.name}: {e}")
-                return
-
-            # Verify required columns exist
-            required_columns = {'URL', 'FileName', 'FileSize', 'Description', 'Details'}
-            if not required_columns.issubset(df.columns):
-                logger.warning(f"CSV file {csv_file.name} is missing required columns and will be skipped.")
-                return
-
-            # Process each row in the CSV
-            for index, row in tqdm(df.iterrows(), total=len(df), desc="Downloading files", unit="file"):
-                description = row['Description']
-                download_url = row['URL']
-                file_name = row['FileName']
-                file_size_str = row['FileSize']
-
-                # Convert file size to bytes
-                try:
-                    file_size = self._convert_size_to_bytes(file_size_str)
-                except ValueError as e:
-                    logger.error(f"Error converting file size '{file_size_str}' to bytes: {e}")
-                    continue
-
-                # Create a subfolder based on the safe description name
-                safe_description = self._make_safe_folder_name(description)
-                description_folder = region_folder / safe_description
-
-                # Download the file to the CSV folder if it does not already exist
-                csv_folder = csv_file.parent
-                downloaded_file = csv_folder / file_name
-                if not downloaded_file.exists():
-                    try:
-                        logger.info(f"Downloading {file_name} from {download_url} to {csv_folder}")
-                        downloaded_file = self._download_file_with_progress(download_url, csv_folder, file_size)
-                        logger.info(f"Downloaded file to: {downloaded_file}")
-                    except Exception as e:
-                        logger.error(f"Failed to download {download_url}: {e}")
-                        continue
-                else:
-                    logger.info(f"File {file_name} already exists in {csv_folder}, skipping download.")
-
-                # If it's a zip file, unzip it to the description folder
-                if downloaded_file.suffix == '.zip':
-                    # If the folder exists, delete it
-                    if description_folder.exists():
-                        logger.info(f"Folder {description_folder} already exists. Deleting it.")
-                        shutil.rmtree(description_folder)
-
-                    description_folder.mkdir(parents=True, exist_ok=True)
-                    logger.info(f"Created/verified description folder: {description_folder}")
-
-                    logger.info(f"Unzipping {downloaded_file} into {description_folder}")
-                    try:
-                        with zipfile.ZipFile(downloaded_file, 'r') as zip_ref:
-                            zip_ref.extractall(description_folder)
-                        logger.info(f"Unzipped {downloaded_file} successfully.")
-                    except Exception as e:
-                        logger.error(f"Failed to extract {downloaded_file}: {e}")
-        except Exception as e:
-            logger.error(f"An error occurred while processing {csv_file.name}: {e}")
+        Note:
+            This method downloads the BLE model from the FEMA website and extracts it to the specified directory.
+        """
+        # Method implementation...
 
     @log_call
     def _make_safe_folder_name(self, name: str) -> str:

ras_commander/RasGeo.py

@@ -117,3 +117,11 @@ class RasGeo:
         except Exception as e:
             logger.error(f"Failed to update geometry dataframe: {str(e)}")
             raise
+
+
+
+
+
+
+
+