Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Revision history [back]

The short answer is no. At least the ScheduleRuleset object that makes most of our schedules doesn't support holidays, and there isn't a way in OpenStudio store holidays. Eventually we need two things.

  1. Something like a summer and winter design day profile, but it would be a holiday/special day profile.
  2. The ability to store holidays in OpenStudio.

What can you do today? I see two options if you want to include holidays, neither one is very pretty:

Mimicking holidays with ScheduleRuleset.

  1. Create a measure that takes as input a list of dates for the hear that you want to be used as holidays.
  2. This would loop through all schedules and grab the first rule that applies to Sunday and would make a copy of that rule for each holiday date you defied in the measure. You can't do it all in one rule because the rule can only take a date range, and not something like (1/1,1/19,5/25 ...)
  3. You don't want to do this as "Apply Measures" now as it will clutter/mess up your schedules. You really want to keep it in your workflow and apply just at run-time.
  4. If you wanted to you could make an unused rule that gets used instead of Sunday if for some reason the holiday wasn't like a Sunday.

Using Compact Schedules

  1. Import compact schedules into your model. Ideally they will be edited as needed ahead of time since you can't edit them in the OpenStudio application, alhtough if you had ot you can edit them in the SketchUp Plugin.

  2. You need to tell EnergyPlus what holidays are. There are two options. Option "A" is to set the "Use Weather File Holidays and Special Days" field of the OS:RunPeriod object to yes. You would need to do this in an OpenStudio measure since the GUI doesn't expose this field. Option "B" is to write an EnergyPlus to manually add the specific holidays you want instead of relying on the weather file.

    Warning: If you enable holidays and you also still use some ScheduleRuleset objects in your model there might be un-expected consequences, so I wouldn't recommend a hybrid of these two solutions.

The short answer is no. At least the ScheduleRuleset object that makes most of our schedules doesn't support holidays, and there isn't a way in OpenStudio store holidays. Eventually we need two things.

  1. Something like a summer and winter design day profile, but it would be a holiday/special day profile.
  2. The ability to store holidays in OpenStudio.

What can you do today? I see two options if you want to include holidays, neither one is very pretty:

Mimicking holidays with ScheduleRuleset.

  1. Create a measure that takes as input a list of dates for the hear year that you want to be used as holidays.
  2. This would loop through all schedules and grab the first rule that applies to Sunday and would make a copy of that rule for each holiday date you defied in the measure. You can't do it all in one rule because the rule can only take a date range, and not something like (1/1,1/19,5/25 ...)
  3. You don't want to do this as "Apply Measures" now as it will clutter/mess up your schedules. You really want to keep it in your workflow and apply just at run-time.
  4. If you wanted to you could make an unused rule that gets used instead of Sunday if for some reason the holiday wasn't like a Sunday.

Using Compact Schedules

  1. Import compact schedules into your model. Ideally they will be edited as needed ahead of time since you can't edit them in the OpenStudio application, alhtough although if you had ot to you can edit them in the SketchUp Plugin.

  2. You need to tell EnergyPlus what holidays are. There are two options. Option "A" is to set the "Use Weather File Holidays and Special Days" field of the OS:RunPeriod object to yes. You would need to do this in an OpenStudio measure since the GUI doesn't expose this field. Option "B" is to write an EnergyPlus to manually add the specific holidays you want instead of relying on the weather file.

    Warning: If you enable holidays and you also still use some ScheduleRuleset objects in your model there might be un-expected consequences, so I wouldn't recommend a hybrid of these two solutions.

The short answer is no. At least the ScheduleRuleset object that makes most of our schedules doesn't support holidays, and there isn't a way in OpenStudio store holidays. Eventually we need two things.

  1. Something like a summer and winter design day profile, but it would be a holiday/special day profile.
  2. The ability to store holidays in OpenStudio.

What can you do today? I see two options if you want to include holidays, neither one is very pretty:

Mimicking holidays with ScheduleRuleset.ScheduleRuleset

  1. Create a measure that takes as input a list of dates for the year that you want to be used as holidays.
  2. This would loop through all schedules and grab the first rule that applies to Sunday and would make a copy of that rule for each holiday date you defied in the measure. You can't do it all in one rule because the rule can only take a date range, and not something like (1/1,1/19,5/25 ...)
  3. You don't want to do this as "Apply Measures" now as it will clutter/mess up your schedules. You really want to keep it in your workflow and apply just at run-time.
  4. If you wanted to you could make an unused rule that gets used instead of Sunday if for some reason the holiday wasn't like a Sunday.

