אזהרה: API זו ברמה נמוכה יוסרה בגרסה עתידית של TensorFlow לאחר ההחלפה יציבה.

Tensor

כיתת גמר ציבורית Tensor

מערך רב מימדי שהוקלד באופן סטטי שרכיביו הם מהסוג שתואר על ידי T.

מקרים של טנסור אינם חוט בטוח.

אזהרה: יש לשחרר במפורש משאבים הנצרכים על ידי אובייקט Tensor על ידי הפעלת שיטת close() כאשר אין צורך יותר באובייקט. לדוגמא, שימוש בחסימת ניסיון עם משאבים:

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

שיטות ציבוריות

בוליאני
booleanValue ()
מחזיר את הערך בטנזור Boolean סקלרי.
בתים []
bytesValue ()
מחזיר את הערך בטנזור String סקלרי.
בָּטֵל
סגור ()
שחרר משאבים הקשורים לטנזור.
<U> U
copyTo (U dst)
מעתיק את תוכן הטנסור ל- dst ומחזיר את dst .
טנסור סטטי <?>
ליצור (אובייקט אובייקט)
יוצר טנסור מאובייקט שהמחלקה שלו נבדקת כדי להבין מה צריך להיות סוג הנתונים הבסיסי.
סטטי <T> טנסור <T>
ליצור (סוג Class <T>, צורה ארוכה [], נתוני ByteBuffer)
צור טנסור מכל סוג עם נתונים מהמאגר הנתון.
טנסור סטטי <כפול>
צור (צורה [] ארוכה, נתוני DoubleBuffer)
צור טנסור Double עם נתונים מהמאגר הנתון.
טנסור סטטי <ארוך>
צור (צורה [] ארוכה, נתוני LongBuffer)
צור טנסור Long עם נתונים מהמאגר הנתון.
טנסור סטטי <שלם>
צור (צורה [] ארוכה, נתוני IntBuffer)
צור טנסור Integer עם נתונים מהמאגר הנתון.
טנסור סטטי <Float>
צור (צורה [] ארוכה, נתוני FloatBuffer)
צור טנסור Float עם נתונים מהמאגר הנתון.
סטטי <T> טנסור <T>
ליצור (אובייקט אובייקט, סוג Class <T>)
יוצר טנסור מאובייקט Java.
סוג מידע
dataType ()
מחזיר את DataType של האלמנטים המאוחסנים בטנסור.
לְהַכפִּיל
doubleValue ()
מחזיר את הערך בטנזור Double סקלרי.
<U> טנסור <U>
מצפה (סוג Class <U>)
מחזיר אובייקט Tensor זה עם סוג Tensor<U> .
לָצוּף
floatValue ()
מחזיר את הערך בטנזור Float סקלרי.
int
intValue ()
מחזירה את הערך בטנזור Integer .
ארוך
longValue ()
מחזיר את הערך בסולם טנסור Long .
int
מספר בתים ()
מחזירה את הגודל, בתים, של נתוני הטנסור.
int
numDimensions ()
מחזיר את מספר הממדים (המכונים לפעמים דרגה ) של הטנסור.
int
מספר אלמנטים ()
מחזיר את מספר האלמנטים בתצוגה שטוחה (1-D) של הטנסור.
ארוך[]
צורה ()
מחזיר את הצורה של הטנסור, כלומר את הגדלים של כל מימד.
חוּט
toString ()
מחזיר מחרוזת המתארת ​​את סוג הצורה של הצורה.
בָּטֵל
writeTo (LongBuffer dst)
כתוב את הנתונים של טנסור Long לתוך המאגר הנתון.
בָּטֵל
writeTo (DoubleBuffer dst)
כתוב את הנתונים של טנסור Double למאגר הנתון.
בָּטֵל
writeTo (IntBuffer dst)
כתוב את הנתונים של טנסור Integer למאגר הנתון.
בָּטֵל
writeTo (ByteBuffer dst)
כתוב את נתוני הטנסור למאגר הנתון.
בָּטֵל
writeTo (FloatBuffer dst)
כתוב את הנתונים של טנסור Float למאגר הנתון.

שיטות תורשתיות

שיטות ציבוריות

בוליאני ציבורי בוליאני ערך ()

מחזיר את הערך בטנזור Boolean סקלרי.

זורק
IllegalArgumentException אם הטנסור אינו מייצג סקלר בוליאני.

בתים ציבוריים [] bytesValue ()

מחזיר את הערך בטנזור String סקלרי.

זורק
IllegalArgumentException אם הטנסור אינו מייצג סקלר בוליאני.

