تحذير: تم إهمال واجهة برمجة التطبيقات هذه وستتم إزالتها في إصدار مستقبلي من TensorFlow بعد استقرار الاستبدال .

Tensor

تينسور الطبقة النهائية العامة

مصفوفة متعددة الأبعاد مكتوبة بشكل ثابت تكون عناصرها من النوع الذي وصفه T.

مثيلات Tensor ليست آمنة للخيط.

تحذير: يجب تحرير الموارد التي يستهلكها كائن Tensor بشكل صريح عن طريق استدعاء طريقة close() عندما لا تكون هناك حاجة إلى الكائن. على سبيل المثال ، باستخدام كتلة try-with-Resources:

try (Tensor t = Tensor.create(...)) {
   doSomethingWith(t);
 
 }

الطرق العامة

قيمة منطقية
قيمة منطقية ()
ترجع القيمة في موتر Boolean عددي.
بايت []
بايتValue ()
ترجع القيمة في موتر String عددية.
فارغ
إغلاق ()
تحرير الموارد المرتبطة Tensor.
<U> يو
نسخ إلى (U dst)
نسخ محتويات الموتر إلى dst وإرجاع dst .
موتر ثابت <؟>
إنشاء (كائن كائن)
ينشئ موترًا من كائن يتم فحص صنفه لمعرفة نوع البيانات الأساسي الذي يجب أن يكون.
ثابت <T> موتر <T>
إنشاء (فئة <T> نوع ، شكل [] طويل ، بيانات ByteBuffer)
قم بإنشاء Tensor من أي نوع باستخدام البيانات من المخزن المؤقت المحدد.
موتر ثابت <مزدوج>
إنشاء شكل (طويل [] ، بيانات DoubleBuffer)
إنشاء Double Tensor مع البيانات من المخزن المؤقت المحدد.
موتر ثابت <طويل>
إنشاء شكل (طويل [] ، بيانات LongBuffer)
إنشاء موتر Long مع البيانات من المخزن المؤقت المحدد.
موتر ثابت <Integer>
إنشاء شكل (طويل [] ، بيانات IntBuffer)
إنشاء موتر Integer مع البيانات من المخزن المؤقت المحدد.
موتر ثابت <طفو>
إنشاء شكل (طويل [] ، بيانات FloatBuffer)
قم بإنشاء Float Tensor ببيانات من المخزن المؤقت المحدد.
ثابت <T> موتر <T>
إنشاء (كائن كائن ، فئة <T> نوع)
ينشئ Tensor من كائن Java.
نوع البيانات
نوع البيانات ()
DataType للعناصر المخزنة في Tensor.
مزدوج
ضعف القيمة ()
ترجع القيمة في موتر Double عددي.
<U> موتر <U>
توقع (فئة <U> نوع)
إرجاع كائن Tensor هذا من النوع Tensor<U> .
يطفو
floatValue ()
ترجع القيمة في موتر Float قياسي.
int
intValue ()
ترجع القيمة في موتر Integer .
طويل
longValue ()
ترجع القيمة في موتر Long قياسي.
int
عدد بايت ()
إرجاع حجم بيانات الموتر بالبايت.
int
numDimensions ()
إرجاع عدد الأبعاد (يشار إليها أحيانا باسم رتبة ) من التنسور.
int
عدد ()
إرجاع عدد العناصر في طريقة عرض مسطحة (1-D) للموتر.
طويل[]
شكل ()
ترجع شكل Tensor ، أي أحجام كل بعد.
خيط
toString ()
إرجاع سلسلة تصف نوع وشكل الموتر.
فارغ
الكتابة إلى (LongBuffer dst)
اكتب بيانات الموتر Long في المخزن المؤقت المحدد.
فارغ
الكتابة إلى (DoubleBuffer التوقيت الصيفي )
اكتب بيانات الموتر Double في المخزن المؤقت المحدد.
فارغ
الكتابة إلى (التوقيت الصيفي الدولي IntBuffer)
اكتب بيانات موتر Integer في المخزن المؤقت المحدد.
فارغ
الكتابة إلى (بايت بوفير التوقيت الصيفي)
اكتب بيانات الموتر في المخزن المؤقت المحدد.
فارغ
writeTo (FloatBuffer dst)
اكتب بيانات موتر Float في المخزن المؤقت المحدد.

الطرق الموروثة

الطرق العامة

booleanValue منطقية الجمهور ()

ترجع القيمة في موتر Boolean عددي.

رميات
غير الشرعيين استثناء حجة إذا كان Tensor لا يمثل عددًا منطقيًا.

