Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add pt compress commad line #4300

Merged
merged 33 commits into from
Nov 8, 2024
Merged

Conversation

cherryWangY
Copy link
Collaborator

@cherryWangY cherryWangY commented Nov 1, 2024

Summary by CodeRabbit

  • New Features

    • Introduced model compression functionality, allowing users to compress models directly via the command-line interface.
    • Added a new command option "compress" to trigger model compression.
    • Enhanced help messages and examples for the "compress" command to clarify usage with different backends.
    • Added a comprehensive JSON configuration file for model compression parameters.
    • Improved handling of compression parameters within descriptor classes for better organization and efficiency.
    • Updated command-line interface to support new compression parameters and enhance usability.
  • Bug Fixes

    • Improved error handling for unsupported file formats during model loading.
    • Enhanced state dictionary loading to ensure all required attributes are correctly populated.
  • Tests

    • Introduced a suite of unit tests to evaluate the functionality of model compression, ensuring accuracy and performance across different configurations.
    • Enhanced tests for loading model parameters to ensure all required attributes are correctly handled.
    • Updated tests to reflect changes in expected outcomes for model parameters.

Copy link
Contributor

coderabbitai bot commented Nov 1, 2024

Caution

Review failed

The pull request is closed.

📝 Walkthrough
📝 Walkthrough

Walkthrough

The changes introduce a new command option "compress" in the deepmd/pt/entrypoints/main.py file, which triggers the invocation of the enable_compression function from the deepmd.pt.entrypoints.compress module. This function is called with parameters derived from command-line arguments. The input and output file paths are modified to ensure they have a .pth suffix. The command structure is enhanced to include the "compress" option alongside existing commands. Additionally, the handling of the min_nbor_dist variable is updated to ensure it is properly managed as a PyTorch tensor.

Changes

File Path Change Summary
deepmd/pt/entrypoints/main.py Added command option "compress"; integrated logic for handling compression command.
deepmd/pt/entrypoints/compress.py Introduced enable_compression function for model compression; handles input/output paths.
deepmd/main.py Simplified help messages for compress command; updated default values and added usage examples.
deepmd/tf/entrypoints/main.py Enhanced input/output formatting for compress command based on backend.
source/tests/pt/common.py Added j_loader function for loading data; imported pathlib.
source/tests/pt/model_compression/data/type.raw Changes made, but specific details not provided.
source/tests/pt/model_compression/data/type_map.raw New file created containing simple data representation.
source/tests/pt/model_compression/input.json New JSON configuration file for model compression parameters added.
source/tests/pt/test_model_compression_se_a.py Introduced unit tests for model compression functionality; multiple test classes created.
deepmd/pt/model/model/model.py Updated min_nbor_dist attribute to registered buffer; modified retrieval method for robustness.
deepmd/pt/model/descriptor/se_a.py Refactored compression parameter handling in DescrptBlockSeA class; updated methods accordingly.
deepmd/pt/model/descriptor/se_atten.py Enhanced compression handling in DescrptBlockSeAtten class; updated methods for new attributes.
deepmd/pt/model/descriptor/se_r.py Added compression attributes and updated methods in DescrptSeR class for improved functionality.
deepmd/pt/model/descriptor/se_t.py Enhanced DescrptBlockSeT class with new compression attributes and updated methods.
deepmd/pt/utils/serialization.py Modified handling of min_nbor_dist in serialization functions to ensure tensor compatibility.
deepmd/pt/utils/tabulate.py Transitioned tensor operations from NumPy to PyTorch in DPTabulate class functions.
source/tests/pt/test_tabulate.py Updated tests to ensure compatibility with tensor operations on CPU.

Possibly related PRs

Suggested labels

Docs

Suggested reviewers

  • iProzd

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@github-actions github-actions bot added the Python label Nov 1, 2024
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 8355947 and cfca381.

📒 Files selected for processing (1)
  • deepmd/pt/entrypoints/main.py (3 hunks)
🔇 Additional comments (2)
deepmd/pt/entrypoints/main.py (2)

46-46: LGTM!

The import is correctly placed and properly used in the new compression functionality.


Line range hint 505-595: Verify test coverage and CLI documentation.

Please ensure:

  1. The new compression functionality is covered by unit tests
  2. The CLI help documentation includes the new command and its parameters
✅ Verification successful

Tests and CLI documentation are properly implemented.

Based on the verification results:

  1. Test coverage:

    • The compression functionality is well-tested across multiple test files
    • test_compressed_descriptor_se_t.py shows actual usage of enable_compression
    • Other test files cover various compression scenarios
  2. CLI documentation and parsing:

    • The compress command is properly integrated into the argument parser
    • Test file test_argument_parser.py verifies the CLI arguments:
      • --output
      • --extrapolate
      • --step
      • --frequency
      • --checkpoint-folder
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check for test coverage
rg -l "enable_compression" --type py --glob "*test*.py"

# Check for CLI documentation
rg -l "compress" --type py --glob "*argparse*.py"

Length of output: 552


Script:

#!/bin/bash
# Check for CLI documentation in main.py and other potential CLI-related files
rg -l "compress" --type py

# Check the actual test coverage by looking at test content
rg "enable_compression" -C 5 --type py source/tests/pt/model/test_compressed_descriptor_se_t.py

