Schedule:File relative paths

resources/model/OpenStudio.idd

@@ -5104,13 +5104,18 @@ OS:Schedule:File,
        \key 20
        \key 30
        \key 60
-  A7 ; \field Adjust Schedule for Daylight Savings
+  A7,  \field Adjust Schedule for Daylight Savings
        \note "No" means do not include Daylight Savings Time in the schedule, instead, use the schedule directly from the Schedule:File csv (default)
        \note "Yes" means include Daylight Savings Time to the schedule
        \type choice
        \key Yes
        \key No
        \default Yes
+  A8;  \field Translate File Name
+       \type choice
+       \default No
+       \key Yes
+       \key No
 
 \group OpenStudio Geometry
 

src/energyplus/ForwardTranslator/ForwardTranslateScheduleFile.cpp

@@ -41,16 +41,21 @@ namespace energyplus {
       }
     }
 
-    path filePath = modelObject.externalFile().filePath();
-    if (!exists(filePath)) {
-      LOG(Warn, "Cannot find file \"" << filePath << "\"");
+    path fileName;
+    if (modelObject.translateFileName()) {
+      fileName = toPath(modelObject.externalFile().fileName());
     } else {
-      // make the path correct for this system
-      filePath = system_complete(filePath);
+      fileName = modelObject.externalFile().filePath();
+      if (!exists(fileName)) {
+        LOG(Warn, "Cannot find file \"" << fileName << "\"");
+      } else {
+        // make the path correct for this system
+        fileName = system_complete(fileName);
+      }
     }
 
     // DLM: this path is going to be in the temp dir, might want to fix it up when saving model temp dir
-    idfObject.setString(openstudio::Schedule_FileFields::FileName, toString(filePath));
+    idfObject.setString(openstudio::Schedule_FileFields::FileName, toString(fileName));
 
     idfObject.setInt(openstudio::Schedule_FileFields::ColumnNumber, modelObject.columnNumber());
     idfObject.setInt(openstudio::Schedule_FileFields::RowstoSkipatTop, modelObject.rowstoSkipatTop());

src/energyplus/Test/ScheduleInterval_GTest.cpp

@@ -20,13 +20,18 @@
 #include "../../model/ScheduleFixedInterval_Impl.hpp"
 #include "../../model/ScheduleVariableInterval.hpp"
 #include "../../model/ScheduleVariableInterval_Impl.hpp"
+#include "../../model/ExternalFile.hpp"
+#include "../../model/ExternalFile_Impl.hpp"
 #include "../../model/ScheduleFile.hpp"
 #include "../../model/ScheduleFile_Impl.hpp"
 #include "../../model/YearDescription.hpp"
 #include "../../model/YearDescription_Impl.hpp"
 
 #include <utilities/idd/IddEnums.hxx>
 
+#include "../../utilities/core/PathHelpers.hpp"
+#include <resources.hxx>
+
 #include <boost/regex.hpp>
 
 #include <sstream>
@@ -1850,3 +1855,141 @@ TEST_F(EnergyPlusFixture, DISABLED_ForwardTranslator_ScheduleVariableInterval_Da
   // check that there were XX untils
   //EXPECT_EQ(864, numUntils);
 }
+
+TEST_F(EnergyPlusFixture, ScheduleFileRelativePath) {
+  // ScheduleFile(external_file(/abs/path))
+  {
+    Model model;
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ExternalFile>().size());
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ScheduleFile>().size());
+
+    path p = resourcesPath() / toPath("model/schedulefile.csv");
+    EXPECT_FALSE(p.is_relative());
+
+    boost::optional<ExternalFile> external_file = ExternalFile::getExternalFile(model, openstudio::toString(p));
+    ASSERT_TRUE(external_file);
+    ScheduleFile schedule(*external_file);
+    EXPECT_TRUE(schedule.setTranslateFileName(true));
+    EXPECT_TRUE(schedule.translateFileName());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ScheduleFile>().size());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ExternalFile>().size());
+    ExternalFile externalfile = schedule.externalFile();
+    EXPECT_EQ(1u, externalfile.scheduleFiles().size());
+    EXPECT_EQ(openstudio::toString(p.filename()), externalfile.fileName());
+    EXPECT_TRUE(toPath(externalfile.fileName()).is_relative());
+    EXPECT_FALSE(externalfile.filePath().is_relative());
+    EXPECT_NE(toPath(externalfile.fileName()), externalfile.filePath());
+
+    ForwardTranslator ft;
+    Workspace workspace = ft.translateModel(model);
+
+    std::vector<WorkspaceObject> objects = workspace.getObjectsByType(IddObjectType::Schedule_File);
+    ASSERT_EQ(1u, objects.size());
+
+    boost::optional<std::string> fileName = objects[0].getString(2);  // File Name
+    ASSERT_TRUE(fileName);
+    EXPECT_TRUE(toPath(fileName.get()).is_relative());  // rel path
+    EXPECT_NE(externalfile.filePath(), fileName.get());
+  }
+
+  // ScheduleFile(external_file(/rel/path))
+  {
+    Model model;
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ExternalFile>().size());
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ScheduleFile>().size());
+
+    path p = toPath("../../../resources/model/schedulefile.csv");
+    EXPECT_TRUE(p.is_relative());
+
+    boost::optional<ExternalFile> external_file = ExternalFile::getExternalFile(model, openstudio::toString(p));
+    ASSERT_TRUE(external_file);
+    ScheduleFile schedule(*external_file);
+    EXPECT_TRUE(schedule.setTranslateFileName(true));
+    EXPECT_TRUE(schedule.translateFileName());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ScheduleFile>().size());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ExternalFile>().size());
+    ExternalFile externalfile = schedule.externalFile();
+    EXPECT_EQ(1u, externalfile.scheduleFiles().size());
+    EXPECT_EQ(openstudio::toString(p.filename()), externalfile.fileName());
+    EXPECT_TRUE(toPath(externalfile.fileName()).is_relative());
+    EXPECT_FALSE(externalfile.filePath().is_relative());
+    EXPECT_NE(toPath(externalfile.fileName()), externalfile.filePath());
+
+    ForwardTranslator ft;
+    Workspace workspace = ft.translateModel(model);
+
+    std::vector<WorkspaceObject> objects = workspace.getObjectsByType(IddObjectType::Schedule_File);
+    ASSERT_EQ(1u, objects.size());
+
+    boost::optional<std::string> fileName = objects[0].getString(2);  // File Name
+    ASSERT_TRUE(fileName);
+    EXPECT_TRUE(toPath(fileName.get()).is_relative());  // rel path
+    EXPECT_NE(externalfile.filePath(), fileName.get());
+  }
+
+  // ScheduleFile(model, /abs/path)
+  {
+    Model model;
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ExternalFile>().size());
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ScheduleFile>().size());
+
+    path p = resourcesPath() / toPath("model/schedulefile.csv");
+    EXPECT_FALSE(p.is_relative());
+
+    ScheduleFile schedule(model, openstudio::toString(p));
+    EXPECT_TRUE(schedule.setTranslateFileName(true));
+    EXPECT_TRUE(schedule.translateFileName());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ScheduleFile>().size());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ExternalFile>().size());
+    ExternalFile externalfile = schedule.externalFile();
+    EXPECT_EQ(1u, externalfile.scheduleFiles().size());
+    EXPECT_EQ(openstudio::toString(p), externalfile.fileName());
+    EXPECT_FALSE(toPath(externalfile.fileName()).is_relative());
+    EXPECT_FALSE(externalfile.filePath().is_relative());
+    EXPECT_EQ(toPath(externalfile.fileName()), externalfile.filePath());
+
+    ForwardTranslator ft;
+    Workspace workspace = ft.translateModel(model);
+
+    std::vector<WorkspaceObject> objects = workspace.getObjectsByType(IddObjectType::Schedule_File);
+    ASSERT_EQ(1u, objects.size());
+
+    boost::optional<std::string> fileName = objects[0].getString(2);  // File Name
+    ASSERT_TRUE(fileName);
+    EXPECT_FALSE(toPath(fileName.get()).is_relative());  // abs path
+    EXPECT_EQ(externalfile.filePath(), fileName.get());
+  }
+
+  // ScheduleFile(model, /rel/path)
+  {
+    Model model;
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ExternalFile>().size());
+    EXPECT_EQ(0u, model.getConcreteModelObjects<ScheduleFile>().size());
+
+    path p = toPath("../../../resources/model/schedulefile.csv");
+    EXPECT_TRUE(p.is_relative());
+
+    ScheduleFile schedule(model, openstudio::toString(p));
+    EXPECT_TRUE(schedule.setTranslateFileName(true));
+    EXPECT_TRUE(schedule.translateFileName());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ScheduleFile>().size());
+    EXPECT_EQ(1u, model.getConcreteModelObjects<ExternalFile>().size());
+    ExternalFile externalfile = schedule.externalFile();
+    EXPECT_EQ(1u, externalfile.scheduleFiles().size());
+    EXPECT_EQ(openstudio::toString(p), externalfile.fileName());
+    EXPECT_TRUE(toPath(externalfile.fileName()).is_relative());
+    EXPECT_TRUE(externalfile.filePath().is_relative());
+    EXPECT_EQ(toPath(externalfile.fileName()), externalfile.filePath());
+
+    ForwardTranslator ft;
+    Workspace workspace = ft.translateModel(model);
+
+    std::vector<WorkspaceObject> objects = workspace.getObjectsByType(IddObjectType::Schedule_File);
+    ASSERT_EQ(1u, objects.size());
+
+    boost::optional<std::string> fileName = objects[0].getString(2);  // File Name
+    ASSERT_TRUE(fileName);
+    EXPECT_TRUE(toPath(fileName.get()).is_relative());  // rel path
+    EXPECT_EQ(externalfile.filePath(), fileName.get());
+  }
+}