البايت العام [] بايت Value ()

ترجع القيمة في موتر String عددية.

رميات
غير الشرعيين استثناء حجة إذا كان Tensor لا يمثل عددًا منطقيًا.

إغلاق الفراغ العام ()

تحرير الموارد المرتبطة Tensor.

تحذير: يجب استدعاء هذا لجميع الموترات التي لم يتم إنتاجها من خلال عملية حثيثة وإلا سيتم تسريب الذاكرة.

لم يعد كائن Tensor قابلاً للاستخدام بعد عمليات الإرجاع close .

نسخة عامة من U (U dst)

نسخ محتويات الموتر إلى dst وإرجاع dst .

بالنسبة إلى الموترات غير العددية ، تقوم هذه الطريقة بنسخ محتويات الموتر الأساسي إلى مصفوفة Java. بالنسبة إلى bytesValue() العددية ، استخدم واحدًا من bytesValue() أو floatValue() أو doubleValue() أو intValue() أو longValue() أو booleanValue() بدلاً من ذلك. يجب أن يكون نوع وشكل dst متوافقين مع الموتر. على سبيل المثال:

int matrix[2][2] = { {1,2,{3,4} };
 try(Tensor t = Tensor.create(matrix)) {
   // Succeeds and prints "3"
   int[][] copy = new int[2][2];
   System.out.println(t.copyTo(copy)[1][0]);

   // Throws IllegalArgumentException since the shape of dst does not match the shape of t.
   int[][] dst = new int[4][1];
   t.copyTo(dst);
 }
 }

رميات
غير الشرعيين استثناء حجة إذا كان الموتر عددًا أو إذا كان dst غير متوافق مع الموتر (على سبيل المثال ، أنواع البيانات أو الأشكال غير المتطابقة).

موتر عام ثابت <؟> إنشاء (كائن كائن)

ينشئ موترًا من كائن يتم فحص صنفه لمعرفة نوع البيانات الأساسي الذي يجب أن يكون.

رميات
غير الشرعيين استثناء حجة إذا كان obj غير متوافق مع نظام نوع TensorFlow.

موتر عام ثابت <T> إنشاء (فئة <T> نوع ، شكل [] طويل ، بيانات ByteBuffer)

قم بإنشاء Tensor من أي نوع باستخدام البيانات من المخزن المؤقت المحدد.

ينشئ Tensor بالشكل المقدم من أي نوع حيث تم تشفير data الموتر في data وفقًا لمواصفات TensorFlow C API .

المعلمات
يكتب نوع عنصر الموتر ، يتم تمثيله ككائن فئة.
شكل شكل الموتر.
البيانات مخزن مؤقت يحتوي على بيانات الموتر.
رميات
غير الشرعيين استثناء حجة إذا كان نوع بيانات الموتر أو الشكل غير متوافق مع المخزن المؤقت

Tensor العام الثابت <Double> إنشاء (شكل [] طويل ، بيانات DoubleBuffer)

إنشاء Double Tensor مع البيانات من المخزن المؤقت المحدد.

ينشئ Tensor بالشكل المحدد عن طريق نسخ العناصر من المخزن المؤقت (بدءًا من موضعه الحالي) في الموتر. على سبيل المثال ، إذا كان shape = {2,3 } (والذي يمثل مصفوفة 2 × 3) ، فيجب أن يحتوي المخزن المؤقت على 6 عناصر متبقية ، والتي سيتم استهلاكها بهذه الطريقة.

المعلمات
شكل شكل الموتر.
البيانات مخزن مؤقت يحتوي على بيانات الموتر.
رميات
غير الشرعيين استثناء حجة إذا كان شكل الموتر غير متوافق مع المخزن المؤقت

موتر عام ثابت <طويل> إنشاء (شكل [] طويل ، بيانات LongBuffer)

إنشاء موتر Long مع البيانات من المخزن المؤقت المحدد.

ينشئ Tensor بالشكل المحدد عن طريق نسخ العناصر من المخزن المؤقت (بدءًا من موضعه الحالي) في الموتر. على سبيل المثال ، إذا كان shape = {2,3 } (والذي يمثل مصفوفة 2 × 3) ، فيجب أن يحتوي المخزن المؤقت على 6 عناصر متبقية ، والتي سيتم استهلاكها بهذه الطريقة.

المعلمات
شكل شكل الموتر.
البيانات مخزن مؤقت يحتوي على بيانات الموتر.
رميات
غير الشرعيين استثناء حجة إذا كان شكل الموتر غير متوافق مع المخزن المؤقت