# Check CLI argument parsing
rg "compress" -C 5 deepmd/pt/entrypoints/main.py

Length of output: 3699


Script:

#!/bin/bash
# Check for CLI argument parsing for compress command
rg -C 10 "compress" source/tests/common/test_argument_parser.py

# Check for the argument parser setup in main code
rg -C 10 "add_subparser" deepmd/pt/entrypoints/main.py

Length of output: 2442

deepmd/pt/entrypoints/main.py Outdated Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Outdated Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Outdated Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Outdated Show resolved Hide resolved
Copy link

codecov bot commented Nov 1, 2024

Codecov Report

Attention: Patch coverage is 91.33858% with 11 lines in your changes missing coverage. Please review.

Project coverage is 84.53%. Comparing base (6c66be9) to head (dbae8d0).
Report is 17 commits behind head on devel.

Files with missing lines Patch % Lines
deepmd/pt/utils/tabulate.py 78.26% 10 Missing ⚠️
deepmd/pt/entrypoints/main.py 85.71% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##            devel    #4300      +/-   ##
==========================================
+ Coverage   84.50%   84.53%   +0.02%     
==========================================
  Files         570      571       +1     
  Lines       53162    53163       +1     
  Branches     3059     3059              
==========================================
+ Hits        44927    44943      +16     
+ Misses       7272     7259      -13     
+ Partials      963      961       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

deepmd/pt/entrypoints/main.py Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Show resolved Hide resolved
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🧹 Outside diff range and nitpick comments (3)
deepmd/pt/entrypoints/compress.py (2)

14-20: Add docstring to document function parameters and behavior.

The function would benefit from a docstring explaining:

  • Purpose of the function
  • Description of each parameter
  • Expected format of input/output files
  • Return value (if any)
  • Possible exceptions

Example docstring:

def enable_compression(
    input_file: str,
    output: str,
    stride: float = 0.01,
    extrapolate: int = 5,
    check_frequency: int = -1,
):
    """Enable compression for PyTorch models.

    Args:
        input_file: Path to input model file (.pth or .pt)
        output: Path to save compressed model
        stride: Compression stride parameter (default: 0.01)
        extrapolate: Number of extrapolation steps (default: 5)
        check_frequency: Frequency for compression checks, -1 to disable (default: -1)

    Raises:
        ValueError: If input file format is not supported
    """

35-36: Improve error message for unsupported formats.

The error message could be more helpful by explicitly listing the supported extensions.

-        raise ValueError("PyTorch backend only supports converting .pth or .pt file")
+        raise ValueError(f"Unsupported file format for {input_file}. PyTorch backend only supports .pth or .pt files")
deepmd/main.py (1)

441-450: LGTM! Clear argument descriptions with backend-specific details.

The updated input/output arguments now handle both backends elegantly by:

  1. Using suffix-less default values
  2. Clearly documenting the expected suffixes for each backend

Consider adding validation to ensure the input/output file extensions match the selected backend:

 parser_compress.add_argument(
     "-i",
     "--input",
     default="frozen_model",
     type=str,
+    help="The original frozen model, which will be compressed by the code. "
+         "Filename (prefix) of the input model file. "
+         "TensorFlow backend: suffix is .pb; PyTorch backend: suffix is .pth"
-    help="The original frozen model, which will be compressed by the code. Filename (prefix) of the input model file. TensorFlow backend: suffix is .pb; PyTorch backend: suffix is .pth",
 )
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between cfca381 and 33e6417.

📒 Files selected for processing (3)
  • deepmd/main.py (1 hunks)
  • deepmd/pt/entrypoints/compress.py (1 hunks)
  • deepmd/pt/entrypoints/main.py (2 hunks)
🔇 Additional comments (4)
deepmd/pt/entrypoints/compress.py (2)

1-12: LGTM! Well-organized imports.

The imports are properly organized and all dependencies are relevant for the implementation.


1-46: Verify integration with model compression functionality.

Let's verify that:

  1. The model compression implementation exists
  2. The command-line integration is properly set up
✅ Verification successful

Model compression functionality is properly integrated

The verification shows that:

  1. Model compression is well-implemented across both PyTorch and TensorFlow backends:
    • PyTorch descriptors (se_a, se_r, se_t, se_atten) have enable_compression methods
    • Comprehensive test coverage exists with multiple compression test files
  2. Command-line integration is complete:
    • The compress command is properly integrated in main.py
    • The implementation handles both .pth and .pt file formats
    • Parameters (stride, extrapolate, check_frequency) are correctly passed through

The test implementation demonstrates proper compression verification with numerical accuracy checks, confirming the feature works as expected.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check if model compression is implemented
echo "Checking for model compression implementation..."
ast-grep --pattern 'def enable_compression($$$)' || echo "Warning: No enable_compression method found in models"

# Check command-line integration
echo "Checking command-line integration..."
rg -l "compress" "deepmd/pt/entrypoints/main.py" || echo "Warning: compress command might not be integrated in main.py"

# Check for compression tests
echo "Checking for compression tests..."
fd -g "*test*compress*.py" || echo "Warning: No compression tests found"

Length of output: 1148


Script:

#!/bin/bash
# Let's check the implementation of enable_compression in model classes
echo "Checking model compression implementation details..."
rg -A 5 "def enable_compression" 

