12.9. Sherlock Project Service- SherlockProjectService.proto

Click here to return to the main index to Sherlock's APIs.

The APIs in this section perform project level functions such as generating reports and importing ECAD files. Clicking on the active links in the table below will take you to the selected API.

Table 12.205: Index to Sherlock Project Service APIs

Method NameRequest TypeResponse TypeDescription
For display purposes, the long strings in columns two and three are broken into multiple lines. For example, the first string in column two should be interpreted as: .GenReportRequest
genReport.GenReport Request.GenReport Response streamGenerates the project report and return it via streaming.
genCCAReport.GenCCAReport Request.GenCCAReport Response streamGenerates the project CCA report and return it via streaming.
importODBArchive.ImportODB RequestReturnCodeImports an ODB++ archive.
importIPC2581 Archive.ImportIPC2581 RequestReturnCodeImports an IPC-258 archive.
importProjectZip Archive.ImportProjectZip RequestReturnCodeImports a zipped project archive -- multiple project mode.
importProjectZip ArchiveSingleMode.ImportProjectZip SingleModeRequestReturnCodeImports a zipped project archive -- single project mode.
deleteProject.DeleteProject Request.ReturnCodeDelete a project from Sherlock
addStrainMap.AddStrainMap Request.AddStrainMap ResponseAdd a strain map file to a Sherlock project.
listStrainMaps.ListStrainMaps Request.ListStrainMaps ResponseReturns a list of circuit cards and their assigned strain maps for a given Sherlock project.
listCCAs.ListCCAs Request.ListCCAs ResponseReturns a list of circuit cards, their properties, and sub-assemblies for a given Sherlock project.
addProject.AddProjectRequestReturnCodeAdd a project to Sherlock.
addCCA.AddCcaRequestReturnCodeCreates a new circuit card assembly.
listThermalMaps.ListThermalMaps Request.ListThermal MapsResponseReturns a list of thermal map files and their types for a given Sherlock project.
updateThermalMapsUpdateThermal MapRequest.UpdateThermal MapsResponseUpdate thermal map files to a Sherlock project.
addThermalMaps.AddThermal MapRequest.AddThermal MapResponseAdd a thermal map to a Sherlock project.

12.9.1. Add CCA

12.9.1.1. AddCcaRequest

Table 12.206: AddCcaRequest

FieldTypeLabelDescription
projectstring Name of the project.
CCAsCCArepeatedCCAs to add.

12.9.1.2. Example: AddCcaRequest

