Interface SpallocAPI.BoardLocation
- Enclosing interface:
- SpallocAPI
public static interface SpallocAPI.BoardLocation
Describes the locations of boards in a machine. Note that instances of
this class are expected to be fully instantiated; reading from them will
not touch the database.
- Author:
- Donal Fellows
-
Method Summary
Modifier and TypeMethodDescriptionGet the location of the characteristic chip of a board.getChip()
Where is the chip of interest?getChipRelativeTo
(@NotNull ChipLocation rootChip) Get the location of this board location relative to another global location (the global location of the root chip of an allocation).getJob()
What job is the board allocated to?Where is the board logically within its machine?What machine is the board on?Where is the board physically in its machine?
-
Method Details
-
getBoardChip
ChipLocation getBoardChip()Get the location of the characteristic chip of a board. This is usually the root chip of the board.- Returns:
- chip location, in global (whole machine) coordinates
-
getChipRelativeTo
Get the location of this board location relative to another global location (the global location of the root chip of an allocation).- Parameters:
rootChip
- The global location of the root chip of an allocation that we are converting this board location to be relative to.- Returns:
- chip location, in relative (single job) coordinates
-
getMachine
String getMachine()What machine is the board on?- Returns:
- name of machine
-
getLogical
BoardCoordinates getLogical()Where is the board logically within its machine?- Returns:
- a triad location descriptor
-
getPhysical
BoardPhysicalCoordinates getPhysical()Where is the board physically in its machine?- Returns:
- a cabinet/frame/board triple
-
getChip
ChipLocation getChip()Where is the chip of interest? Usually the root chip of the board.- Returns:
- a chip location, in global (whole machine) coordinates
-
getJob
SpallocAPI.Job getJob()What job is the board allocated to? May benull
for an unallocated board.- Returns:
- a limited version of a job.
-