mindee 3.2.0 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ab7abbf2686b67f4330ceb018dc5de8b799d567d586072199f22dfcb12b647d
-  data.tar.gz: 15d885b0fa5e42cf84a1ca6f4238f0c1681bb4c3587fbdf8cd9b48f69850a1f4
+  metadata.gz: ba0a25a68b96ba432920774b10de815c3dbf89386d9e74ea22b13fc36535e50a
+  data.tar.gz: a4f6f9d5da64be2c83ecdd32fdc6f8322998c470c1f94a099dff417ac9419671
 SHA512:
-  metadata.gz: 0036d0f5b668d81a1fb602689fc33d98e6ff02a03175b219f7c541689d27a4fb76123982610d979b89f97f074d3fc202effa5f3d00ac9da905d99afe20ef0beb
-  data.tar.gz: dc4d2bd7147c6c0d4d589642d0d6b6a343fdfc5fc305e5d03fe1628dd013b70679b5185fd531015957a998ae9c930d570f537e352d7899ff783945179c480470
+  metadata.gz: f7af6e145ded009966a409c35bc7058158532cee1cc927486b1b05a003a3c8238968305ee4e546cc354abb3b78a5bc45caf4379b1e586bdcf61d800a766368b6
+  data.tar.gz: 591c6e87b9fcdc25b88bf3da8f6fd38c950fb9b03c6aeb096a14bc1f0da9dbf458c7445f137cbc27cef823126472b03653960ba741ea30083642da443f9f523a

data/.gitignore

@@ -19,6 +19,7 @@ _test.rb
 /vendor
 /mindee-*/
 local-test
+local_test/
 
 # Used by dotenv library to load environment variables.
 .env

data/.rubocop.yml

@@ -7,6 +7,7 @@ AllCops:
     - '.git/**/*'
     - 'bin/*'
     - _test.rb