src/model/ScheduleFile.cpp

@@ -233,6 +233,16 @@ namespace model {
       return csvFile;
     }
 
+    bool ScheduleFile_Impl::translateFileName() const {
+      boost::optional<std::string> value = getString(OS_Schedule_FileFields::TranslateFileName, true);
+      OS_ASSERT(value);
+      return openstudio::istringEqual(value.get(), "Yes");
+    }
+
+    bool ScheduleFile_Impl::isTranslateFileNameDefaulted() const {
+      return isEmpty(OS_Schedule_FileFields::TranslateFileName);
+    }
+
     /* FIXME!
   openstudio::TimeSeries ScheduleFile_Impl::timeSeries(unsigned columnIndex) const
   {
@@ -376,6 +386,22 @@ namespace model {
     }*/
     }
 
+    bool ScheduleFile_Impl::setTranslateFileName(bool translateFileName) {
+      bool result = false;
+      if (translateFileName) {
+        result = setString(OS_Schedule_FileFields::TranslateFileName, "Yes");
+      } else {
+        result = setString(OS_Schedule_FileFields::TranslateFileName, "No");
+      }
+      OS_ASSERT(result);
+      return result;
+    }
+
+    void ScheduleFile_Impl::resetTranslateFileName() {
+      const bool result = setString(OS_Schedule_FileFields::TranslateFileName, "");
+      OS_ASSERT(result);
+    }
+
   }  // namespace detail
 
   ScheduleFile::ScheduleFile(const ExternalFile& externalfile, int column, int rowsToSkip)