Using Compact Schedules

  1. Import compact schedules into your model. Ideally they will be edited as needed ahead of time since you can't edit them in the OpenStudio application, although if you had to you can edit them in the SketchUp Plugin.

  2. You need to tell EnergyPlus what holidays are. There are two options. Option "A" is to set the "Use Weather File Holidays and Special Days" field of the OS:RunPeriod object to yes. You would need to do this in an OpenStudio measure since the GUI doesn't expose this field. Option "B" is to write an EnergyPlus to manually add the specific holidays you want instead of relying on the weather file.

    Warning: If you enable holidays and you also still use some ScheduleRuleset objects in your model there might be un-expected consequences, so I wouldn't recommend a hybrid of these two solutions.I seem to recall that the default profile was being used where a holiday was defined.

The short answer is no. At least the ScheduleRuleset object that makes most of our schedules doesn't support holidays, and there isn't a way in OpenStudio store holidays. Eventually we need two things.

  1. Something like a summer and winter design day profile, but it would be a holiday/special day profile.
  2. The ability to store holidays in OpenStudio.

What can you do today? I see two options if you want to include holidays, neither one is very pretty:

Mimicking holidays with ScheduleRuleset

  1. Create a measure that takes as input a list of dates for the year that you want to be used as holidays.
  2. This would loop through all schedules and grab the first rule that applies to Sunday and would make a copy of that rule for each holiday date you defied in the measure. You can't do it all in one rule because the rule can only take a date range, and not something like (1/1,1/19,5/25 ...)
  3. You don't want to do this as "Apply Measures" now as it will clutter/mess up your schedules. You really want to keep it in your workflow and apply just at run-time.
  4. If you wanted to you could make an unused rule that gets used instead of Sunday if for some reason the holiday wasn't like a Sunday.

Using Compact Schedules

  1. Import compact schedules into your model. Ideally they will be edited as needed ahead of time since you can't edit them in the OpenStudio application, although if you had to you can edit them in the SketchUp Plugin.

  2. You need to tell EnergyPlus what holidays are. There are two options. Option "A" is to set the "Use Weather File Holidays and Special Days" field of the OS:RunPeriod object to yes. You would need to do this in an OpenStudio measure since the GUI doesn't expose this field. Option "B" is to write an EnergyPlus to manually add the specific holidays you want instead of relying on the weather file.

    Warning: If you enable holidays and you also still use some ScheduleRuleset objects in your model there might be un-expected consequences, so I wouldn't recommend a hybrid of these two solutions.I seem to recall that the default profile was being used where a holiday was defined.

UPDATE OpenStudio Application 1.1.0 October 2020

The OpenStudio Application now supports Holiday profiles similar to how summer and winter design days are setup https://github.com/openstudiocoalition/OpenStudioApplication/pull/60

There is a new simulation setting to use the weather file for holidays. If you want to define custom holiday dates you can alter the weather file or can write a measure using RunPeriodControlSpecialDays

The short answer is no. At least the ScheduleRuleset object that makes most of our schedules doesn't support holidays, and there isn't a way in OpenStudio store holidays. Eventually we need two things.

  1. Something like a summer and winter design day profile, but it would be a holiday/special day profile.
  2. The ability to store holidays in OpenStudio.

What can you do today? I see two options if you want to include holidays, neither one is very pretty:

Mimicking holidays with ScheduleRuleset

  1. Create a measure that takes as input a list of dates for the year that you want to be used as holidays.
  2. This would loop through all schedules and grab the first rule that applies to Sunday and would make a copy of that rule for each holiday date you defied in the measure. You can't do it all in one rule because the rule can only take a date range, and not something like (1/1,1/19,5/25 ...)
  3. You don't want to do this as "Apply Measures" now as it will clutter/mess up your schedules. You really want to keep it in your workflow and apply just at run-time.
  4. If you wanted to you could make an unused rule that gets used instead of Sunday if for some reason the holiday wasn't like a Sunday.

Using Compact Schedules

  1. Import compact schedules into your model. Ideally they will be edited as needed ahead of time since you can't edit them in the OpenStudio application, although if you had to you can edit them in the SketchUp Plugin.

  2. You need to tell EnergyPlus what holidays are. There are two options. Option "A" is to set the "Use Weather File Holidays and Special Days" field of the OS:RunPeriod object to yes. You would need to do this in an OpenStudio measure since the GUI doesn't expose this field. Option "B" is to write an EnergyPlus to manually add the specific holidays you want instead of relying on the weather file.

    Warning: If you enable holidays and you also still use some ScheduleRuleset objects in your model there might be un-expected consequences, so I wouldn't recommend a hybrid of these two solutions.I seem to recall that the default profile was being used where a holiday was defined.


UPDATE OpenStudio Application 1.1.0 October 2020

The OpenStudio Application now supports Holiday profiles similar to how summer and winter design days are setup https://github.com/openstudiocoalition/OpenStudioApplication/pull/60

There is a new simulation setting to use the weather file for holidays. If you want to define custom holiday dates you can alter the weather file or can write a measure using RunPeriodControlSpecialDays