חלל ציבורי סגור ()

שחרר משאבים הקשורים לטנזור.

אזהרה: יש להפעיל את זה עבור כל הטנזרים שלא הופקו על ידי פעולה להוטה או שהזיכרון יודלף.

אובייקט Tensor כבר אינו שמיש לאחר החזרה close .

U copyTo ציבורי (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);
 }
 }

זורק
IllegalArgumentException אם הטנסור הוא סקלרי או אם dst אינו תואם לטנסור (למשל, סוגי נתונים או צורות לא תואמים).

טנסור סטטי ציבורי <?> צור (אובייקט אובייקט)

יוצר טנסור מאובייקט שהמחלקה שלו נבדקת כדי להבין מה צריך להיות סוג הנתונים הבסיסי.

זורק
IllegalArgumentException אם obj אינו תואם למערכת מסוג TensorFlow.

טנסור ציבורי סטטי ציבורי <T> ליצור (סוג Class <T>, צורה ארוכה [], נתוני ByteBuffer)

צור טנסור מכל סוג עם נתונים מהמאגר הנתון.

יוצר טנסור עם הצורה המסופקת מכל סוג בו נתוני הטנסור מקודדים data בהתאם למפרט ה- API של TensorFlow C.

פרמטרים
סוּג סוג אלמנט הטנסור, המיוצג כאובייקט מחלקתי.
צוּרָה צורת הטנסור.
נתונים חיץ המכיל את נתוני הטנסור.
זורק
IllegalArgumentException אם סוג הנתונים או הצורה של הטנסור אינם תואמים למאגר

טנסור סטטי ציבורי <כפול> ליצור (צורה [] ארוכה, נתוני DoubleBuffer)

צור טנסור Double עם נתונים מהמאגר הנתון.

יוצר טנסור עם הצורה הנתונה על ידי העתקת אלמנטים מהמאגר (החל ממצבו הנוכחי) אל הטנסור. לדוגמא, אם shape = {2,3 } (המייצגת מטריצה ​​של 2x3) אז על המאגר שיישארו 6 אלמנטים שייצרכו בשיטה זו.

פרמטרים
צוּרָה צורת הטנסור.
נתונים חיץ המכיל את נתוני הטנסור.
זורק
IllegalArgumentException אם צורת הטנסור אינה תואמת למאגר

טנסור סטטי ציבורי <Long> ליצור (צורה [] ארוכה, נתוני LongBuffer)

צור טנסור Long עם נתונים מהמאגר הנתון.

יוצר טנסור עם הצורה הנתונה על ידי העתקת אלמנטים מהמאגר (החל ממצבו הנוכחי) אל הטנסור. לדוגמא, אם shape = {2,3 } (המייצגת מטריצה ​​של 2x3) אז על המאגר שיישארו 6 אלמנטים שייצרכו בשיטה זו.

פרמטרים
צוּרָה צורת הטנסור.
נתונים חיץ המכיל את נתוני הטנסור.
זורק
IllegalArgumentException אם צורת הטנסור אינה תואמת למאגר

טנסור סטטי ציבורי <שלם> צור (צורה [] ארוכה, נתוני IntBuffer)

צור טנסור Integer עם נתונים מהמאגר הנתון.

יוצר טנסור עם הצורה הנתונה על ידי העתקת אלמנטים מהמאגר (החל ממצבו הנוכחי) אל הטנסור. לדוגמא, אם shape = {2,3 } (המייצגת מטריצה ​​של 2x3) אז על המאגר שיישארו 6 אלמנטים שייצרכו בשיטה זו.

פרמטרים
צוּרָה צורת הטנסור.
נתונים חיץ המכיל את נתוני הטנסור.
זורק
IllegalArgumentException אם צורת הטנסור אינה תואמת למאגר

טנזור סטטי ציבורי <Float> ליצור (צורה [] ארוכה, נתוני FloatBuffer)

צור טנסור Float עם נתונים מהמאגר הנתון.

יוצר טנסור עם הצורה הנתונה על ידי העתקת אלמנטים מהמאגר (החל ממצבו הנוכחי) אל הטנסור. לדוגמא, אם shape = {2,3 } (המייצגת מטריצה ​​של 2x3) אז על המאגר שיישארו 6 אלמנטים שייצרכו בשיטה זו.

פרמטרים
צוּרָה צורת הטנסור.
נתונים חיץ המכיל את נתוני הטנסור.
זורק
IllegalArgumentException אם צורת הטנסור אינה תואמת למאגר