+    - local_test/*
 
   TargetRubyVersion: 2.6
   SuggestExtensions: false

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Mindee Ruby API Library Changelog
 
+## v3.3.0 - 2023-11-17
+### Changes
+* :sparkles: add support for Carte Grise V1
+* :sparkles: add page number attributes to doc
+* :arrow_up: update tests, docs & display format for some products
+
+### Fixes
+* :bug: fix page id not working on newer custom models
+
+
 ## v3.2.0 - 2023-09-15
 ### Changes
 * :sparkles: add support for Multi Receipts Detector V1

data/bin/mindee.rb

@@ -157,7 +157,7 @@ global_parser = OptionParser.new do | opts |
 end
 
 command = ARGV.shift
-if !DOCUMENTS.has_key?(command)
+if !DOCUMENTS.include?(command)
   abort(global_parser.help)
 end
 doc_class = DOCUMENTS[command][:doc_class]

data/docs/barcode_reader_v1.md

@@ -1,5 +1,5 @@
 ---
-title: Barcode Reader API Ruby
+title: Barcode Reader OCR Ruby
 ---
 The Ruby OCR SDK supports the [Barcode Reader API](https://platform.mindee.com/mindee/barcode_reader).
 
@@ -34,7 +34,7 @@ puts result.document
 ########
 Document
 ########
-:Mindee ID: 0f54c154-5030-41ac-939e-046b7f6aca71
+:Mindee ID: f9c48da1-a306-4805-8da8-f7231fda2d88
 :Filename: default_sample.jpg
 
 Inference

data/docs/carte_grise_v1.md

@@ -0,0 +1,454 @@
+---
+title: FR Carte Grise OCR Ruby
+---
+The Ruby OCR SDK supports the [Carte Grise API](https://platform.mindee.com/mindee/carte_grise).
+
+Using the [sample below](https://github.com/mindee/client-lib-test-data/blob/main/products/carte_grise/default_sample.jpg), we are going to illustrate how to extract the data that we want using the OCR SDK.
+![Carte Grise sample](https://github.com/mindee/client-lib-test-data/blob/main/products/carte_grise/default_sample.jpg?raw=true)
+
+# Quick-Start
+```rb
+require 'mindee'
+
+# Init a new client
+mindee_client = Mindee::Client.new(api_key: 'my-api-key')
+
+# Load a file from disk
+input_source = mindee_client.source_from_path('/path/to/the/file.ext')
+
+# Parse the file
+result = mindee_client.parse(
+  input_source,
+  Mindee::Product::FR::CarteGrise::CarteGriseV1
+)
+
+# Print a full summary of the parsed data in RST format
+puts result.document
+
+# Print the document-level parsed data
+# puts result.document.inference.prediction
+```
+
+**Output (RST):**
+```rst
+########
+Document
+########
+:Mindee ID: f0e0f7a9-0f44-4a3d-92c7-5be262133d33
+:Filename: default_sample.jpg
+
+Inference
+#########
+:Product: mindee/carte_grise v1.0
+:Rotation applied: Yes
+
+Prediction
+==========
+:a: AB-123-CD
+:b: 1998-01-05
+:c1: DUPONT YVES
+:c3: 27 RUE DES ROITELETS 59169 FERIN LES BAINS FRANCE
+:c41: 2 DELAROCHE
+:c4a: EST LE PROPRIETAIRE DU VEHICULE
+:d1:
+:d3: MODELE
+:e: VFS1V2009AS1V2009
+:f1: 1915
+:f2: 1915
+:f3: 1915
+:g: 3030
+:g1: 1307
+:i: 2009-12-04
+:j: N1
+:j1: VP
+:j2: AA
+:j3: CI
+:p1: 1900
+:p2: 90
+:p3: GO
+:p6: 6
+:q:
+:s1: 5
+:s2:
+:u1: 77
+:u2: 3000
+:v7: 155
+:x1: 2011-07-06
+:y1:
+:y2:
+:y3: 0
+:y4: 4
+:y5: 2.5
+:y6: 178.35
+:Formula Number: 2009AS05284
+:Owner's First Name: YVES
+:Owner's Surname: DUPONT
+:MRZ Line 1:
+:MRZ Line 2: CI<<MARQUES<<<<<<<MODELE<<<<<<<2009AS0528402
+
+Page Predictions
+================
+
+Page 0
+------
+:a: AB-123-CD
+:b: 1998-01-05
+:c1: DUPONT YVES
+:c3: 27 RUE DES ROITELETS 59169 FERIN LES BAINS FRANCE
+:c41: 2 DELAROCHE
+:c4a: EST LE PROPRIETAIRE DU VEHICULE
+:d1:
+:d3: MODELE
+:e: VFS1V2009AS1V2009
+:f1: 1915
+:f2: 1915
+:f3: 1915
+:g: 3030
+:g1: 1307
+:i: 2009-12-04
+:j: N1
+:j1: VP
+:j2: AA
+:j3: CI
+:p1: 1900
+:p2: 90
+:p3: GO
+:p6: 6
+:q: 006
+:s1: 5
+:s2:
+:u1: 77
+:u2: 3000
+:v7: 155
+:x1: 2011-07-06
+:y1: 17835
+:y2:
+:y3: 0
+:y4: 4
+:y5: 2.5
+:y6: 178.35
+:Formula Number: 2009AS05284
+:Owner's First Name: YVES
+:Owner's Surname: DUPONT
+:MRZ Line 1:
+:MRZ Line 2: CI<<MARQUES<<<<<<<MODELE<<<<<<<2009AS0528402
+```
+
+# Field Types
+## Standard Fields
+These fields are generic and used in several products.
+
+### Basic Field
+Each prediction object contains a set of fields that inherit from the generic `Field` class.
+A typical `Field` object will have the following attributes:
+
+* **value** (`String`, `Float`, `Integer`, `Boolean`): corresponds to the field value. Can be `nil` if no value was extracted.
+* **confidence** (Float, nil): the confidence score of the field prediction.
+* **bounding_box** (`Mindee::Geometry::Quadrilateral`, `nil`): contains exactly 4 relative vertices (points) coordinates of a right rectangle containing the field in the document.
+* **polygon** (`Mindee::Geometry::Polygon`, `nil`): contains the relative vertices coordinates (`Point`) of a polygon containing the field in the image.
+* **page_id** (`Integer`, `nil`): the ID of the page, is `nil` when at document-level.
+* **reconstructed** (`Boolean`): indicates whether or not an object was reconstructed (not extracted as the API gave it).
+
+
+Aside from the previous attributes, all basic fields have access to a `to_s` method that can be used to print their value as a string.
+
+### Date Field
+Aside from the basic `Field` attributes, the date field `DateField` also implements the following: 
+
+* **date_object** (`Date`): an accessible representation of the value as a JavaScript object.
+
+### String Field
+The text field `StringField` only has one constraint: it's **value** is a `String` (or `nil`).
+
+# Attributes
+The following fields are extracted for Carte Grise V1:
+
+## a
+**a** ([StringField](#string-field)): The vehicle's license plate number.
+
+```rb
+puts result.document.inference.prediction.a.value
+```
+
+## b
+**b** ([DateField](#date-field)): The vehicle's first release date.
+
+```rb
+puts result.document.inference.prediction.b.value
+```
+
+## c1
+**c1** ([StringField](#string-field)): The vehicle owner's full name including maiden name.
+
+```rb
+puts result.document.inference.prediction.c1.value
+```
+
+## c3
+**c3** ([StringField](#string-field)): The vehicle owner's address.
+
+```rb
+puts result.document.inference.prediction.c3.value
+```
+
+## c41
+**c41** ([StringField](#string-field)): Number of owners of the license certificate.
+
+```rb
+puts result.document.inference.prediction.c41.value
+```
+
+## c4a
+**c4a** ([StringField](#string-field)): Mentions about the ownership of the vehicle.
+
+```rb
+puts result.document.inference.prediction.c4a.value
+```
+
+## d1
+**d1** ([StringField](#string-field)): The vehicle's brand.
+
+```rb
+puts result.document.inference.prediction.d1.value
+```
+
+## d3
+**d3** ([StringField](#string-field)): The vehicle's commercial name.
+
+```rb
+puts result.document.inference.prediction.d3.value
+```
+
+## e
+**e** ([StringField](#string-field)): The Vehicle Identification Number (VIN).
+
+```rb
+puts result.document.inference.prediction.e.value
+```
+
+## f1
+**f1** ([StringField](#string-field)): The vehicle's maximum admissible weight.
+
+```rb
+puts result.document.inference.prediction.f1.value
+```
+
+## f2
+**f2** ([StringField](#string-field)): The vehicle's maximum admissible weight within the license's state.
+
+```rb
+puts result.document.inference.prediction.f2.value
+```
+
+## f3
+**f3** ([StringField](#string-field)): The vehicle's maximum authorized weight with coupling.
+
+```rb
+puts result.document.inference.prediction.f3.value
+```
+
+## Formula Number
+**formula_number** ([StringField](#string-field)): The document's formula number.
+
+```rb
+puts result.document.inference.prediction.formula_number.value
+```
+
+## g
+**g** ([StringField](#string-field)): The vehicle's weight with coupling if tractor different than category M1.
+
+```rb
+puts result.document.inference.prediction.g.value
+```
+
+## g1
+**g1** ([StringField](#string-field)): The vehicle's national empty weight.
+
+```rb
+puts result.document.inference.prediction.g1.value
+```
+
+## i
+**i** ([DateField](#date-field)): The car registration date of the given certificate.
+
+```rb
+puts result.document.inference.prediction.i.value
+```
+
+## j
+**j** ([StringField](#string-field)): The vehicle's category.
+
+```rb
+puts result.document.inference.prediction.j.value
+```
+
+## j1
+**j1** ([StringField](#string-field)): The vehicle's national type.
+
+```rb
+puts result.document.inference.prediction.j1.value
+```
+
+## j2
+**j2** ([StringField](#string-field)): The vehicle's body type (CE).
+
+```rb
+puts result.document.inference.prediction.j2.value
+```
+
+## j3
+**j3** ([StringField](#string-field)): The vehicle's body type (National designation).
+
+```rb
+puts result.document.inference.prediction.j3.value
+```
+
+## MRZ Line 1
+**mrz1** ([StringField](#string-field)): Machine Readable Zone, first line.
+
+```rb
+puts result.document.inference.prediction.mrz1.value
+```
+
+## MRZ Line 2
+**mrz2** ([StringField](#string-field)): Machine Readable Zone, second line.
+
+```rb
+puts result.document.inference.prediction.mrz2.value
+```
+
+## Owner's First Name
+**owner_first_name** ([StringField](#string-field)): The vehicle's owner first name.
+
+```rb
+puts result.document.inference.prediction.owner_first_name.value
+```
+
+## Owner's Surname
+**owner_surname** ([StringField](#string-field)): The vehicle's owner surname.
+
+```rb
+puts result.document.inference.prediction.owner_surname.value
+```
+
+## p1
+**p1** ([StringField](#string-field)): The vehicle engine's displacement (cm3).
+
+```rb
+puts result.document.inference.prediction.p1.value
+```
+
+## p2
+**p2** ([StringField](#string-field)): The vehicle's maximum net power (kW).
+
+```rb
+puts result.document.inference.prediction.p2.value
+```
+
+## p3
+**p3** ([StringField](#string-field)): The vehicle's fuel type or energy source.
+
+```rb
+puts result.document.inference.prediction.p3.value
+```
+
+## p6
+**p6** ([StringField](#string-field)): The vehicle's administrative power (fiscal horsepower).
+
+```rb
+puts result.document.inference.prediction.p6.value
+```
+
+## q
+**q** ([StringField](#string-field)): The vehicle's power to weight ratio.
+
+```rb
+puts result.document.inference.prediction.q.value
+```
+
+## s1
+**s1** ([StringField](#string-field)): The vehicle's number of seats.
+
+```rb
+puts result.document.inference.prediction.s1.value
+```
+
+## s2
+**s2** ([StringField](#string-field)): The vehicle's number of standing rooms (person).
+
+```rb
+puts result.document.inference.prediction.s2.value
+```
+
+## u1
+**u1** ([StringField](#string-field)): The vehicle's sound level (dB).
+
+```rb
+puts result.document.inference.prediction.u1.value
+```
+
+## u2
+**u2** ([StringField](#string-field)): The vehicle engine's rotation speed (RPM).
+
+```rb
+puts result.document.inference.prediction.u2.value
+```
+
+## v7
+**v7** ([StringField](#string-field)): The vehicle's CO2 emission (g/km).
+
+```rb
+puts result.document.inference.prediction.v7.value
+```
+
+## x1
+**x1** ([StringField](#string-field)): Next technical control date.
+
+```rb
+puts result.document.inference.prediction.x1.value
+```
+
+## y1
+**y1** ([StringField](#string-field)): Amount of the regional proportional tax of the registration (in euros).
+
+```rb
+puts result.document.inference.prediction.y1.value
+```
+
+## y2
+**y2** ([StringField](#string-field)): Amount of the additional parafiscal tax of the registration (in euros).
+
+```rb
+puts result.document.inference.prediction.y2.value
+```
+
+## y3
+**y3** ([StringField](#string-field)): Amount of the additional CO2 tax of the registration (in euros).
+
+```rb
+puts result.document.inference.prediction.y3.value
+```
+
+## y4
+**y4** ([StringField](#string-field)): Amount of the fee for managing the registration (in euros).
+
+```rb
+puts result.document.inference.prediction.y4.value
+```
+
+## y5
+**y5** ([StringField](#string-field)): Amount of the fee for delivery of the registration certificate in euros.
+
+```rb
+puts result.document.inference.prediction.y5.value
+```
+
+## y6
+**y6** ([StringField](#string-field)): Total amount of registration fee to be paid in euros.
+
+```rb
+puts result.document.inference.prediction.y6.value
+```
+
+# Questions?
+[Join our Slack](https://join.slack.com/t/mindee-community/shared_invite/zt-1jv6nawjq-FDgFcF2T5CmMmRpl9LLptw)

data/docs/code_samples/carte_grise_v1.txt

@@ -0,0 +1,19 @@
+require 'mindee'
+
+# Init a new client
+mindee_client = Mindee::Client.new(api_key: 'my-api-key')
+
+# Load a file from disk
+input_source = mindee_client.source_from_path('/path/to/the/file.ext')
+
+# Parse the file
+result = mindee_client.parse(
+  input_source,
+  Mindee::Product::FR::CarteGrise::CarteGriseV1
+)
+
+# Print a full summary of the parsed data in RST format
+puts result.document
+
+# Print the document-level parsed data
+# puts result.document.inference.prediction

data/docs/cropper_v1.md

@@ -1,5 +1,5 @@
 ---
-title: Cropper API Ruby
+title: Cropper OCR Ruby
 ---
 The Ruby OCR SDK supports the [Cropper API](https://platform.mindee.com/mindee/cropper).
 

data/docs/custom_v1.md

@@ -59,14 +59,22 @@ If it is not set, it will default to "1".
 A `ListField` is a special type of custom list that implements the following:
 
 * **confidence** (`Float`): the confidence score of the field prediction.
-* **pageId** (`Integer`): the ID of the page, is `nil` when at document-level.
 * **reconstructed** (`Boolean`): indicates whether or not an object was reconstructed (not extracted as the API gave it).
+* **values** (`Array<`[ListFieldItem](#list-field-item)`>`): list of value fields
 
 Since the inner contents can vary, the value isn't accessed through a property, but rather through the following functions:
 * **contents_list()** (`[Array, Hash, String, nil]`): returns a list of values for each element.
 * **contents_str(separator:' ')** (`String`): returns a list of concatenated values, with an optional **separator** `String` between them.
 * **to_s()**: returns a string representation of all values, with an empty space between each of them.
 
+#### List Field Item
+
+Values of `ListField`s are stored in a `ListFieldItem` structure, which is implemented as follows:
+* **content** (`String`): extracted content of the prediction
+* **confidence** (`Float`): the confidence score of the prediction
+* **bounding_box** (`Quadrilateral`): 4 relative vertices corrdinates of a rectangle containing the word in the document.
+* **polygon** (`Polygon`): vertices of a polygon containing the word.
+* **page_id** (`Integer`): the ID of the page, is `nil` when at document-level.
 
 ### Classification Field
 

data/docs/expense_receipts_v5.md

@@ -159,7 +159,7 @@ The text field `StringField` only has one constraint: it's **value** is a `Strin
 #### Tax
 Aside from the basic `Field` attributes, the tax field `TaxField` also implements the following:
 
-* **rate** (`Float`): the tax rate applied to an item can be undefined. Expressed as a percentage. Can be `nil`.
+* **rate** (`Float`): the tax rate applied to an item can be expressed as a percentage. Can be `nil`.
 * **code** (`String`): tax code (or equivalent, depending on the origin of the document). Can be `nil`.
 * **base** (`Float`): base amount used for the tax. Can be `nil`.
 

data/docs/financial_document_v1.md

@@ -58,11 +58,11 @@ Prediction
   |               | TAX    |          | 3.34          |
   +---------------+--------+----------+---------------+
 :Supplier Payment Details:
-:Supplier name: LOGANS
+:Supplier Name: LOGANS
 :Supplier Company Registrations:
 :Supplier Address: 2513 s stemmons freeway lewisville tx 75067
 :Supplier Phone Number: 9724596042
-:Customer name:
+:Customer Name:
 :Customer Company Registrations:
 :Customer Address:
 :Document Type: EXPENSE RECEIPT
@@ -97,11 +97,11 @@ Page 0
   |               | TAX    |          | 3.34          |
   +---------------+--------+----------+---------------+
 :Supplier Payment Details:
-:Supplier name: LOGANS
+:Supplier Name: LOGANS
 :Supplier Company Registrations:
 :Supplier Address: 2513 s stemmons freeway lewisville tx 75067
 :Supplier Phone Number: 9724596042
-:Customer name:
+:Customer Name:
 :Customer Company Registrations:
 :Customer Address:
 :Document Type: EXPENSE RECEIPT
@@ -179,7 +179,7 @@ The text field `StringField` only has one constraint: it's **value** is a `Strin
 #### Tax
 Aside from the basic `Field` attributes, the tax field `TaxField` also implements the following:
 
-* **rate** (`Float`): the tax rate applied to an item can be undefined. Expressed as a percentage. Can be `nil`.
+* **rate** (`Float`): the tax rate applied to an item can be expressed as a percentage. Can be `nil`.
 * **code** (`String`): tax code (or equivalent, depending on the origin of the document). Can be `nil`.
 * **base** (`Float`): base amount used for the tax. Can be `nil`.
 
@@ -313,7 +313,7 @@ for supplier_company_registrations_elem in result.document.inference.prediction.
 end
 ```
 
-## Supplier name
+## Supplier Name
 **supplier_name** ([StringField](#string-field)): The name of the supplier or merchant.
 
 ```rb