Tensor العام الثابت <Integer> إنشاء (شكل [] طويل ، بيانات IntBuffer)

إنشاء موتر Integer مع البيانات من المخزن المؤقت المحدد.

ينشئ Tensor بالشكل المحدد عن طريق نسخ العناصر من المخزن المؤقت (بدءًا من موضعه الحالي) في الموتر. على سبيل المثال ، إذا كان shape = {2,3 } (والذي يمثل مصفوفة 2 × 3) ، فيجب أن يحتوي المخزن المؤقت على 6 عناصر متبقية ، والتي سيتم استهلاكها بهذه الطريقة.

المعلمات
شكل شكل الموتر.
البيانات مخزن مؤقت يحتوي على بيانات الموتر.
رميات
غير الشرعيين استثناء حجة إذا كان شكل الموتر غير متوافق مع المخزن المؤقت

Tensor العام الثابت <Float> إنشاء (شكل [] طويل ، بيانات FloatBuffer)

قم بإنشاء Float Tensor ببيانات من المخزن المؤقت المحدد.

ينشئ Tensor بالشكل المحدد عن طريق نسخ العناصر من المخزن المؤقت (بدءًا من موضعه الحالي) في الموتر. على سبيل المثال ، إذا كان shape = {2,3 } (والذي يمثل مصفوفة 2 × 3) ، فيجب أن يحتوي المخزن المؤقت على 6 عناصر متبقية ، والتي سيتم استهلاكها بهذه الطريقة.

المعلمات
شكل شكل الموتر.
البيانات مخزن مؤقت يحتوي على بيانات الموتر.
رميات
غير الشرعيين استثناء حجة إذا كان شكل الموتر غير متوافق مع المخزن المؤقت

إنشاء موتر ثابت عام <T> (كائن كائن ، فئة <T> نوع)

ينشئ Tensor من كائن Java.

Tensor هو مصفوفة متعددة الأبعاد من العناصر لمجموعة محدودة من الأنواع. لا يمكن تحويل جميع كائنات Java إلى Tensor . على وجه الخصوص ، يجب أن تكون الوسيطة obj إما بدائية (عائم ، مزدوج ، int ، طويل ، منطقي ، بايت) أو مصفوفة متعددة الأبعاد لأحد تلك العناصر الأولية. يحدد type الوسيطة كيفية تفسير الوسيطة الأولى كنوع TensorFlow. على سبيل المثال:

// Valid: A 64-bit integer scalar.
 Tensor<Long> s = Tensor.create(42L, Long.class);

 // Valid: A 3x2 matrix of floats.
 float[][] matrix = new float[3][2];
 Tensor<Float> m = Tensor.create(matrix, Float.class);

 // Invalid: Will throw an IllegalArgumentException as an arbitrary Object
 // does not fit into the TensorFlow type system.
 Tensor<?> o = Tensor.create(new Object())

 // Invalid: Will throw an IllegalArgumentException since there are
 // a differing number of elements in each row of this 2-D array.
 int[][] twoD = new int[2][];
 twoD[0] = new int[1];
 twoD[1] = new int[2];
 Tensor<Integer> x = Tensor.create(twoD, Integer.class);
 
الموترات على شكل String هي مصفوفات متعددة الأبعاد من متواليات البايت العشوائية ، لذلك يمكن تهيئتها من مصفوفات عناصر byte[] . على سبيل المثال:
// Valid: A String tensor.
 Tensor<String> s = Tensor.create(new byte[]{1, 2, 3, String.class);

 // Java Strings will need to be encoded into a byte-sequence.
 String mystring = "foo";
 Tensor s = Tensor.create(mystring.getBytes("UTF-8"), String.class);

 // Valid: Matrix of String tensors.
 // Each element might have a different length.
 byte[][][] matrix = new byte[2][2][];
 matrix[0][0] = "this".getBytes("UTF-8");
 matrix[0][1] = "is".getBytes("UTF-8");
 matrix[1][0] = "a".getBytes("UTF-8");
 matrix[1][1] = "matrix".getBytes("UTF-8");
 Tensor m = Tensor.create(matrix, String.class);
 }

المعلمات
الهدف الكائن المراد تحويله إلى Tensor<T> . لاحظ أنه لا يتم فحص ما إذا كان متوافقًا مع النوع T بواسطة نظام النوع. لإنشاء موترات آمنة من النوع ، استخدم Tensors .
يكتب كائن الفئة الذي يمثل النوع T.
رميات
غير الشرعيين استثناء حجة إذا كان obj غير متوافق مع نظام نوع TensorFlow.

