Implement Custom Types -- AttributeType

docs/src/compute/key-source.md

@@ -45,7 +45,7 @@ definition = """
 -> Recording
 ---
 sample_rate : float
-eeg_data : longblob
+eeg_data : <djblob>
 """
 key_source = Recording & 'recording_type = "EEG"'
 ```

docs/src/compute/make.md

@@ -152,7 +152,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 
@@ -188,7 +188,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 

docs/src/compute/populate.md

@@ -40,7 +40,7 @@ class FilteredImage(dj.Computed):
      # Filtered image
      -> Image
      ---
-     filtered_image : longblob
+     filtered_image : <djblob>
      """
 
      def make(self, key):
@@ -196,7 +196,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 
@@ -230,7 +230,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 

docs/src/design/integrity.md

@@ -142,7 +142,7 @@ definition = """
 -> EEGRecording
 channel_idx : int
 ---
-channel_data : longblob
+channel_data : <djblob>
 """
 ```
 ![doc_1-many](../images/doc_1-many.png){: style="align:center"}

docs/src/design/tables/attributes.md

@@ -48,9 +48,10 @@ fractional digits.
    Because of its well-defined precision, `decimal` values can be used in equality
    comparison and be included in primary keys.
 
--  `longblob`: arbitrary numeric array (e.g. matrix, image, structure), up to 4
+-  `longblob`: raw binary data, up to 4
 [GiB](http://en.wikipedia.org/wiki/Gibibyte) in size.
-   Numeric arrays are compatible between MATLAB and Python (NumPy).
+   Stores and returns raw bytes without serialization.
+   For serialized Python objects (arrays, dicts, etc.), use `<djblob>` instead.
    The `longblob` and other `blob` datatypes can be configured to store data
    [externally](../../sysadmin/external-store.md) by using the `blob@store` syntax.
 
@@ -71,6 +72,10 @@ info).
 These types abstract certain kinds of non-database data to facilitate use
 together with DataJoint.
 
+- `<djblob>`: DataJoint's native serialization format for Python objects. Supports
+NumPy arrays, dicts, lists, datetime objects, and nested structures. Compatible with
+MATLAB. See [custom types](customtype.md) for details.
+
 - `object`: managed [file and folder storage](object.md) with support for direct writes
 (Zarr, HDF5) and fsspec integration. Recommended for new pipelines.
 
@@ -80,6 +85,10 @@ sending/receiving an opaque data file to/from a DataJoint pipeline.
 - `filepath@store`: a [filepath](filepath.md) used to link non-DataJoint managed files
 into a DataJoint pipeline.
 
+- `<custom_type>`: a [custom attribute type](customtype.md) that defines bidirectional
+conversion between Python objects and database storage formats. Use this to store
+complex data types like graphs, domain-specific objects, or custom data structures.
+
 ## Numeric type aliases
 
 DataJoint provides convenient type aliases that map to standard MySQL numeric types.