Proto Request Example
{
  "project": "Tutorial",
  "CCAs": [
    {
      "ccaName": "Test CCA",
      "description": "Added from GRPC",
      "defaultSolderType": "SAC305",
      "defaultStencilThickness": 0.135,
      "defaultStencilThicknessUnits": "mm",
      "defaultPartTempRise": 10.53,
      "defaultPartTempRiseUnits": "F",
      "guessPartPropertiesEnabled": false
    }
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.2. Add Project

12.9.2.1. AddProjectRequest

Request to add a project to Sherlock

Table 12.207: AddProjectRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
categorystring Project category.
descriptionstring Project description.

12.9.2.2. Example: AddProjectRequest

Proto Request Example
{
  "project": "New Project",
  "category": "Test Category",
  "description": "Test Description"
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.3. Add Strain Map

12.9.3.1. AddStrainMapRequest

Request to add strain map files to CCAs in a Sherlock project.

Table 12.208: AddStrainMapRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
strainMapFilesAddStrainMapRequest. StrainMapFilerepeatedStrain map files and associated properties to be added.

12.9.3.2. AddStrainMapRequest.StrainMapFile

FieldTypeLabelDescription
strainMapFilestring Full path to the strain map file to be added.
fileCommentstring File comment text.
headerRowCountint32 Number of rows before the column header in the file.
referenceIDColumnstring Reference ID column name.
strainColumnstring Strain column name.
strainUnitsstring Strain units used in the strain map file. Valid units: µε, ε.
ccastringrepeatedProject CCA names to add the file to.
numericFormatstring Numeric format for values.
fileTypeAddStrainMapRequest. StrainMapFile.FileType Type of the strain map file.
imageFileAddStrainMapRequest. StrainMapFile. StrainMapImageFile Image strain map file properties.

12.9.3.3. AddStrainMapRequest.StrainMapFile.StrainMapImageFile

Table 12.209: AddStrainMapRequest.StrainMapFile.StrainMapImageFile

FieldTypeLabelDescription
coordinateUnitsstring Coordinate units used for board, lengend and image boundaries.
boardBoundsAddStrainMapRequest. StrainMapFile. StrainMapImageFile. NodeCoordinaterepeatedCoordinates of the nodes which make up the board outline.
imageBoundsAddStrainMapRequest. StrainMapFile. StrainMapImageFile. ImageCoordinate Coordinates of the board bounds within the image.
legendBoundsAddStrainMapRequest. StrainMapFile. StrainMapImageFile. LegendCoordinate Coordinates of the bounds of legend within the image.
legendOrientationAddStrainMapRequest. StrainMapFile. StrainMapImageFile. LegendOrientation Specify the legend orientation.
minStraindouble Minimum strain value.
maxStraindouble Maximum strain value.
strainUnitsstring Units for minimum and maximum strain values.

12.9.3.4. AddStrainMapRequest.StrainMapFile.StrainMapImageFile.ImageCoordinate

Table 12.210: AddStrainMapRequest.StrainMapFile.StrainMapImageFile.ImageCoordinate

FieldTypeLabelDescription
imageXdouble X-coordinate of the upper left corner.
imageYdouble Y-coordinate of the upper left corner.
imageHdouble Height of the image.
imageWdouble Width of the image.

12.9.3.5. AddStrainMapRequest.StrainMapFile.StrainMapImageFile.LegendCoordinate

Table 12.211: x

FieldTypeLabelDescription
legendXdouble X-coordinate of the upper left corner.
legendYdouble Y-coordinate of the upper left corner.
legendHdouble Height of the legend.
legendWdouble Width of the legend.

12.9.3.6. AddStrainMapRequest.StrainMapFile.StrainMapImageFile.NodeCoordinate

Table 12.212: AddStrainMapRequest.StrainMapFile.StrainMapImageFile.NodeCoordinate

FieldTypeLabelDescription
vertexXdouble X-coordinate of the node.
vertexYdouble Y-coordinate of the node.

12.9.3.7. AddStrainMapRequest.StrainMapFile.FileType

Table 12.213: AddStrainMapRequest.StrainMapFile.FileType

NameNumberDescription
CSV0Csv file.
Excel1Excel file.
Image2Image file.

12.9.3.8. AddStrainMapRequest.StrainMapFile.StrainMapImageFile.LegendOrientation

Table 12.214: AddStrainMapRequest.StrainMapFile.StrainMapImageFile.LegendOrientation

NameNumberDescription
Horizontal0Horizontal legend orientation.
Vertical1Vertical legend orientation.

12.9.3.9. AddStrainMapResponse

Response from adding strain map CSV files

Table 12.215: AddStrainMapResponse

FieldTypeLabelDescription
returnCodeReturnCode Status code of response.
errorsstringrepeatedList of validation errors.

12.9.3.10. Example: Add Strain Map

Proto Request Example:

The image property dimensions were obtained from the image .properties file under the CCA _METADATA folder after aligning the layer interactively.

{
  "project": "Tutorial Project",
  "strainMapFiles": [
    {
      "strainMapFile": "v242\\sherlock\\tutorial\\StrainMaps\\StrainMap.csv",
      "fileComment": "test comment",
      "headerRowCount": 0,
      "referenceIDColumn": "SolidID",
      "strainColumn": "PCB Strain",
      "strainUnits": "µε",
      "cca": [
        "Main Board"
      ],
      "numericFormat": "English",
      "fileType": 0
    },
    {
      "strainMapFile": "v242\\sherlock\\tutorial\\StrainMaps\\TutorialStrainMap-BOT.jpg",
      "fileComment": "test comment",
      "cca": [
        "Main Board"
      ],
      "fileType": 2,
      "imageFile": {
        "coordinateUnits": "in",
        "boardBounds": [
          {
            "vertexX": -3.7464000000000004,
            "vertexY": -2.2515
          },
          {
            "vertexX": 3.746400000000001,
            "vertexY": -2.2370759615384617
          },
          {
            "vertexX": 3.746400000000001,
            "vertexY": 2.2343759615384617
          },
          {
            "vertexX": -3.7464000000000004,
            "vertexY": 2.2488
          }
        ],
        "imageBounds": {
          "imageX": -5.020737315246,
          "imageY": -2.2660262062839065,
          "imageH": 5.30825048949089,
          "imageW": 10.225039886616724
        },
        "legendBounds": {
          "legendX": -4.881167037861916,
          "legendY": 2.5084326923076925,
          "legendH": 0.33175288461538466,
          "legendW": 9.728958574610246
        },
        "legendOrientation": 0,
        "minStrain": 9.16,
        "maxStrain": 1680.1,
        "strainUnits": "µε"
      }
    }
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.4. Add Thermal Map

12.9.4.1. AddThermalMapRequest

Request to add thermal map files to a Sherlock project.

Table 12.216: AddThermalMapRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
thermalMapFilesAddThermalMapRequest. AddThermalMaprepeatedThermal map files and associated properties to be added.

12.9.4.2. AddThermalMapRequest.AddThermalMap

Table 12.217: AddThermalMapRequest.AddThermalMap

FieldTypeLabelDescription
thermalMapFilestring Full path to the thermal map file to be added.
thermalMapFilePropertiesThermalMapFile Thermal map file properties.

12.9.4.3. AddThermalMapResponse

Response from adding thermal map files.

Table 12.218: x

FieldTypeLabelDescription
returnCodeReturnCode Status code of response.
errorsstringrepeatedList of validation errors.

12.9.4.4. Example: AddThermalMap

Proto Request Example

The image property dimensions were obtained from the image .properties file under the CCA _METADATA folder after aligning the layer interactively.

{
  "project": "Tutorial Project",
  "thermalMapFiles": [
    {
      "thermalMapFile": "v242\\sherlock\\tutorial\\ThermalMaps\\Thermal Map.csv",
      "thermalMapFileProperties": {
        "fileName": "Thermal Map CSV",
        "fileType": 0,
        "fileComment": "Test Comment",
        "thermalBoardSide": 1,
        "csvExcelFile": {
          "headerRowCount": 0,
          "referenceIDColumn": "RefDes",
          "temperatureColumn": "Temp",
          "temperatureUnits": "C",
          "numericFormat": "English"
        },
        "thermalProfiles": [
          "Environmental/1 - Temp Cycle - Min"
        ],
        "cca": [
          "Main Board"
        ]
      }
    },
      {
      "thermalMapFile": "v242\\sherlock\\tutorial\\ThermalMaps\\Thermal Image.jpg",
      "thermalMapFileProperties": {
        "fileName": "Thermal Image Test",
        "fileType": 2,
        "fileComment": "test comment",
        "thermalBoardSide": 1,
        "imageFile": {
          "coordinateUnits": "in",
          "boardBounds": [
            {
              "vertexX": -3.7464,
              "vertexY": -2.2515
            },
            {
              "vertexX": 3.56139,
              "vertexY": -2.132
            },
            {
              "vertexX": 3.7464,
              "vertexY": 2.228887
            },
            {
              "vertexX": -3.5614,
              "vertexY": 2.2488
            }
          ],
          "imageBounds": {
            "imageX": -4.20314,
            "imageY": -4.44105,
            "imageH": 7.0474,
            "imageW": 9.08464157
          },
          "legendBounds": {
            "legendX": 4.17808,
            "legendY": -3.3467,
            "legendH": 4.71934,
            "legendW": 0.27751
          },
          "legendOrientation": 1,
          "minTemperature": 17,
          "minTemperatureUnits": "C",
          "maxTemperature": 90,
          "maxTemperatureUnits": "C"
        },
        "thermalProfiles": [
          "Environmental/1 - Temp Cycle - Max", "On The Road/4 - Thermal Shock - Max"
        ],
        "cca": [
          "Main Board"
        ]
      }
    }
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.5. CCA

Table 12.219: CCA

FieldTypeLabelDescription
ccaNamestring Name of the circuit card.
descriptionstringoptionalDescription of the circuit card.
defaultSolderTypestringoptionalDefault solder type.
defaultStencilThicknessdoubleoptionalDefault stencil thickness.
defaultStencilThicknessUnitsstringoptionalDefault stencil thickness units.
defaultPartTempRisedoubleoptionalDefault part temp rise.
defaultPartTempRiseUnitsstringoptionalDefault part temp rise units.
guessPartPropertiesEnabledbooloptionalWhether to enable guess part properties.

12.9.6. DeleteProjectRequest

Request for deleting project

Table 12.220: DeleteProjectRequest

FieldTypeLabelDescription
projectstring Project name of project to be deleted.

12.9.7. Generate CCA Report

12.9.7.1. GenCCAReportRequest

Request a project CCA report.

Table 12.221: GenCCAReportRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
ccastring Project CCA name.
authorstring Name of the author who generates the report.
companystring Name of author's company.

12.9.7.2. GenCCAReportResponse

Streams the project CCA report in chunks.

Table 12.222: GenCCAReportResponse

FieldTypeLabelDescription
contentbytes A chunk of the project CCA report being returned in increments.
sizeint32 Size of the chunk returned.
returnCodeReturnCode Status code of response.

12.9.7.3. Example: Generate CCA Report

Proto Request Example
{
  "project": "Tutorial Project",
  "cca": "Main Board",
  "author": "Testing",
  "company": "Ansys"
}
Python Example

For a Python example, refer to the online PySherlock Reference.

12.9.8. Request a Project Report

12.9.8.1. GenReportRequest

Request a project report.

Table 12.223: GenReportRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
authorstring Name of the author who generates the report.
companystring Name of author's company.

12.9.8.2. GenReportResponse

Streams the project report in chunks.

Table 12.224: GenReportResponse

FieldTypeLabelDescription
contentbytes A chunk of the project report being returned in increments.
sizeint32 Size of the chunk returned.
returnCodeReturnCode Status code of response.

12.9.8.3. Example: Generate Report

Proto Request Example
{
  "project": "Tutorial Project",
  "author": "Testing",
  "company": "Ansys"
}
Python Example

For a Python example, refer to the online PySherlock Reference.

12.9.9. Import IPC2581

12.9.9.1. ImportIPC2581Request

Request for importing an IPC-2581 archive

Table 12.225: ImportIPC2581Request

FieldTypeLabelDescription
archiveFilestring Full path to the IPC-2581 arhicve file to be imported.
projectstring Sherlock project name. If empty, the filename will be used for the project name.
ccaNamestring Project CCA name. If empty, the filename will be used for the CCA name.
includeOtherLayersbool Option to include other layers.
guessPartPropertiesbool Option to guess part properties.
polylineSimplificationbool Option to enable polyline simplification.
polylineTolerancedouble Polyline simplification tolerance.
polylineTolerancestring Polyline simplification tolerance units.

12.9.9.2. Examples: Import IPC 2581

Proto Request Example
{
  "archiveFile": "IPC2581.cvg",
  "project": "IPC",
  "ccaName": "CCA",
  "includeOtherLayers": true,
  "guessPartProperties": true,
  "polylineSimplification": true,
  "polylineTolerance": 0.05,
  "polylineToleranceUnits": "mm"
}
Python Example

For a Python example, refer to the online PySherlock Reference.

12.9.10. Import ODB

12.9.10.1. ImportODBRequest

Request for importing an ODB++ archive.

Table 12.226: ImportODBRequest

FieldTypeLabelDescription
archiveFilestring Full path to the ODB++ archive file to be imported.
projectstring Sherlock project name. If empty, the filename will be used for the project name.
ccaNamestring Project CCA name. If empty, the filename will be used for the CCA name.
processLayerThicknessbool Option to assign stackup thickness.
includeOtherLayersbool Option to include other layers.
processCutoutFilebool Option to process cutouts.
guessPartPropertiesbool Option to guess part properties.
imsStackupbool Option to generate IMS stackup.
polylineSimplificationbool Option to enable polyline simplification.
polylineTolerancebool Polyline simplification tolerance.
polylineToleranceUnitsstring Polyline simplification tolerance units.

12.9.10.2. Examples: Import ODB

Proto Request Example
{
  "archiveFile": "v242\\sherlock\\tutorial\\ODB++ Tutorial.tgz",
  "project": "ODB Import",
  "ccaName": "ODB CCA",
  "processLayerThickness": true,
  "includeOtherLayers": true,
  "processCutoutFile": true,
  "guessPartProperties": true,
  "imsStackup": true,
  "polylineSimplification": true,
  "polylineTolerance": 0.1,
  "polylineToleranceUnits": "mm"
}
Python Example

For a Python example, refer to the online PySherlock Reference.

12.9.11. Import Project Zip Archive

12.9.11.1. ImportProjectZipRequest

Request for importing a .zip project archive when Sherlock is in multiple project mode.

Table 12.227: importProjectZipArchive

FieldTypeLabelDescription
projectstring Sherlock project name.
categorystring Sherlock project category.
archiveFilestring Full path to the .zip archive file containing the project data.

12.9.11.2. Example: importProjectZipArchive

Proto Request Example
{
  "project": "Tutorial Project Import",
  "category": "Test Category",
  "archiveFile": "v242\\sherlock\\tutorial\\Tutorial Project.zip"
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.12. Import Project Zip- Single Mode

12.9.12.1. ImportProjectZipSingleModeRequest

Request for importing a .zip project archive when Sherlock is in single project mode.

Table 12.228: ImportProjectZipSingleModeRequest

FieldTypeLabelDescription
projZipRequestImportProjectZipRequest Encapsulates project name, category and full path to project .zip archive.
destFileDirstring Directory in which the Sherlock project folder will be created.

12.9.12.2. Example: ImportProjectZipSingleModeRequest

Proto Request Example
{
  "projZipRequest": {
    "project": "Tutorial Project Import",
    "category": "Test Category",
    "archiveFile": "v242\\sherlock\\tutorial\\Tutorial Project.zip"
  },
  "destFileDir": "C:\\Users\\Documents\\Sherlock\\projects"
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.13. List CCAs

12.9.13.1. ListCCAsRequest

Request to list CCA's and sub-assembly CCA's for a project

Table 12.229: ListCCAsRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
ccastringrepeatedOptional project CCA names to return.

12.9.13.2. ListCCAsResponse.CCA

FieldTypeLabelDescription
ccaNamestring Name of the CCA.
subAssembliesListCCAsResponse.CCArepeatedSub-assemblies assigned to the CCA.

12.9.13.3. Example: List CCAs

Proto Request Example:
{
  "project": "Tutorial Project",
  "cca": [
    "Main Board"
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.14. List Strain Maps

12.9.14.1. ListStrainMapsRequest

Request to list CCA strain maps for a project

Table 12.230: ListStrainMapsRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
ccastringrepeatedOptional project CCA names to list strain maps for.

12.9.14.2. ListStrainMapsResponse

Lists the strain maps assigned to the project CCA's.

Table 12.231: ListStrainMapsResponse

FieldTypeLabelDescription
For display purposes, some strings in the column two are broken into multiple lines and should be read as continous. For example, the string in column two should be interpreted as: ListStrainMapsResponse.CcaStrainMap
returnCodeReturnCode Status code of response.
errorsstringrepeatedList of errors encountered.
ccaStrainMapsListStrainMaps Response.CcaStrainMaprepeatedCCA strain maps assigned to the project.

12.9.14.3. ListStrainMapsResponse.CcaStrainMap

Table 12.232: ListStrainMapsResponse.CcaStrainMap

FieldTypeLabelDescription
ccaNamestring Name of the CCA.
strainMapsstringrepeatedStrain map names assigned to the CCA.

12.9.14.4. Example: List Strain Maps

Proto Request Example:
{
  "project": "Tutorial Project",
  "cca": [
    "Main Board"
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.15. List Thermal Maps

12.9.15.1. ListThermalMapsRequest

Request to list Thermal map files and their types for a project.

Table 12.233: ListThermalMapsRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
ccastringrepeatedOptional project CCA names to list thermal maps for.

12.9.15.2. ListThermalMapsResponse

Represents the thermal map files and their types for a Sherlock project.

Table 12.234: ListThermalMapsResponse

FieldTypeLabelDescription
returnCode.ReturnCode Status code of response.
errorsstringrepeatedList of errors encountered.
ccaThermalMapsListThermalMapsResponse. CcaThermalMaprepeatedCCA thermal map files assigned to the project.

12.9.15.3. ListThermalMapsResponse.CcaThermalMap

Table 12.235: ListThermalMapsResponse.CcaThermalMap

FieldTypeLabelDescription
ccaNamestring Project CCA name.
thermalMapsListThermalMapsResponse. CcaThermalMap.ThermalMaprepeatedThermal map files assigned to the CCA.

12.9.15.4. ListThermalMapsResponse.CcaThermalMap.ThermalMap

Table 12.236: ListThermalMapsResponse.CcaThermalMap.ThermalMap

FieldTypeLabelDescription
fileNamestring Name of the Thermal Map file.
fileTypestring Thermal map file type. Possible values are: "Icepak Thermal Map (TMAP)", "Thermal Map (CSV)", "Thermal Map (Excel)", "Thermal Map (Image)".

12.9.15.5. Example: listThermalMaps

Proto Request Example
{
  "project": "Tutorial Project",
  "cca": [
    "Main Board"
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.

12.9.16. Thermal Map File

12.9.16.1. ThermalMapFile

Table 12.237: ThermalMapFile

FieldTypeLabelDescription
fileNamestring The name of the thermal file to update.
fileTypeThermalMapFile.FileType Thermal file type.
fileCommentstring Include a comment or description for the file.
thermalBoardSideThermalMapFile. ThermalBoardSide Thermal board side.
csvExcelFileThermalMapFile. CsvExcelFile Used to CSV and Excel files.
imageFileThermalMapFile. ImageFile Used to add properties to Image files.
thermalProfilesstringrepeatedList of thermal profiles.
ccastringrepeatedProject CCA Name.

12.9.16.2. ThermalMapFile.CsvExcelFile

Table 12.238: ThermalMapFile.CsvExcelFile

FieldTypeLabelDescription
headerRowCountint32 Number of rows before the column header in the file.
referenceIDColumnstring Reference ID column.
temperatureColumnstring Temperature column.
temperatureUnitsstring Units for temperature values.
numericFormatstring Numeric format for values.

12.9.16.3. ThermalMapFile.ImageFile

Table 12.239: ThermalMapFile.ImageFile

FieldTypeLabelDescription
coordinateUnitsstring Coordinate units used for board, lengend and image boundaries.
boardBoundsThermalMapFile.ImageFile. NodeCoordinaterepeatedCoordinates of the nodes which make up the board outline.
imageBoundsThermalMapFile.ImageFile. ImageCoordinate Coordinates of the board bounds within the image.
legendBoundsThermalMapFile.ImageFile. LegendCoordinate Coordinates of the bounds of legend within the image.
legendOrientationThermalMapFile.ImageFile. LegendOrientation Specify the legend orientation.
minTemperaturedouble Minimum temperature value.
minTemperatureUnitsstring Units for minimum temperature value.
maxTemperaturedouble Maximum temperature value.
maxTemperatureUnitsstring Units for maximum temperature value.

12.9.16.4. ThermalMapFile.ImageFile.ImageCoordinate

Table 12.240: ThermalMapFile.ImageFile.ImageCoordinate

FieldTypeLabelDescription
imageXdouble X-coordinate of the upper left corner.
imageYdouble Y-coordinate of the upper left corner.
imageHdouble Height of the image.
imageWdouble Width of the image.

12.9.16.5. ThermalMapFile.ImageFile.LegendCoordinate

Table 12.241: ThermalMapFile.ImageFile.LegendCoordinate

FieldTypeLabelDescription
legendXdouble X-coordinate of the upper left corner.
legendYdouble Y-coordinate of the upper left corner.
legendHdouble Height of the legend.
legendWdouble Width of the legend.

12.9.16.6. ThermalMapFile.ImageFile.NodeCoordinate

Table 12.242: ThermalMapFile.ImageFile.NodeCoordinate

FieldTypeLabelDescription
vertexXdouble X-coordinate of the node.
vertexYdouble Y-coordinate of the node.

12.9.17. Thermal Map File

12.9.17.1. ThermalMapFile.FileType

Table 12.243: ThermalMapFile.FileType

NameNumberDescription
CSV0Csv file.
Excel1Excel file.
Image2Image file.
TMAP3Icepack file.

12.9.17.2. ThermalMapFile.ImageFile.LegendOrientation

Table 12.244: ThermalMapFile.ImageFile.LegendOrientation

NameNumberDescription
Horizontal0Horizontal legend orientation.
Vertical1Vertical legend orientation.

12.9.17.3. ThermalMapFile.ThermalBoardSide

Table 12.245: ThermalMapFile.ThermalBoardSide

NameNumberDescription
Bottom0Bottom side of the board.
Both1Both sides of the board.
Top2Top side of the board.

12.9.18. Update Thermal Map

12.9.18.1. UpdateThermalMapRequest

Request to update thermal map files to a Sherlock project.

Table 12.246: UpdateThermalMapRequest

FieldTypeLabelDescription
projectstring Sherlock project name.
thermalMapFilesThermalMapFilerepeatedThermal Map files.

12.9.18.2. UpdateThermalMapsResponse

Table 12.247: UpdateThermalMapsResponse

FieldTypeLabelDescription
returnCode.ReturnCode Status code of response.
errorsstringrepeatedList of validation errors.

12.9.18.3. Example: updateThermalMaps

Proto Request Example
{
  "project": "Tutorial Project",
  "thermalMapFiles": [
    {
      "fileName": "Thermal Map CSV",
      "fileType": 0,
      "fileComment": "Test Comment Updated",
      "thermalBoardSide": 0,
      "csvExcelFile": {
        "headerRowCount": 0,
        "referenceIDColumn": "RefDes",
        "temperatureColumn": "Temp",
        "temperatureUnits": "C",
        "numericFormat": "English"
      },
      "thermalProfiles": [
        "On The Road/4 - Thermal Shock - Min", "On The Road/4 - Thermal Shock - Max"
      ],
      "cca": [
        "Main Board"
      ]
    },
    {
      "fileName": "Thermal Image Test",
      "fileType": 2,
      "fileComment": "Test Comment Updated",
      "thermalBoardSide": 0,
      "imageFile": {
        "coordinateUnits": "in",
        "boardBounds": [
          {
            "vertexX": -3.7464,
            "vertexY": -2.2515
          },
          {
            "vertexX": 3.56139,
            "vertexY": -2.132
          },
          {
            "vertexX": 3.7464,
            "vertexY": 2.228887
          },
          {
            "vertexX": -3.5614,
            "vertexY": 2.2488
          }
        ],
        "imageBounds": {
          "imageX": -4.20314,
          "imageY": -4.44105,
          "imageH": 7.0474,
          "imageW": 9.08464157
        },
        "legendBounds": {
          "legendX": 4.17808,
          "legendY": -3.3467,
          "legendH": 4.71934,
          "legendW": 0.27751
        },
        "legendOrientation": 1,
        "minTemperature": 17,
        "minTemperatureUnits": "C",
        "maxTemperature": 90,
        "maxTemperatureUnits": "C"
      },
      "thermalProfiles": [
        "Environmental/1 - Temp Cycle - Max", "Environmental/1 - Temp Cycle - Min"
      ],
      "cca": [
        "Main Board"
      ]
    }
  ]
}
Python Example:

For a Python example, refer to the online PySherlock Reference.