Difference between revisions of "V2/FAQ"

From Senfi Docs
Jump to: navigation, search
(Created page with "<h1 class="main-heading">Frequently Asked Questions</h1> This page provides help with the most common questions about Senfi # What model types are accepted by Senfi? #* Revi...")
 
 
(17 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
This page provides help with the most common questions about Senfi
 
This page provides help with the most common questions about Senfi
  
 +
=== Site ===
 +
# I do not have a 3D model of my building. How can I use Senfi?
 +
#* Senfi provides a tool to allow you to create a simple user drawn model by tracing the footprint of the building on a map with no additional charges.
 
# What model types are accepted by Senfi?
 
# What model types are accepted by Senfi?
−
#* Revit 2015 or later (.rvt)
+
#* Senfi officially supports the following model formats:
−
#* 3DS Max (.max)
+
#** Revit 2015 or later (.rvt)
−
#* .zip (.max + textures)
+
#** 3DS Max (.max)
 +
#* Other file formats that can be uploaded are:
 +
#** .dae
 +
#** .nwd
 +
#** .fbx
 +
#** .skp
 +
#** .ifc
 
# What is the maximum file size accepted for model uploads?
 
# What is the maximum file size accepted for model uploads?
 
#* File size up to 2048 MB will be accepted for model uploads.
 
#* File size up to 2048 MB will be accepted for model uploads.
Line 14: Line 23:
 
#** [https://www.designingbuildings.co.uk/wiki/PAS_1192-5:2015 https://www.designingbuildings.co.uk/wiki/PAS_1192-5:2015]
 
#** [https://www.designingbuildings.co.uk/wiki/PAS_1192-5:2015 https://www.designingbuildings.co.uk/wiki/PAS_1192-5:2015]
 
#** [https://www.corenet.gov.sg/general/bim-guides/singapore-bim-guide-version-20.aspx https://www.corenet.gov.sg/general/bim-guides/singapore-bim-guide-version-20.aspx]
 
#** [https://www.corenet.gov.sg/general/bim-guides/singapore-bim-guide-version-20.aspx https://www.corenet.gov.sg/general/bim-guides/singapore-bim-guide-version-20.aspx]
 +
# I'm trying to assign an object to a BBL, but the object still appears as unassigned even though I have done the assignment. Why is this so?
 +
#* The object may have the same duplicated object name with another object in the scene. Please ensure all objects have unique names.
 +
#* Name of sub-material used by object may have same duplicated name with another sub-material in the scene. Please ensure all sub-materials names are unique.
 +
# What happens if my building is structurally changed?
 +
#* You can update your 3D model and re-upload the model to the site as required.
 +
 +
=== Asset ===
 +
# What format should I use for the icons?
 +
#* Please use .PNG image files for the icons.
 +
# What is the recommended size for the icon image?
 +
#* The recommended image size to use for the icon image is 32px by 32px.
 +
# Is location compulsory when creating an Asset?
 +
#* It is only compulsory for Lift Assets.
 +
# Why doesn’t my Asset show up on the Digital Twin?
 +
#* A location was not added for it.
 +
# Why aren’t my Events/Alarms triggered even though they and the relevant Expression are enabled and the Expression’s result has changed?
 +
#* A location was not added for the Asset.
 +
 +
=== Video ===
 +
# Why can't I find the video streams when creating an asset even though I already have a video adapter installed?
 +
#* Video stream will not be available to assets if video adapter is not associated with the site. Please ensure the video adapter is assigned to the site the asset is in.
 +
# What video sources do Senfi support?
 +
#* Senfi is able to retrieve and display video from RTSP and ONVIF Profile S video sources. Senfi supports pulling multiple video streams from a single ONVIF Profile S device.
 +
# What are the video encodings supported?
 +
#* Senfi supports the following video encoding:
 +
#** H.264
 +
 +
=== Expressions ===
 +
# Why is my embedded node considered “undefined” in the Event description even though it exists in the Expression?
 +
#* It did not contribute to the Expression’s result.
 +
# Why do I get different results for the same Expression even though the same sequence of values has been published?
 +
#* The storing of values in the database and the evaluation of Expression run in parallel for performance reasons. Thus, the most recently published value may or may not be used for Expression evaluation. It depends on which occurred first – storing of value or Expression evaluation.
 +
# Which values are included when the “Range value of” option of the Metric Node is used?
 +
#* “START” is inclusive but “END” is exclusive.
 +
# When the Aggregate Node is used, will the calculated values be rounded before comparison?
 +
#* No. Thus, it is advisable not to use “Equal To” in the attached Compare Node, especially when the result is possibly not an Integer.
 +
# Will the Expression be re-evaluated with my currently stored values when I edit it?
 +
#* No.
 +
# What type of values can be sent to a formatted date Event input?
 +
#* Integers/Floats will be taken to be Unix timestamps (E.g. 1627634662295 or 1627634662295.6).
 +
#* Actual dates (E.g. 2021-05-06).
 +
# When filling in the Attribute Node, is the attribute name case sensitive?
 +
#* Yes. If the wrong case is used, the Expression will not be evaluated.
 +
# When I use the “Range Value of” option of the Metric Node, will my Expression still be evaluated if I have insufficient data points (E.g. Asset has 4 values when Expression looks at the last 5 values or Asset has 4 minutes of data when Expression looks at the last 5 minutes)?
 +
#* Yes. The Expression will be evaluated using the available data.
 +
 +
=== Event Input ===
 +
# Is the +/- sign compulsory when using a user-defined UTC offset when formatting dates?
 +
#* Yes. If the sign is omitted, the given argument will be interpreted as a format string and might result in weird outputs.
 +
 +
=== Publishing Measurements ===
 +
# When will published data be rejected by Senfi?
 +
#* Data with timestamp >10 minutes into the future.
 +
#* Data with timestamp >40 minutes ago with type ‘live’.
 +
#* Data with timestamp >1 month 10 minutes ago with type ‘backlog’.
 +
#* Data with missing tags/metrics.
 +
# When ‘backlog’ data is sent, will there be Expression evaluation?
 +
#* No.
 +
# Can ‘backlog’ data be used for Expression evaluation?
 +
#* Yes, when the “Range value of” option is used. However, only data with timestamp within the Measurement’s data retention period will be stored in the database and thus used.
 +
# What happens when ‘backlog’ data has timestamp outside the Measurement’s data retention period?
 +
#* Timestamp <= 1 month 10 minutes ago: Ignored and not stored in the database.
 +
#* Timestamp > 1 month 10 minutes ago: Ignored and an Error Message will be logged in the Debugger.
 +
# Must I include non-compulsory tags when publishing data?
 +
#* Yes.
 +
 +
=== Digital Twin ===
 +
# Why doesn’t my Movable Asset appear at the location I added when creating it?
 +
#* For Movable Assets, the Digital Twin ignores the location added by the user during Asset creation. Instead, the Asset’s location will be automatically computed based on its position data (X, Y, Z). When position data is empty, the Asset will be located at the Site’s origin. 
 +
# Why do my ‘backlog’ data (data with timestamp earlier than what is currently shown on the Digital Twin) not show up on the Digital Twin?
 +
#* The Digital Twin only displays the most updated data (the latest timestamp).
 +
#* There is currently no way of viewing ‘backlog’ data sent to Senfi.

Latest revision as of 15:44, 25 August 2023

Frequently Asked Questions

This page provides help with the most common questions about Senfi

Site

  1. I do not have a 3D model of my building. How can I use Senfi?
    • Senfi provides a tool to allow you to create a simple user drawn model by tracing the footprint of the building on a map with no additional charges.
  2. What model types are accepted by Senfi?
    • Senfi officially supports the following model formats:
      • Revit 2015 or later (.rvt)
      • 3DS Max (.max)
    • Other file formats that can be uploaded are:
      • .dae
      • .nwd
      • .fbx
      • .skp
      • .ifc
  3. What is the maximum file size accepted for model uploads?
    • File size up to 2048 MB will be accepted for model uploads.
  4. How to generate operational BIM file?
  5. I'm trying to assign an object to a BBL, but the object still appears as unassigned even though I have done the assignment. Why is this so?
    • The object may have the same duplicated object name with another object in the scene. Please ensure all objects have unique names.
    • Name of sub-material used by object may have same duplicated name with another sub-material in the scene. Please ensure all sub-materials names are unique.
  6. What happens if my building is structurally changed?
    • You can update your 3D model and re-upload the model to the site as required.

Asset

  1. What format should I use for the icons?
    • Please use .PNG image files for the icons.
  2. What is the recommended size for the icon image?
    • The recommended image size to use for the icon image is 32px by 32px.
  3. Is location compulsory when creating an Asset?
    • It is only compulsory for Lift Assets.
  4. Why doesn’t my Asset show up on the Digital Twin?
    • A location was not added for it.
  5. Why aren’t my Events/Alarms triggered even though they and the relevant Expression are enabled and the Expression’s result has changed?
    • A location was not added for the Asset.

Video

  1. Why can't I find the video streams when creating an asset even though I already have a video adapter installed?
    • Video stream will not be available to assets if video adapter is not associated with the site. Please ensure the video adapter is assigned to the site the asset is in.
  2. What video sources do Senfi support?
    • Senfi is able to retrieve and display video from RTSP and ONVIF Profile S video sources. Senfi supports pulling multiple video streams from a single ONVIF Profile S device.
  3. What are the video encodings supported?
    • Senfi supports the following video encoding:
      • H.264

Expressions

  1. Why is my embedded node considered “undefined” in the Event description even though it exists in the Expression?
    • It did not contribute to the Expression’s result.
  2. Why do I get different results for the same Expression even though the same sequence of values has been published?
    • The storing of values in the database and the evaluation of Expression run in parallel for performance reasons. Thus, the most recently published value may or may not be used for Expression evaluation. It depends on which occurred first – storing of value or Expression evaluation.
  3. Which values are included when the “Range value of” option of the Metric Node is used?
    • “START” is inclusive but “END” is exclusive.
  4. When the Aggregate Node is used, will the calculated values be rounded before comparison?
    • No. Thus, it is advisable not to use “Equal To” in the attached Compare Node, especially when the result is possibly not an Integer.
  5. Will the Expression be re-evaluated with my currently stored values when I edit it?
    • No.
  6. What type of values can be sent to a formatted date Event input?
    • Integers/Floats will be taken to be Unix timestamps (E.g. 1627634662295 or 1627634662295.6).
    • Actual dates (E.g. 2021-05-06).
  7. When filling in the Attribute Node, is the attribute name case sensitive?
    • Yes. If the wrong case is used, the Expression will not be evaluated.
  8. When I use the “Range Value of” option of the Metric Node, will my Expression still be evaluated if I have insufficient data points (E.g. Asset has 4 values when Expression looks at the last 5 values or Asset has 4 minutes of data when Expression looks at the last 5 minutes)?
    • Yes. The Expression will be evaluated using the available data.

Event Input

  1. Is the +/- sign compulsory when using a user-defined UTC offset when formatting dates?
    • Yes. If the sign is omitted, the given argument will be interpreted as a format string and might result in weird outputs.

Publishing Measurements

  1. When will published data be rejected by Senfi?
    • Data with timestamp >10 minutes into the future.
    • Data with timestamp >40 minutes ago with type ‘live’.
    • Data with timestamp >1 month 10 minutes ago with type ‘backlog’.
    • Data with missing tags/metrics.
  2. When ‘backlog’ data is sent, will there be Expression evaluation?
    • No.
  3. Can ‘backlog’ data be used for Expression evaluation?
    • Yes, when the “Range value of” option is used. However, only data with timestamp within the Measurement’s data retention period will be stored in the database and thus used.
  4. What happens when ‘backlog’ data has timestamp outside the Measurement’s data retention period?
    • Timestamp <= 1 month 10 minutes ago: Ignored and not stored in the database.
    • Timestamp > 1 month 10 minutes ago: Ignored and an Error Message will be logged in the Debugger.
  5. Must I include non-compulsory tags when publishing data?
    • Yes.

Digital Twin

  1. Why doesn’t my Movable Asset appear at the location I added when creating it?
    • For Movable Assets, the Digital Twin ignores the location added by the user during Asset creation. Instead, the Asset’s location will be automatically computed based on its position data (X, Y, Z). When position data is empty, the Asset will be located at the Site’s origin.
  2. Why do my ‘backlog’ data (data with timestamp earlier than what is currently shown on the Digital Twin) not show up on the Digital Twin?
    • The Digital Twin only displays the most updated data (the latest timestamp).
    • There is currently no way of viewing ‘backlog’ data sent to Senfi.
Retrieved from "https://www.senfi.io/docs/index.php?title=V2/FAQ&oldid=3871"