# Check main.py for command line integration details
echo "Checking command line integration details..."
rg -A 10 "compress" "deepmd/pt/entrypoints/main.py"

# Check one of the PyTorch compression tests
echo "Checking PyTorch compression test implementation..."
cat "source/tests/pt/model/test_compressed_descriptor_se_a.py"

Length of output: 12511

deepmd/pt/entrypoints/main.py (1)

41-43: LGTM!

The import follows the established pattern and is properly grouped with other entrypoint imports.

deepmd/main.py (1)

427-434: LGTM! Clear and helpful command description.

The updated help message and examples now correctly reflect the multi-backend support for the compress command.

deepmd/pt/entrypoints/compress.py Outdated Show resolved Hide resolved
deepmd/pt/entrypoints/compress.py Show resolved Hide resolved
deepmd/pt/entrypoints/compress.py Outdated Show resolved Hide resolved
deepmd/pt/entrypoints/main.py Show resolved Hide resolved
@njzjz njzjz mentioned this pull request Nov 2, 2024
@njzjz njzjz linked an issue Nov 3, 2024 that may be closed by this pull request
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Outside diff range and nitpick comments (8)
source/tests/pt/model_compression/input.json (2)

8-27: Document the reasoning behind descriptor parameters.

The descriptor configuration contains several parameters that would benefit from additional documentation:

  • The sel values [46,92] appear to be magic numbers
  • The neuron array [4,8,17,17] configuration needs explanation
  • The significance of rcut=6.00 and rcut_smth=0.50 should be documented
  • The choice of axis_neuron=16 needs clarification

Consider adding comments explaining the reasoning and impact of these parameter choices.


1-85: Improve configuration documentation structure.

The configuration file would benefit from the following improvements:

  1. Replace generic _commentN fields with descriptive names (e.g., _comment_model, _comment_training)
  2. Add a header comment describing the purpose and usage of this configuration file
  3. Include documentation about expected value ranges and impacts for key parameters

