یک آرایه چند بعدی با تایپ ایستا که عناصر آن از نوع توصیف شده توسط T هستند.
نمونههای یک Tensor از نظر نخ ایمن نیستند .
اخطار: منابع مصرف شده توسط شی Tensor باید به صراحت با فراخوانی متد close()
زمانی که شی دیگر مورد نیاز نیست آزاد شوند. به عنوان مثال، با استفاده از یک بلوک try-with-resources:
try (Tensor t = Tensor.create(...)) {
doSomethingWith(t);
}
روش های عمومی
بولی | مقدار boolean () مقدار را در یک تانسور Boolean برمیگرداند. |
بایت[] | |
باطل | بستن () منابع مرتبط با تنسور را آزاد کنید. |
<U> U | copyTo (U dst) محتویات تانسور را در dst کپی می کند و dst را برمی گرداند. |
تانسور استاتیک <?> | ایجاد (object obj) یک تانسور از یک شی ایجاد می کند که کلاس آن بازرسی می شود تا بفهمد نوع داده اصلی باید چه باشد. |
استاتیک <T> تانسور <T> | ایجاد (نوع کلاس<T>، شکل طولانی[]، داده ByteBuffer) یک تانسور از هر نوع با داده های بافر داده شده ایجاد کنید. |
تانسور استاتیک <دوبل> | |
تانسور ساکن <طولانی> | |
تانسور ایستا <عدد صحیح> | |
تانسور استاتیک <Float> | |
استاتیک <T> تانسور <T> | ایجاد (شیء شیء، نوع کلاس<T>) یک Tensor از یک شی جاوا ایجاد می کند. |
نوع داده | |
دو برابر کردن | DoubleValue () مقدار یک تانسور Double اسکالر را برمیگرداند. |
<U> تانسور <U> | انتظار (نوع کلاس<U>) این شی Tensor را با نوع Tensor<U> . |
شناور | floatValue () مقدار یک تانسور Float اسکالر را برمیگرداند. |
بین المللی | |
طولانی | |
بین المللی | تعداد بایت () اندازه داده های تانسور را بر حسب بایت برمی گرداند. |
بین المللی | ابعاد عددی () تعداد ابعاد (گاهی اوقات به عنوان رتبه از آن یاد می شود) تانسور را برمی گرداند. |
بین المللی | numElements () تعداد عناصر موجود در نمای مسطح (1-D) تانسور را برمیگرداند. |
طولانی[] | |
رشته | toString () رشته ای را برمی گرداند که نوع و شکل تانسور را توصیف می کند. |
باطل | |
باطل | |
باطل | |
باطل | writeTo (ByteBuffer dst) داده های تانسور را در بافر داده شده بنویسید. |
باطل |
روش های ارثی
روش های عمومی
ارزش بولین عمومی ()
مقدار را در یک تانسور Boolean
برمیگرداند.
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر بولی را نشان ندهد. |
---|
بایت عمومی[] bytesValue ()
مقدار یک تانسور String
اسکالر را برمیگرداند.
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر بولی را نشان ندهد. |
---|
بسته شدن فضای خالی عمومی ()
منابع مرتبط با تنسور را آزاد کنید.
اخطار: این باید برای همه تانسورهایی که توسط یک عملیات مشتاقانه تولید نشدهاند، فراخوانی شود یا حافظه لو رفته باشد.
شی Tensor پس از بازگشت close
دیگر قابل استفاده نیست.
عمومی U copyTo (U dst)
محتویات تانسور را در dst
کپی می کند و dst
را برمی گرداند.
برای تانسورهای غیر اسکالر، این روش محتویات تانسور زیرین را در یک آرایه جاوا کپی می کند. برای تانسورهای اسکالر، از یکی از 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 |
---|
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر است یا اگر dst با تانسور سازگار نیست (مثلاً انواع داده ها یا اشکال نامتناسب). |
---|
ایجاد تانسور ایستا عمومی <?> (Object Obj)
یک تانسور از یک شی ایجاد می کند که کلاس آن بازرسی می شود تا بفهمد نوع داده اصلی باید چه باشد.
پارامترها
obj |
---|
پرتاب می کند
IllegalArgumentException | اگر obj با سیستم نوع TensorFlow سازگار نباشد. |
---|
ایجاد تانسور ایستا عمومی <T> (نوع کلاس<T>، شکل طولانی[]، داده بایت بافر)
یک تانسور از هر نوع با داده های بافر داده شده ایجاد کنید.
یک Tensor با شکل ارائه شده از هر نوع ایجاد می کند که در آن داده های تانسور مطابق با مشخصات TensorFlow C API در data
کدگذاری شده است.
پارامترها
نوع | نوع عنصر تانسور که به عنوان یک شی کلاس نمایش داده می شود. |
---|---|
شکل | شکل تانسور |
داده ها | یک بافر حاوی داده های تانسور. |
پرتاب می کند
IllegalArgumentException | اگر نوع داده یا شکل تانسور با بافر سازگار نباشد |
---|
ایجاد تانسور استاتیک عمومی <دوبل> (شکل طولانی[]، داده DoubleBuffer)
یک تانسور Double
با داده های بافر داده شده ایجاد کنید.
یک تانسور با شکل داده شده با کپی کردن عناصر از بافر (شروع از موقعیت فعلی آن) در تانسور ایجاد می کند. به عنوان مثال، اگر shape = {2,3}
(که نشان دهنده یک ماتریس 2x3 است) پس بافر باید 6 عنصر باقی مانده باشد که با این روش مصرف می شود.
پارامترها
شکل | شکل تانسور |
---|---|
داده ها | یک بافر حاوی داده های تانسور. |
پرتاب می کند
IllegalArgumentException | اگر شکل تانسور با بافر سازگار نباشد |
---|
ایجاد تانسور استاتیک عمومی <Long> (شکل طولانی[]، داده LongBuffer)
یک Long
Tensor با داده های بافر داده شده ایجاد کنید.
یک تانسور با شکل داده شده با کپی کردن عناصر از بافر (شروع از موقعیت فعلی آن) در تانسور ایجاد می کند. به عنوان مثال، اگر shape = {2,3}
(که نشان دهنده یک ماتریس 2x3 است) پس بافر باید 6 عنصر باقی مانده باشد که با این روش مصرف می شود.
پارامترها
شکل | شکل تانسور |
---|---|
داده ها | یک بافر حاوی داده های تانسور. |
پرتاب می کند
IllegalArgumentException | اگر شکل تانسور با بافر سازگار نباشد |
---|
ایجاد تانسور استاتیک عمومی <Integer> (شکل طولانی[]، داده IntBuffer)
یک تانسور Integer
با داده های بافر داده شده ایجاد کنید.
یک تانسور با شکل داده شده با کپی کردن عناصر از بافر (شروع از موقعیت فعلی آن) در تانسور ایجاد می کند. به عنوان مثال، اگر shape = {2,3}
(که نشان دهنده یک ماتریس 2x3 است) پس بافر باید 6 عنصر باقی مانده باشد که با این روش مصرف می شود.
پارامترها
شکل | شکل تانسور |
---|---|
داده ها | یک بافر حاوی داده های تانسور. |
پرتاب می کند
IllegalArgumentException | اگر شکل تانسور با بافر سازگار نباشد |
---|
ایجاد تانسور ثابت عمومی <Float> (شکل طولانی[]، داده FloatBuffer)
یک تانسور Float
با داده های بافر داده شده ایجاد کنید.
یک تانسور با شکل داده شده با کپی کردن عناصر از بافر (شروع از موقعیت فعلی آن) در تانسور ایجاد می کند. به عنوان مثال، اگر shape = {2,3}
(که نشان دهنده یک ماتریس 2x3 است) پس بافر باید 6 عنصر باقی مانده باشد که با این روش مصرف می شود.
پارامترها
شکل | شکل تانسور |
---|---|
داده ها | یک بافر حاوی داده های تانسور. |
پرتاب می کند
IllegalArgumentException | اگر شکل تانسور با بافر سازگار نباشد |
---|
ایجاد تانسور استاتیک عمومی <T> (نوع Objj، کلاس<T>)
یک Tensor از یک شی جاوا ایجاد می کند.
Tensor
یک آرایه چند بعدی از عناصر از مجموعه محدودی از انواع است. همه اشیاء جاوا را نمی توان به Tensor
تبدیل کرد. به طور خاص، آرگومان obj
باید یا اولیه باشد (float، double، int، long، boolean، byte) یا یک آرایه چند بعدی از یکی از آن موارد اولیه. 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<String> 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<String> m = Tensor.create(matrix, String.class);
پارامترها
obj | شیء برای تبدیل به Tensor<T> . توجه داشته باشید که سازگاری آن با نوع T توسط سیستم نوع بررسی نمی شود. برای ایجاد ایمن نوع تانسورها، از Tensors استفاده کنید. |
---|---|
نوع | شی کلاس نشان دهنده نوع T. |
پرتاب می کند
IllegalArgumentException | اگر obj با سیستم نوع TensorFlow سازگار نباشد. |
---|
دو برابر دو ارزش عمومی ()
مقدار یک تانسور Double
اسکالر را برمیگرداند.
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر دوگانه را نشان ندهد. |
---|
تانسور عمومی <U> انتظار (نوع کلاس<U>)
این شی Tensor را با نوع Tensor<U>
. این روش زمانی مفید است که مقداری از نوع Tensor<?>
.
پارامترها
نوع | هر آرایه (غیر تهی) از نوع صحیح. |
---|
پرتاب می کند
IllegalArgumentException | اگر نوع داده واقعی این شی با نوع U مطابقت نداشته باشد. |
---|
عمومی float floatValue ()
مقدار یک تانسور Float
اسکالر را برمیگرداند.
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر شناور را نشان ندهد. |
---|
intValue عمومی ()
مقدار یک تانسور Integer
اسکالر را برمیگرداند.
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر int را نشان ندهد. |
---|
عمومی طولانی ارزش طولانی ()
مقدار را در یک تانسور Long
اسکالر برمیگرداند.
پرتاب می کند
IllegalArgumentException | اگر تانسور یک اسکالر طولانی را نشان ندهد. |
---|
numBytes int عمومی ()
اندازه داده های تانسور را بر حسب بایت برمی گرداند.
عمومی int numDimensions ()
تعداد ابعاد (گاهی اوقات به عنوان رتبه از آن یاد می شود) تانسور را برمی گرداند.
0 برای یک اسکالر، 1 برای یک بردار، 2 برای یک ماتریس، 3 برای یک تانسور سه بعدی و غیره خواهد بود.
numElements int عمومی ()
تعداد عناصر موجود در نمای مسطح (1-D) تانسور را برمیگرداند.
شکل عمومی طولانی[] ()
شکل Tensor، یعنی اندازه های هر بعد را برمی گرداند.
برمی گرداند
- آرایه ای که در آن عنصر i به اندازه بعد i تانسور است.
رشته عمومی toString ()
رشته ای را برمی گرداند که نوع و شکل تانسور را توصیف می کند.
public void writeTo (LongBuffer dst)
public void writeTo (DoubleBuffer dst)
public void writeTo (IntBuffer dst)
public void writeTo (ByteBuffer dst)
داده های تانسور را در بافر داده شده بنویسید.
بایت های numBytes()
را به ترتیب بایت های بومی برای انواع اولیه در بافر کپی می کند.
پارامترها
dst | بافر مقصد |
---|
پرتاب می کند
BufferOverflowException | اگر فضای کافی در بافر داده شده برای داده های این تانسور وجود نداشته باشد |
---|