מערך רב מימדי שהוקלד באופן סטטי שרכיביו הם מהסוג שתואר על ידי 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) צור טנסור מכל סוג עם נתונים מהמאגר הנתון. |
טנסור סטטי <כפול> | |
טנסור סטטי <ארוך> | |
טנסור סטטי <שלם> | |
טנסור סטטי <Float> | |
סטטי <T> טנסור <T> | ליצור (אובייקט אובייקט, סוג Class <T>) יוצר טנסור מאובייקט Java. |
סוג מידע | |
לְהַכפִּיל | doubleValue () מחזיר את הערך בטנזור Double סקלרי. |
<U> טנסור <U> | מצפה (סוג Class <U>) מחזיר אובייקט Tensor זה עם סוג Tensor<U> . |
לָצוּף | floatValue () מחזיר את הערך בטנזור Float סקלרי. |
int | |
ארוך | |
int | מספר בתים () מחזירה את הגודל, בתים, של נתוני הטנסור. |
int | numDimensions () מחזיר את מספר הממדים (המכונים לפעמים דרגה ) של הטנסור. |
int | מספר אלמנטים () מחזיר את מספר האלמנטים בתצוגה שטוחה (1-D) של הטנסור. |
ארוך[] | |
חוּט | toString () מחזיר מחרוזת המתארת את סוג הצורה של הצורה. |
בָּטֵל | |
בָּטֵל | |
בָּטֵל | |
בָּטֵל | writeTo (ByteBuffer dst) כתוב את נתוני הטנסור למאגר הנתון. |
בָּטֵל |
שיטות תורשתיות
שיטות ציבוריות
בוליאני ציבורי בוליאני ערך ()
מחזיר את הערך בטנזור 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 | אם צורת הטנסור אינה תואמת למאגר |
---|
טנסור סטטי ציבורי <Integer> ליצור (צורה [] ארוכה, נתוני 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"; 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 , השתמש Tensors . |
---|---|
סוּג | אובייקט הכיתה המייצג את סוג T. |
זורק
IllegalArgumentException | אם obj אינו תואם למערכת מסוג TensorFlow. |
---|
כפול ציבורי כפול ערך ()
מחזיר את הערך בטנזור Double
סקלרי.
זורק
IllegalArgumentException | אם Tensor אינו מייצג סקלר כפול. |
---|
צפוי לצפייה <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)
writeTo החלל הציבורי (DST DoubleBuffer)
writeTo החלל הציבורי (DST IntBuffer)
writeTo החלל הציבורי (ByteBuffer DST)
כתוב את נתוני הטנסור למאגר הנתון.
מעתיק בתים numBytes()
למאגר בסדר בתים numBytes()
לסוגים פרימיטיביים.
פרמטרים
דסט | חיץ היעד |
---|
זורק
BufferOverflowException | אם אין מספיק מקום במאגר הנתון לנתונים בטנזור זה |
---|