مصفوفة متعددة الأبعاد مكتوبة بشكل ثابت تكون عناصرها من النوع الذي وصفه T.
مثيلات Tensor ليست آمنة للخيط.
تحذير: يجب تحرير الموارد التي يستهلكها كائن Tensor بشكل صريح عن طريق استدعاء طريقة close()
عندما لا تكون هناك حاجة إلى الكائن. على سبيل المثال ، باستخدام كتلة try-with-Resources:
try (Tensor t = Tensor.create(...)) {
doSomethingWith(t);
}
الطرق العامة
قيمة منطقية | قيمة منطقية () ترجع القيمة في موتر Boolean عددي. |
بايت [] | |
فارغ | إغلاق () تحرير الموارد المرتبطة Tensor. |
<U> يو | نسخ إلى (U dst) نسخ محتويات الموتر إلى dst وإرجاع dst . |
موتر ثابت <؟> | إنشاء (كائن كائن) ينشئ موترًا من كائن يتم فحص صنفه لمعرفة نوع البيانات الأساسي الذي يجب أن يكون. |
ثابت <T> موتر <T> | إنشاء (فئة <T> نوع ، شكل [] طويل ، بيانات ByteBuffer) قم بإنشاء Tensor من أي نوع باستخدام البيانات من المخزن المؤقت المحدد. |
موتر ثابت <مزدوج> | |
موتر ثابت <طويل> | |
موتر ثابت <Integer> | |
موتر ثابت <طفو> | |
ثابت <T> موتر <T> | إنشاء (كائن كائن ، فئة <T> نوع) ينشئ Tensor من كائن Java. |
نوع البيانات | نوع البيانات () DataType للعناصر المخزنة في Tensor. |
مزدوج | ضعف القيمة () ترجع القيمة في موتر Double عددي. |
<U> موتر <U> | توقع (فئة <U> نوع) إرجاع كائن Tensor هذا من النوع Tensor<U> . |
يطفو | floatValue () ترجع القيمة في موتر Float قياسي. |
int | |
طويل | |
int | عدد بايت () إرجاع حجم بيانات الموتر بالبايت. |
int | numDimensions () إرجاع عدد الأبعاد (يشار إليها أحيانا باسم رتبة ) من التنسور. |
int | عدد () إرجاع عدد العناصر في طريقة عرض مسطحة (1-D) للموتر. |
طويل[] | |
خيط | toString () إرجاع سلسلة تصف نوع وشكل الموتر. |
فارغ | الكتابة إلى (LongBuffer dst) اكتب بيانات الموتر Long في المخزن المؤقت المحدد. |
فارغ | |
فارغ | الكتابة إلى (التوقيت الصيفي الدولي IntBuffer) اكتب بيانات موتر Integer في المخزن المؤقت المحدد. |
فارغ | الكتابة إلى (بايت بوفير التوقيت الصيفي) اكتب بيانات الموتر في المخزن المؤقت المحدد. |
فارغ |
الطرق الموروثة
الطرق العامة
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"; Tensors = 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. |
---|
مزدوج عام مزدوج 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)
الكتابة العامة باطلة إلى (DoubleBuffer dst)
الكتابة العامة باطلة إلى (IntBuffer dst)
الكتابة إلى الفراغ العام (ByteBuffer dst)
اكتب بيانات الموتر في المخزن المؤقت المحدد.
ينسخ numBytes()
بايت إلى المخزن المؤقت بترتيب البايت الأصلي للأنواع البدائية.
المعلمات
dst | الوجهة العازلة |
---|
رميات
BufferOverflowException | إذا لم تكن هناك مساحة كافية في المخزن المؤقت المعطى للبيانات في هذا الموتر |
---|