Expand MATLAB-Python bridge documentation with comprehensive method mappings

[stevevanhooser]

Summary

This PR significantly expands the MATLAB-to-Python bridge documentation by adding detailed method mappings for core NDI classes (Ido, DocumentPersistence, Document, and Query). It also removes the now-redundant MATLAB_MAPPING.md file in favor of the more structured YAML-based bridge definitions.

Key Changes

• Ido class: Added mappings for unique_id(), is_valid(), and eq() methods with decision logs explaining exact matches and synchronization details.

• DocumentPersistence interface: Added load_element_doc() and document_id() methods to the interface specification.

• Document class: Significantly expanded with 40+ new method mappings including:

  • Identity methods: id(), session_id(), doc_unique_id()
  • Dependency management: dependency(), dependency_value(), dependency_value_n(), add_dependency_value_n(), remove_dependency_value_n()
  • File management: has_files(), add_file(), remove_file(), current_file_list()
  • Document class information: doc_class(), doc_superclass(), doc_isa()
  • Serialization: write(), setproperties(), validate()
  • Conversion: to_table(), to_dict(), to_json()
  • Merging: plus() (mapped to __add__)
  • Static methods: find_doc_by_id(), find_newest(), read_blank_definition()
  • Added section comments organizing methods by category (Constructor, Identity, Session, Dependency Management, File Management, etc.)

• Query class: Added comprehensive method mappings including:

  • Computed properties: field, operator, value, queries
  • Comparison operators: eq(), ne(), lt(), le(), gt(), ge() (mapped to Python magic methods)
  • Logical operators: and(), or(), not() (mapped to __and__, __or__, __invert__)
  • String/pattern methods: contains(), match(), equals()
  • Explicit comparison methods: less_than(), less_than_or_equal_to(), greater_than(), greater_than_or_equal_to()
  • Field existence: has_field(), has_member()
  • Static factory methods: all(), none(), from_search()
  • Added section comments organizing methods by type

• Database class: Added convenience methods from the didsqlite subclass:

  • update(), add_or_replace(), find_by_id(), numdocs()
  • find_depends_on(), find_dependencies()
  • add_many(), remove_many(), get_binary_path()

• GUI ProgressDisplay class: Added methods setProgressTracker(), getProgressValue(), getProgressTitle(), formatMessage()

• Removed: MATLAB_MAPPING.md file (554 lines) - functionality now consolidated into structured YAML bridge definitions

Implementation Details

• All new method entries include:

  • Complete input/output argument specifications with type mappings
  • Decision logs explaining the mapping rationale and synchronization date (2026-03-13)
  • Proper handling of optional parameters with defaults
  • Mapping of MATLAB operator overloads to Python magic methods (e.g., == → __eq__)

• Methods are organized with section comments for better readability and maintainability

• Synchronization date consistently set to 2026-03-13 across all new entries

• Maintains consistency with existing bridge documentation patterns

https://claude.ai/code/session_01XFmUSUpA1PAwxpDnczwGAv