Example improvement for the header:

 {
+  "_comment_file": "Configuration for model compression testing with se_e2_a descriptor type.",
+  "_comment_usage": "Used by the enable_compression function for .pth and .pb model compression",
   "_comment1": " model parameters",
source/tests/pt/common.py (1)

23-24: Add docstring to document the j_loader function.

While the implementation is clean, adding a docstring would improve maintainability by documenting:

  • Purpose of the function
  • Parameter description
  • Return value description
  • Usage example

Here's a suggested improvement:

 def j_loader(filename):
+    """Load JSON data from a file relative to the tests directory.
+
+    Parameters
+    ----------
+    filename : str
+        Name of the file to load, relative to the tests directory
+
+    Returns
+    -------
+    dict
+        Loaded JSON data
+
+    Example
+    -------
+    >>> data = j_loader("test_data.json")
+    """
     return dp_j_loader(tests_path / filename)
source/tests/pt/test_model_compression_se_a.py (5)

15-15: Remove commented-out import statement

The import statement on line 15 is commented out and appears to be unnecessary. Consider removing it to clean up the code.

Apply this diff:

- # from deepmd.tf.entrypoints.compress import compress

22-25: Simplify conditional assignment using a ternary operator

For better readability and conciseness, replace the if-else block with a ternary operator.

Apply this diff:

- if GLOBAL_NP_FLOAT_PRECISION == np.float32:
-     default_places = 4
- else:
-     default_places = 10
+ default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10
🧰 Tools
🪛 Ruff

22-25: Use ternary operator default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10 instead of if-else-block

Replace if-else-block with default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10

(SIM108)


22-22: Yoda condition detected

Rewrite as np.float32 == GLOBAL_NP_FLOAT_PRECISION

(SIM300)


28-33: Use shutil.rmtree for directory removal

The _file_delete function uses os.rmdir, which only removes empty directories. If the directories may contain files, consider using shutil.rmtree for recursive deletion.

Apply this diff:

+ import shutil

 def _file_delete(file):
     if os.path.isdir(file):
-        os.rmdir(file)
+        shutil.rmtree(file)
     elif os.path.isfile(file):
         os.remove(file)

80-87: Refactor global statement for readability

Using backslashes for line continuation is discouraged. Refactor the global statement to improve readability.

Apply this diff:

-     global \
-         INPUT, \
-         FROZEN_MODEL, \
-         COMPRESSED_MODEL, \
-         INPUT_ET, \
-         FROZEN_MODEL_ET, \
-         COMPRESSED_MODEL_ET
+     global INPUT, FROZEN_MODEL, COMPRESSED_MODEL, \
+            INPUT_ET, FROZEN_MODEL_ET, COMPRESSED_MODEL_ET

427-427: Remove unused variable nframes

The variable nframes is assigned but never used. Removing it will eliminate unnecessary code.

Apply this diff:

-            nframes = 1
🧰 Tools
🪛 Ruff

427-427: Local variable nframes is assigned to but never used

Remove assignment to unused variable nframes

(F841)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between b9acf04 and c91b8bb.

📒 Files selected for processing (5)
  • source/tests/pt/common.py (3 hunks)
  • source/tests/pt/model_compression/data/type.raw (1 hunks)
  • source/tests/pt/model_compression/data/type_map.raw (1 hunks)
  • source/tests/pt/model_compression/input.json (1 hunks)
  • source/tests/pt/test_model_compression_se_a.py (1 hunks)
✅ Files skipped from review due to trivial changes (2)
  • source/tests/pt/model_compression/data/type.raw
  • source/tests/pt/model_compression/data/type_map.raw
🧰 Additional context used
🪛 Ruff
source/tests/pt/test_model_compression_se_a.py

22-25: Use ternary operator default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10 instead of if-else-block

Replace if-else-block with default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10

(SIM108)


22-22: Yoda condition detected

Rewrite as np.float32 == GLOBAL_NP_FLOAT_PRECISION

(SIM300)


427-427: Local variable nframes is assigned to but never used

Remove assignment to unused variable nframes

(F841)

🔇 Additional comments (6)
source/tests/pt/model_compression/input.json (2)

49-58: Validate loss preference transitions.

The loss configuration shows significant transitions in preferences:

  • Force preference transitions from 1000 to 1
  • Energy preference transitions from 0.02 to 1
  • Volume preference is disabled (0)

Please ensure these transitions have been validated for model stability and convergence.

Consider documenting the rationale for these specific preference values and transitions in the comments.


41-47: Verify learning rate decay parameters.

The learning rate configuration shows a significant drop from start_lr (0.001) to stop_lr (3.51e-8). Please verify:

  • Whether this steep decay over 5000 steps is intentional
  • If these values have been tested for model stability
✅ Verification successful

The previous search was too specific. Let's broaden it to find any learning rate configurations and documentation to better understand the typical patterns used in this codebase.


The learning rate configuration is consistent with project standards

The search results show that this exact learning rate configuration (start_lr: 0.001, stop_lr: 3.51e-8, decay_steps: 5000) is widely used across multiple test and example configurations in the codebase, particularly in water-related models. The documentation in doc/troubleshooting/precision.md confirms this is a recommended configuration pattern, stating "The learning rate from the examples is a good choice to start."

The steep decay is intentional and follows the project's exponential decay formula documented in doc/train/training-advanced.md:

lr(t) = start_lr * decay_rate ^ (t / decay_steps)
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Search for similar learning rate configurations in other test files
rg -g "*.json" --type json "start_lr.*0\.001.*stop_lr.*3\.51e-8" -C 5

Length of output: 71


Script:

#!/bin/bash
# Search for any learning rate configurations in json files to compare patterns
rg -g "*.json" --type json "\"learning_rate\"" -A 8

# Also check for any documentation or comments about learning rate configuration
rg -g "*.md" -g "*.txt" "learning.?rate|lr" -i

Length of output: 48087

source/tests/pt/common.py (2)

2-2: LGTM! Clean import organization and path handling.

The addition of pathlib and the setup of tests_path using Path.absolute() follows best practices for cross-platform path handling.

Also applies to: 11-11, 20-20


23-24: Verify j_loader usage in compression tests.

Since this function is intended to support the new model compression functionality, let's verify its usage in the test files.

✅ Verification successful

j_loader is correctly integrated with compression functionality

The verification confirms that j_loader is properly used in the model compression tests:

  • It loads the compression configuration from "model_compression/input.json"
  • The loaded configuration contains all necessary parameters for model compression (descriptor, fitting_net, etc.)
  • The function is used in both regular and exclude-types compression test scenarios
  • The loaded data is properly modified and used to initialize the compression test environment
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Check how j_loader is used in compression-related test files

# Search for j_loader usage in test files
echo "Searching for j_loader usage in test files..."
rg "j_loader" "source/tests/pt/"

# Search specifically in compression test files
echo "Searching in compression-specific test files..."
fd "test.*compress.*\.py" "source/tests/pt/" --exec rg "j_loader" {}

Length of output: 1024


Script:

#!/bin/bash
# Let's examine the content of the input.json and how j_loader is used in the compression test

# Check the content of input.json
echo "Content of input.json:"
cat "source/tests/pt/model_compression/input.json" || echo "File not found"

# Check the context of j_loader usage in compression test
echo -e "\nContext of j_loader usage in compression test:"
rg -B 5 -A 5 "j_loader" "source/tests/pt/test_model_compression_se_a.py"

Length of output: 3212

source/tests/pt/test_model_compression_se_a.py (2)

154-156: Ensure appropriate precision in assertions

When using np.testing.assert_almost_equal, verify that default_places provides sufficient precision for your tests, especially if GLOBAL_NP_FLOAT_PRECISION affects numerical accuracy.


403-410: Verify the import path for DP calculator

You're importing DP from deepmd.tf.calculator, but since the tests are for the PyTorch implementation, ensure this is the correct module.

Run the following script to check if DP is available in deepmd.pt.calculator:

If the import is successful, consider updating the import statement:

- from deepmd.tf.calculator import (
+ from deepmd.pt.calculator import (
     DP,
 )

source/tests/pt/model_compression/input.json Outdated Show resolved Hide resolved
@cherryWangY
Copy link
Collaborator Author

File "/workspaces/deepmd-kit/source/tests/pt/test_model_compression_se_a.py", line 51, in _init_models
ret = run_dp("dp --pt train " + INPUT)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AssertionError: Torch not compiled with CUDA enabled

It seems that dp --pt train need torch compiled with CUDA enable?
@njzjz

@njzjz
Copy link
Member

njzjz commented Nov 5, 2024

File "/workspaces/deepmd-kit/source/tests/pt/test_model_compression_se_a.py", line 51, in _init_models

ret = run_dp("dp --pt train " + INPUT)

      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

AssertionError: Torch not compiled with CUDA enabled

It seems that dp --pt train need torch compiled with CUDA enable?

@njzjz

We set the default device to a virtual one. It should be never used.

torch.set_default_device("cuda:9999999")

But it seems that this case is not touched before. I'll take a look.

@cherryWangY
Copy link
Collaborator Author

cherryWangY commented Nov 5, 2024

Because we just need to test whether dp --pt compress is worked, I just use se_a as an example to test the end-to-end flow. I think we don't need to repeat end-to-end testing for each descriptor, as their correctness has been proven in previous tests.

@cherryWangY
Copy link
Collaborator Author

dp --pt compress successfully called model.enable_compression, but the model type read from freeze is EnergyModel

AttributeError: 'EnergyModel' object has no attribute 'enable_compression'

print(type(model))
<class 'deepmd.pt.model.model.ener_model.EnergyModel'>

@njzjz

@njzjz
Copy link
Member

njzjz commented Nov 5, 2024

dp --pt compress successfully called model.enable_compression, but the model type read from freeze is EnergyModel

AttributeError: 'EnergyModel' object has no attribute 'enable_compression'

print(type(model))

<class 'deepmd.pt.model.model.ener_model.EnergyModel'>

@njzjz

Isn't EnergyModel a subclass of BaseModel?

@cherryWangY
Copy link
Collaborator Author

dp --pt compress successfully called model.enable_compression, but the model type read from freeze is EnergyModel

AttributeError: 'EnergyModel' object has no attribute 'enable_compression'

print(type(model))

<class 'deepmd.pt.model.model.ener_model.EnergyModel'>

@njzjz

Isn't EnergyModel a subclass of BaseModel?

Sorry I don't seem to have updated the latest version of the code

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🧹 Outside diff range and nitpick comments (14)
source/tests/pt/test_tabulate.py (2)

64-64: Good fix for GPU tensor handling!

Adding .cpu() before .numpy() is essential for GPU compatibility. This fixes potential runtime errors when tensors are on GPU devices.

Consider making the device handling more consistent throughout the test. For example:

- torch.from_numpy(self.y)
+ torch.from_numpy(self.y).to(env.DEVICE)

This would ensure all tensors are on the same device during computations, following the pattern already used in some parts of the test.

Also applies to: 85-85


Based on the search results, I can now generate the final response:

GPU device handling needs to be consistent across test cases

The test file has inconsistent device handling - some tensor operations use env.DEVICE while others don't. This could cause issues when running on GPU:

  • Lines 43-48: torch.from_numpy(self.y) missing device placement
  • Lines 54-59: torch.from_numpy(self.y) missing device placement
  • Lines 74-80 and 94-101: Correctly using .to(env.DEVICE)

The search results show that other test files in the codebase consistently use device placement with .to(env.DEVICE) or .to(PT_DEVICE) when converting numpy arrays to tensors. We should follow the same pattern throughout this test file.

🔗 Analysis chain

Line range hint 1-134: Verify test coverage with GPU devices.

The test compares TensorFlow and PyTorch implementations, but we should ensure it runs correctly on both CPU and GPU setups.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Check if there are other similar patterns in test files that might need the same fix

# Test: Look for potential tensor to numpy conversions without cpu() call
rg -g '*/tests/**/*.py' '\.detach\(\)\.numpy\(\)' 

# Test: Look for other test files that might need similar device handling
rg -g '*/tests/**/*.py' 'torch\.from_numpy' -A 2

Length of output: 15307

source/tests/pt/test_model_compression_se_a.py (4)

44-51: Enhance error messages in assertion failures.

The assertions for command failures would be more helpful with detailed error messages.

-    np.testing.assert_equal(ret, 0, "DP train failed!")
+    np.testing.assert_equal(ret, 0, "DP train command failed with return code %d" % ret)
-    np.testing.assert_equal(ret, 0, "DP freeze failed!")
+    np.testing.assert_equal(ret, 0, "DP freeze command failed with return code %d" % ret)
-    np.testing.assert_equal(ret, 0, "DP model compression failed!")
+    np.testing.assert_equal(ret, 0, "DP model compression command failed with return code %d" % ret)

Also applies to: 66-73


89-573: Consider using a base test class to reduce code duplication.

The test classes share significant common code in their test methods. Consider extracting common test logic into a base class to improve maintainability.

Example structure:

class BaseDeepPotTest(unittest.TestCase):
    @classmethod
    def setUpClass(cls):
        cls.dp_original = None  # To be set by subclasses
        cls.dp_compressed = None  # To be set by subclasses
        cls.coords = np.array([...])  # Your common coordinates
        cls.atype = [0, 1, 1, 0, 1, 1]
        cls.box = None  # To be set by subclasses

    def test_attrs(self):
        # Common attribute tests
        pass

    def test_1frame(self):
        # Common single frame test
        pass

    # Other common test methods

460-480: Improve cleanup implementation robustness.

The current cleanup implementation has hardcoded filenames and could miss some files. Consider:

  1. Using patterns to match files for cleanup
  2. Maintaining a list of created files during tests

Example improvement:

@classmethod
def tearDownClass(cls):
    patterns = [
        "*.json",
        "*.meta",
        "*.index",
        "*.data-*",
        "checkpoint",
        "lcurve.out"
    ]
    
    for pattern in patterns:
        for file in glob.glob(pattern):
            _file_delete(file)
    
    # Clean specific directories
    directories = ["model-compression"]
    for directory in directories:
        if os.path.exists(directory):
            shutil.rmtree(directory)

21-24: Minor style improvements.

Consider these style enhancements:

  1. Use a ternary operator for cleaner code
  2. Use standard condition ordering
-if GLOBAL_NP_FLOAT_PRECISION == np.float32:
-    default_places = 4
-else:
-    default_places = 10
+default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10
🧰 Tools
🪛 Ruff

21-24: Use ternary operator default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10 instead of if-else-block

Replace if-else-block with default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10

(SIM108)


21-21: Yoda condition detected

Rewrite as np.float32 == GLOBAL_NP_FLOAT_PRECISION

(SIM300)

deepmd/pt/model/descriptor/se_a.py (3)

522-535: Consider using a constant for initial tensor size.

The initialization of compression parameters looks good. Consider defining a constant like INITIAL_COMPRESSION_TENSOR_SIZE = 0 for better maintainability.


675-706: Improve code maintainability and readability.

A few suggestions to enhance the code:

  1. The unused loop variable ll should be renamed to _ll
  2. Consider extracting network name construction into a helper method
  3. The magic numbers in info_ii tensor construction should be documented or converted to named constants
+ def _get_network_name(self, type_one_side: bool, ti: int, ii: int) -> str:
+     return f"filter_-1_net_{ii}" if type_one_side else f"filter_{ti}_net_{ii}"

 def enable_compression(
     self,
     table_data: dict[str, torch.Tensor],
     table_config: list[Union[int, float]],
     lower: dict[str, int],
     upper: dict[str, int],
 ) -> None:
-    for embedding_idx, ll in enumerate(self.filter_layers.networks):
+    for embedding_idx, _ll in enumerate(self.filter_layers.networks):
         if self.type_one_side:
             ii = embedding_idx
             ti = -1
         else:
             ii = embedding_idx // self.ntypes
             ti = embedding_idx % self.ntypes
-        if self.type_one_side:
-            net = "filter_-1_net_" + str(ii)
-        else:
-            net = "filter_" + str(ti) + "_net_" + str(ii)
+        net = self._get_network_name(self.type_one_side, ti, ii)
🧰 Tools
🪛 Ruff

680-680: Loop control variable ll not used within loop body

Rename unused ll to _ll

(B007)


Line range hint 755-791: Add error handling and improve documentation.

The compression path in the forward method could be improved:

  1. Consider adding a local try-catch block for tabulate_fusion_se_a operation
  2. Add comments explaining the shape transformations and the purpose of the compression path
  3. Document the expected format of compress_data_ii and compress_info_ii
     if self.compress:
+        # Reshape input to match tabulate fusion requirements
         ss = ss.reshape(-1, 1)  # xyz_scatter_tensor in tf
 
+        # Apply tabulated compression using custom operator
+        try:
             gr = torch.ops.deepmd.tabulate_fusion_se_a(
                 compress_data_ii.contiguous(),  # Compressed network parameters
                 compress_info_ii.cpu().contiguous(),  # Compression configuration
                 ss.contiguous(),  # Input features
                 rr.contiguous(),  # Rotation matrix
                 self.filter_neuron[-1],  # Output dimension
             )[0]
+        except RuntimeError as e:
+            raise RuntimeError(
+                "Failed to execute tabulate_fusion_se_a. Ensure PyTorch is built with custom operators."
+            ) from e
deepmd/pt/model/descriptor/se_r.py (1)

399-399: Unused Loop Variable ll in enable_compression

The loop control variable ll is not used within the loop body. This can be misleading and may cause confusion.

Apply this diff to rename ll to _:

-for ii, ll in enumerate(self.filter_layers.networks):
+for ii, _ in enumerate(self.filter_layers.networks):
🧰 Tools
🪛 Ruff

399-399: Loop control variable ll not used within loop body

Rename unused ll to _ll

(B007)

deepmd/pt/utils/tabulate.py (2)

557-569: Optimize tensor reshaping and operations in unaggregated_dy_dx

Consider reviewing the tensor reshaping operations for efficiency. The current implementation may introduce unnecessary computational overhead with repeated view and slicing operations. Refactoring could improve performance, especially for large tensors.


597-616: Consistency in tensor operations between unaggregated_dy2_dx and unaggregated_dy_dx

The function unaggregated_dy2_dx mirrors the structure of unaggregated_dy_dx. Ensure that any optimizations applied to one are consistently applied to the other to maintain code uniformity and reduce potential bugs.

deepmd/pt/model/descriptor/se_t.py (1)

726-745: Rename unused loop variable ll to underscore

The loop variable ll in enable_compression is not used within the loop body. Renaming it to _ clarifies that it is intentionally unused.

Apply this diff to rename the unused variable:

-for embedding_idx, ll in enumerate(self.filter_layers.networks):
+for embedding_idx, _ in enumerate(self.filter_layers.networks):
🧰 Tools
🪛 Ruff

726-726: Loop control variable ll not used within loop body

Rename unused ll to _ll

(B007)

deepmd/pt/model/descriptor/se_atten.py (1)

574-575: Remove redundant .cpu() call on self.compress_info[0]

Since self.compress_info[0] is already on the CPU device (as initialized in __init__), the .cpu() call is redundant. Removing this call can slightly improve performance and code clarity.

Apply this diff to remove the redundant call:

-                        self.compress_info[0].cpu().contiguous(),
+                        self.compress_info[0].contiguous(),
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 9d36d83 and 5dd73df.

📒 Files selected for processing (9)
  • deepmd/main.py (1 hunks)
  • deepmd/pt/model/descriptor/se_a.py (5 hunks)
  • deepmd/pt/model/descriptor/se_atten.py (3 hunks)
  • deepmd/pt/model/descriptor/se_r.py (5 hunks)
  • deepmd/pt/model/descriptor/se_t.py (5 hunks)
  • deepmd/pt/utils/serialization.py (2 hunks)
  • deepmd/pt/utils/tabulate.py (5 hunks)
  • source/tests/pt/test_model_compression_se_a.py (1 hunks)
  • source/tests/pt/test_tabulate.py (2 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • deepmd/main.py
🧰 Additional context used
🪛 Ruff
deepmd/pt/model/descriptor/se_a.py

680-680: Loop control variable ll not used within loop body

Rename unused ll to _ll

(B007)

deepmd/pt/model/descriptor/se_r.py

399-399: Loop control variable ll not used within loop body

Rename unused ll to _ll

(B007)

deepmd/pt/model/descriptor/se_t.py

726-726: Loop control variable ll not used within loop body

Rename unused ll to _ll

(B007)

source/tests/pt/test_model_compression_se_a.py

21-24: Use ternary operator default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10 instead of if-else-block

Replace if-else-block with default_places = 4 if GLOBAL_NP_FLOAT_PRECISION == np.float32 else 10

(SIM108)


21-21: Yoda condition detected

Rewrite as np.float32 == GLOBAL_NP_FLOAT_PRECISION

(SIM300)

🔇 Additional comments (11)
deepmd/pt/utils/serialization.py (2)

15-17: LGTM: Import addition is appropriate.

The new import of env is necessary for accessing global PyTorch settings used in tensor conversion.


79-83: Verify tensor conversion robustness.

While the tensor conversion looks correct, consider these potential issues:

  1. Error handling for invalid min_nbor_dist values
  2. Device placement failures
  3. Float precision loss during conversion

Let's verify the tensor conversion behavior:

Consider adding error handling:

         model.min_nbor_dist = torch.tensor(
-            float(data["@variables"]["min_nbor_dist"]),
-            dtype=env.GLOBAL_PT_FLOAT_PRECISION,
-            device=env.DEVICE,
+            float(data["@variables"]["min_nbor_dist"]),
+            dtype=env.GLOBAL_PT_FLOAT_PRECISION,
+            device='cpu'  # Create on CPU first
         )
+        try:
+            model.min_nbor_dist = model.min_nbor_dist.to(env.DEVICE)
+        except RuntimeError as e:
+            # Fallback to CPU if device is not available
+            print(f"Warning: Could not move tensor to {env.DEVICE}, using CPU instead: {e}")
✅ Verification successful

Based on the search results, I can now generate the final response:

Tensor conversion implementation is consistent and safe

The codebase shows consistent patterns for handling min_nbor_dist tensor creation:

  • Default initialization with safe values (e.g. -1.0 in model.py)
  • Consistent dtype and device handling across different components
  • No evidence of runtime issues with device placement or precision loss

The current implementation aligns with established patterns in the codebase and doesn't require additional error handling, as the tensor creation is straightforward and the device placement is handled globally through env.DEVICE.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check for similar tensor conversions in the codebase
# to ensure consistent handling

# Look for min_nbor_dist tensor creation patterns
rg "min_nbor_dist.*tensor" -A 3

# Check for error handling patterns around tensor creation
rg "tensor.*GLOBAL_PT_FLOAT_PRECISION.*device" -A 3

Length of output: 3733

source/tests/pt/test_model_compression_se_a.py (1)

27-31: Use shutil.rmtree for safer directory deletion.

deepmd/pt/model/descriptor/se_r.py (1)

153-167: Initialization of Compression Attributes Looks Good

The addition of self.compress, self.compress_info, and self.compress_data correctly initializes the necessary attributes for enabling compression functionality in the descriptor. The use of nn.ParameterList ensures that the parameters are properly registered for optimization.

deepmd/pt/utils/tabulate.py (4)

429-456: Implementation of grad function is correct and efficient

The grad function correctly computes gradients for different activation functions based on functype. It handles unsupported function types appropriately by raising a ValueError.


490-503: Validation and tensor operations in unaggregated_dy_dx_s are appropriate

The unaggregated_dy_dx_s function correctly performs input dimension checks and tensor operations. The conversion from NumPy arrays to PyTorch tensors and moving them to the appropriate device is handled well.


Line range hint 516-532: Input validation in unaggregated_dy2_dx_s is thorough

The function unaggregated_dy2_dx_s ensures that all inputs have the correct dimensions before proceeding with computations, which helps prevent potential runtime errors.


599-605: Potential for numerical instability in grad_grad calculations

In the grad_grad function, especially for functype == 2, the computations involve operations that could lead to numerical instability due to the operations on high-degree polynomials. Consider implementing safeguards or numerical techniques to mitigate potential overflow or underflow issues.

To verify the stability of these computations, consider running tests with extreme values:

deepmd/pt/model/descriptor/se_t.py (2)

12-12: Import of torch.nn is necessary

The addition of import torch.nn as nn is appropriate, as nn.ParameterList is utilized in the code.


572-586: Proper initialization of compression attributes

The initialization of self.compress, self.compress_info, and self.compress_data correctly sets up the model for compression functionality.

deepmd/pt/model/descriptor/se_atten.py (1)

272-281: Initialization of compression attributes looks good

The newly added attributes for compression (self.compress, self.is_sorted, self.compress_info, and self.compress_data) are appropriately initialized to support the compression mechanism.

deepmd/pt/model/descriptor/se_r.py Show resolved Hide resolved
deepmd/pt/model/descriptor/se_r.py Outdated Show resolved Hide resolved
deepmd/pt/utils/tabulate.py Show resolved Hide resolved
deepmd/pt/model/descriptor/se_atten.py Show resolved Hide resolved
deepmd/main.py Outdated Show resolved Hide resolved
deepmd/main.py Outdated Show resolved Hide resolved
Copy link
Member

@njzjz njzjz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am satisfied with the current state of this PR.

@njzjz
Copy link
Member

njzjz commented Nov 8, 2024

Wait for #4326 to be merged.

@cherryWangY
Copy link
Collaborator Author

Wait for #4326 to be merged.

OK, I'm troubled by the current error.

@njzjz njzjz requested a review from wanghan-iapcm November 8, 2024 05:40
@njzjz njzjz enabled auto-merge November 8, 2024 08:38
@cherryWangY
Copy link
Collaborator Author

I think we need to update dpa1.pth

Signed-off-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (2)
source/tests/pt/model/test_unused_params.py (1)

89-90: Enhance test documentation and verification for non-contributing parameters.

While the change to expect 2 non-contributing parameters aligns with the addition of compression functionality, the test would benefit from:

  1. Better documentation explaining which specific parameters are expected to be non-contributing
  2. Additional assertions to verify the identity of these parameters

Consider adding assertions like:

 # 2 for compression
 self.assertEqual(len(non_contributing), 2)
+# Verify the specific compression-related parameters that should be non-contributing
+non_contributing_names = {param.name for param in non_contributing}
+expected_names = {'param1_name', 'param2_name'}  # Replace with actual parameter names
+self.assertEqual(non_contributing_names, expected_names, 
+    "Unexpected non-contributing parameters found")
source/tests/pt/model/test_descriptor_dpa1.py (1)

248-252: LGTM! Consider adding more detailed comments.

The changes appropriately handle backward compatibility for older state dictionaries by manually adding compression-related states.

Consider expanding the comment to explain:

  • Why this manual modification is necessary
  • What versions of state dictionaries require this handling
  • When this compatibility code can be removed
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between d4fc7ef and 33d5fd9.

📒 Files selected for processing (3)
  • source/tests/pt/model/test_descriptor_dpa1.py (2 hunks)
  • source/tests/pt/model/test_descriptor_dpa2.py (1 hunks)
  • source/tests/pt/model/test_unused_params.py (1 hunks)
🔇 Additional comments (2)
source/tests/pt/model/test_descriptor_dpa2.py (1)

197-198: ⚠️ Potential issue

Verify compression data handling requirements.

The code marks compression-related keys as processed without setting their values. This could lead to undefined behavior if these keys are required for the compression functionality.

Let's verify the compression key requirements:

Consider one of these approaches:

  1. Initialize these keys with appropriate default values if they're required
  2. Add documentation explaining why these keys can be safely marked as processed without values
  3. Add assertions to verify these keys aren't required in the current context
source/tests/pt/model/test_descriptor_dpa1.py (1)

378-379: LGTM! Consider adding key existence verification.

The changes correctly mark compression-related keys as present in the record list, maintaining consistency with the state dictionary modifications.

Let's verify that these compression-related keys are actually present in the target dictionary:

✅ Verification successful

Based on the search results, I can now generate the final response:

Compression-related keys are properly defined and used consistently

The changes correctly mark compression-related keys as present in the record list. The verification shows that:

  • compress_data and compress_info are properly defined as ParameterList attributes in the SE descriptor classes
  • These keys are consistently used across the codebase in both DPA1 and DPA2 test descriptors
  • The state dictionary handling in test_descriptor_dpa1.py properly manages these compression attributes
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Search for compression-related attributes in the codebase
# to ensure they are properly defined in the relevant classes.

# Test: Look for compression attribute definitions
rg -A 5 'compress_(info|data)'

# Test: Look for compression-related state dict keys
rg -A 5 'compress.*["\'].*state_dict'

Length of output: 10885

Signed-off-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>
@njzjz njzjz added this pull request to the merge queue Nov 8, 2024
Merged via the queue into deepmodeling:devel with commit 0c5ab07 Nov 8, 2024
60 checks passed
@njzjz njzjz added the breaking change Breaking changes that should notify users. label Nov 13, 2024
This was referenced Nov 21, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
breaking change Breaking changes that should notify users. Python
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Feature Request] Model compression for PyTorch (se_a + se_atten_v2)
3 participants