טנסור סטטי ציבורי <T> ליצור (אובייקט אובייקט, סוג <T> Class)

יוצר טנסור מאובייקט 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 , השתמש Tensors .
סוּג אובייקט הכיתה המייצג את סוג T.
זורק
IllegalArgumentException אם obj אינו תואם למערכת מסוג TensorFlow.

DataType ציבורי dataType ()

מחזיר את DataType של האלמנטים המאוחסנים בטנסור.

כפול ציבורי כפול ערך ()

מחזיר את הערך בסולם טנסור Double .

זורק
IllegalArgumentException אם הטנסור אינו מייצג סקלר כפול.

צפוי לצפייה <U> (סוג <U> סוג)

מחזיר אובייקט Tensor זה עם סוג Tensor<U> . שיטה זו שימושית כאשר ניתן לה ערך מסוג Tensor<?> .

פרמטרים
סוּג כל מערך (שאינו אפס) מהסוג הנכון.
זורק
IllegalArgumentException אם סוג הנתונים בפועל של אובייקט זה אינו תואם את סוג U

לצוף הציבור floatValue ()

מחזיר את הערך בטנזור Float סקלרי.

זורק
IllegalArgumentException אם הטנסור אינו מייצג סקלר צף.

int intalue public ()

מחזירה את הערך בטנזור Integer .

זורק
IllegalArgumentException אם הטנסור אינו מייצג סקלר אינט.

longValue ארוכה הציבור ()

מחזיר את הערך בסולם טנסור Long .

זורק
IllegalArgumentException אם הטנסור אינו מייצג סקלר ארוך.

מספר אינטליבייטים ציבורי ()

מחזירה את הגודל, בתים, של נתוני הטנסור.

מספרים אינטימיים ציבוריים ()

מחזיר את מספר הממדים (המכונים לפעמים דרגה ) של הטנסור.

יהיה 0 לסקלר, 1 לווקטור, 2 למטריצה, 3 לטנסור תלת מימדי וכו '.

מספרים ציבוריים ()

מחזיר את מספר האלמנטים בתצוגה שטוחה (1-D) של הטנסור.

צורה ארוכה [] ציבורי ()

מחזיר את הצורה של הטנסור, כלומר את הגדלים של כל מימד.

החזרות
  • מערך שבו האלמנט ה- i הוא גודל הממד ה- I של הטנסור.

מחרוזת ציבורית toString ()

מחזיר מחרוזת המתארת ​​את סוג הצורה של הצורה.

בטל פומבי writeTo (LongBuffer dst)

כתוב את הנתונים של טנסור Long לתוך המאגר הנתון.

מעתיק אלמנטים numElements() למאגר.

פרמטרים
דסט חיץ היעד
זורק
BufferOverflowException אם אין מספיק מקום במאגר הנתון לנתונים בטנזור זה
IllegalArgumentException אם סוג הנתונים של הטנסור אינו Long

בטל פומבי writeTo (DoubleBuffer dst)

כתוב את הנתונים של טנסור Double למאגר הנתון.

מעתיק אלמנטים numElements() למאגר.

פרמטרים
דסט חיץ היעד
זורק
BufferOverflowException אם אין מספיק מקום במאגר הנתון לנתונים בטנזור זה
IllegalArgumentException אם סוג הנתונים של הטנסור אינו Double

writeTo החלל הציבורי (DST IntBuffer)

כתוב את הנתונים של טנסור Integer למאגר הנתון.

מעתיק אלמנטים numElements() למאגר.

פרמטרים
דסט חיץ היעד
זורק
BufferOverflowException אם אין מספיק מקום במאגר הנתון לנתונים בטנזור זה
IllegalArgumentException אם סוג נתוני הטנסור אינו Integer

writeTo החלל הציבורי (ByteBuffer DST)

כתוב את נתוני הטנסור למאגר הנתון.

מעתיק בתים numBytes() למאגר בסדר בתים numBytes() לסוגים פרימיטיביים.

פרמטרים
דסט חיץ היעד
זורק
BufferOverflowException אם אין מספיק מקום במאגר הנתון לנתונים בטנזור זה

בטל פומבי writeTo (FloatBuffer dst)

כתוב את הנתונים של טנסור Float למאגר הנתון.

מעתיק אלמנטים numElements() למאגר.

פרמטרים
דסט חיץ היעד
זורק
BufferOverflowException אם אין מספיק מקום במאגר הנתון לנתונים בטנזור זה
IllegalArgumentException אם סוג הנתונים של הטנזור אינו Float