الجمهور نوع البيانات نوع البيانات ()

DataType للعناصر المخزنة في Tensor.

مزدوج عام مزدوج Value ()

ترجع القيمة في موتر Double عددي.

رميات
غير الشرعيين استثناء حجة إذا كان Tensor لا يمثل عددًا مزدوجًا.

توقع موتر عام <U> (فئة <U> نوع)

إرجاع كائن Tensor هذا من النوع Tensor<U> . هذه الطريقة مفيدة عند إعطاء قيمة من النوع Tensor<?> .

المعلمات
يكتب أي مصفوفة (غير خالية) من النوع الصحيح.
رميات
غير الشرعيين استثناء حجة إذا كان نوع البيانات الفعلي لهذا الكائن لا يتطابق مع النوع U

تعويم العام floatValue ()

ترجع القيمة في موتر Float قياسي.

رميات
غير الشرعيين استثناء حجة إذا كان Tensor لا يمثل عددًا عائمًا.

intValue العام ()

ترجع القيمة في موتر Integer .

رميات
غير الشرعيين استثناء حجة إذا كان الموتر لا يمثل عددًا صحيحًا.

طويل عام طويل Value ()

ترجع القيمة في موتر Long قياسي.

رميات
غير الشرعيين استثناء حجة إذا كان Tensor لا يمثل عددًا طويلًا.

عدد البايتات العامة ()

إرجاع حجم بيانات الموتر بالبايت.

العدد العام للأبعاد ()

إرجاع عدد الأبعاد (يشار إليها أحيانا باسم رتبة ) من التنسور.

ستكون 0 للعددي ، 1 للمتجه ، 2 لمصفوفة ، 3 للموتر ثلاثي الأبعاد ، إلخ.

عدد العناصر العامة ()

إرجاع عدد العناصر في طريقة عرض مسطحة (1-D) للموتر.

شكل عام طويل [] ()

ترجع شكل Tensor ، أي أحجام كل بُعد.

عائدات
  • مصفوفة يكون فيها العنصر i هو حجم البعد i من الموتر.

جمهور سلسلة toString ()

إرجاع سلسلة تصف نوع وشكل الموتر.

الكتابة إلى الفراغ العام (LongBuffer dst)

اكتب بيانات الموتر Long في المخزن المؤقت المحدد.

نسخ عناصر numElements() إلى المخزن المؤقت.

المعلمات
dst الوجهة العازلة
رميات
BufferOverflowException إذا لم تكن هناك مساحة كافية في المخزن المؤقت المعطى للبيانات في هذا الموتر
غير الشرعيين استثناء حجة إذا كان نوع بيانات الموتر ليس Long

الكتابة العامة باطلة إلى (DoubleBuffer dst)

اكتب بيانات الموتر Double في المخزن المؤقت المحدد.

نسخ عناصر numElements() إلى المخزن المؤقت.

المعلمات
dst الوجهة العازلة
رميات
BufferOverflowException إذا لم تكن هناك مساحة كافية في المخزن المؤقت المعطى للبيانات في هذا الموتر
غير الشرعيين استثناء حجة إذا لم يكن نوع بيانات الموتر Double

الكتابة العامة باطلة إلى (IntBuffer dst)

اكتب بيانات موتر Integer في المخزن المؤقت المحدد.

نسخ عناصر numElements() إلى المخزن المؤقت.

المعلمات
dst الوجهة العازلة
رميات
BufferOverflowException إذا لم تكن هناك مساحة كافية في المخزن المؤقت المعطى للبيانات في هذا الموتر
غير الشرعيين استثناء حجة إذا لم يكن نوع بيانات الموتر عددًا Integer

الكتابة إلى الفراغ العام (ByteBuffer dst)

اكتب بيانات الموتر في المخزن المؤقت المحدد.

ينسخ numBytes() بايت إلى المخزن المؤقت بترتيب البايت الأصلي للأنواع البدائية.

المعلمات
dst الوجهة العازلة
رميات
BufferOverflowException إذا لم تكن هناك مساحة كافية في المخزن المؤقت المعطى للبيانات في هذا الموتر

الكتابة إلى الفراغ العام (FloatBuffer dst)

اكتب بيانات موتر Float في المخزن المؤقت المحدد.

نسخ عناصر numElements() إلى المخزن المؤقت.

المعلمات
dst الوجهة العازلة
رميات
BufferOverflowException إذا لم تكن هناك مساحة كافية في المخزن المؤقت المعطى للبيانات في هذا الموتر
غير الشرعيين استثناء حجة إذا كان نوع بيانات الموتر غير Float