@@ -477,6 +503,14 @@ namespace model {
     return getImpl<detail::ScheduleFile_Impl>()->csvFile();
   }
 
+  bool ScheduleFile::translateFileName() const {
+    return getImpl<detail::ScheduleFile_Impl>()->translateFileName();
+  }
+
+  bool ScheduleFile::isTranslateFileNameDefaulted() const {
+    return getImpl<detail::ScheduleFile_Impl>()->isTranslateFileNameDefaulted();
+  }
+
   /* FIXME!
 openstudio::TimeSeries ScheduleFile::timeSeries(unsigned columnIndex) const {
   return getImpl<detail::ScheduleFile_Impl>()->timeSeries(columnIndex);
@@ -551,6 +585,14 @@ unsigned ScheduleFile::addTimeSeries(const openstudio::TimeSeries& timeSeries) {
     getImpl<detail::ScheduleFile_Impl>()->resetAdjustScheduleforDaylightSavings();
   }
 
+  bool ScheduleFile::setTranslateFileName(bool translateFileName) {
+    return getImpl<detail::ScheduleFile_Impl>()->setTranslateFileName(translateFileName);
+  }
+
+  void ScheduleFile::resetTranslateFileName() {
+    getImpl<detail::ScheduleFile_Impl>()->resetTranslateFileName();
+  }
+
   /// @cond
   ScheduleFile::ScheduleFile(std::shared_ptr<detail::ScheduleFile_Impl> impl) : ScheduleInterval(std::move(impl)) {}
   /// @endcond

src/model/ScheduleFile.hpp

@@ -86,6 +86,10 @@ namespace model {
 
     boost::optional<CSVFile> csvFile() const;
 
+    bool translateFileName() const;
+
+    bool isTranslateFileNameDefaulted() const;
+
     //@}
     /** @name Setters */
     //@{
@@ -120,6 +124,10 @@ namespace model {
 
     /* FIXME! unsigned addTimeSeries(const openstudio::TimeSeries& timeSeries); */
 
+    bool setTranslateFileName(bool translateFileName);
+
+    void resetTranslateFileName();
+
     //@}
     /** @name Other */
     //@{

src/model/ScheduleFile_Impl.hpp

@@ -88,6 +88,10 @@ namespace model {
 
       boost::optional<CSVFile> csvFile() const;
 
+      bool translateFileName() const;
+
+      bool isTranslateFileNameDefaulted() const;
+
       //@}
       /** @name Setters */
       //@{
@@ -121,6 +125,10 @@ namespace model {
       // ensure that this object does not contain the date 2/29
       virtual void ensureNoLeapDays() override;
 
+      bool setTranslateFileName(bool translateFileName);
+
+      void resetTranslateFileName();
+
       //@}
       /** @name Other */
       //@{

src/model/test/ScheduleInterval_GTest.cpp

@@ -320,6 +320,15 @@ TEST_F(ModelFixture, ScheduleFile) {
   schedule3.resetAdjustScheduleforDaylightSavings();
   EXPECT_TRUE(schedule3.isAdjustScheduleforDaylightSavingsDefaulted());
 
+  EXPECT_FALSE(schedule3.translateFileName());
+  EXPECT_TRUE(schedule3.isTranslateFileNameDefaulted());
+  EXPECT_TRUE(schedule3.setTranslateFileName(true));
+  EXPECT_TRUE(schedule3.translateFileName());
+  EXPECT_FALSE(schedule3.isTranslateFileNameDefaulted());
+  schedule3.resetTranslateFileName();
+  EXPECT_FALSE(schedule3.translateFileName());
+  EXPECT_TRUE(schedule3.isTranslateFileNameDefaulted());
+
   // shouldn't create a new object
   boost::optional<ExternalFile> externalfile2 = ExternalFile::getExternalFile(model, openstudio::toString(p));
   ASSERT_TRUE(externalfile2);