Feat 195 cf lim

[Ethan-Russell]

Added AnnualCapacityFactorLimit mod, which gives the ability to set the upper or lower bound for the annual capacity for each generator within a set of generators.

The only feature this is missing is the ability to limit the capacity factor of a set of generators all at once. @sallyrobson or @DanShawhan do you know of any need to do this? I am happy to add it. I see that ability exists in MATLAB E4ST, but is not being used by our standard set of inputs.

• closes Make AnnualCapacityFactorLimit #195

[github-actions]

Benchmark result

Judge result

Benchmark Report for /home/runner/work/E4ST.jl/E4ST.jl

Job Properties

• Time of benchmarks:
  • Target: 23 Aug 2023 - 14:26
  • Baseline: 23 Aug 2023 - 14:29
• Package commits:
  • Target: 77449b
  • Baseline: 5d1d0a
• Julia commits:
  • Target: e4ee48
  • Baseline: e4ee48
• Julia command flags:
  • Target: None
  • Baseline: None
• Environment variables:
  • Target: None
  • Baseline: None

Results

A ratio greater than 1.0 denotes a possible regression (marked with ❌), while a ratio less
than 1.0 denotes a possible improvement (marked with ✅). Only significant results - results
that indicate possible regressions or improvements - are shown below (thus, an empty table means that all
benchmark results remained invariant between builds).

ID	time ratio	memory ratio
["get_generator"]	1.06 (5%) ❌	1.00 (1%)
["run_e4st"]	0.00 (5%) ✅	0.02 (1%) ✅
["setup_model"]	1.09 (5%) ❌	1.00 (1%)

Benchmark Group List

Here's a list of all the benchmark groups executed by this job:

• []

Julia versioninfo

Target

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz: 
              speed         user         nice          sys         idle          irq
       #1  2793 MHz       2373 s          0 s        193 s       3022 s          0 s
       #2  2793 MHz       4260 s          0 s        244 s       1088 s          0 s
  Memory: 6.7694854736328125 GB (4741.07421875 MB free)
  Uptime: 566.42 sec
  Load Avg:  1.02  1.08  0.65
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, icelake-server)
  Threads: 1 on 2 virtual cores

Baseline

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz: 
              speed         user         nice          sys         idle          irq
       #1  2793 MHz       2979 s          0 s        218 s       4181 s          0 s
       #2  2793 MHz       5427 s          0 s        264 s       1693 s          0 s
  Memory: 6.7694854736328125 GB (4726.30859375 MB free)
  Uptime: 745.74 sec
  Load Avg:  1.0  1.05  0.73
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, icelake-server)
  Threads: 1 on 2 virtual cores

---

Target result

Benchmark Report for /home/runner/work/E4ST.jl/E4ST.jl

Job Properties

• Time of benchmark: 23 Aug 2023 - 14:26
• Package commit: 77449b
• Julia commit: e4ee48
• Julia command flags: None
• Environment variables: None

Results

Below is a table of this job's results, obtained by running the benchmarks.
The values listed in the ID column have the structure [parent_group, child_group, ..., key], and can be used to
index into the BaseBenchmarks suite to retrieve the corresponding benchmarks.
The percentages accompanying time and memory values in the below table are noise tolerances. The "true"
time/memory value for a given benchmark is expected to fall within this percentage of the reported value.
An empty cell means that the value was zero.

ID	time	GC time	memory	allocations
["get_af"]	98.822 ns (5%)		32 bytes (1%)	2
["get_generator"]	52.303 ns (5%)		48 bytes (1%)	1
["get_plnom"]	123.973 ns (5%)		48 bytes (1%)	3
["read_data"]	40.725 ms (5%)		10.00 MiB (1%)	340881
["run_e4st"]	234.231 ms (5%)	8.672 ms	106.53 MiB (1%)	617451
["setup_model"]	1.711 s (5%)	595.686 ms	990.89 MiB (1%)	13400314

Benchmark Group List

Here's a list of all the benchmark groups executed by this job:

• []

Julia versioninfo

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz: 
              speed         user         nice          sys         idle          irq
       #1  2793 MHz       2373 s          0 s        193 s       3022 s          0 s
       #2  2793 MHz       4260 s          0 s        244 s       1088 s          0 s
  Memory: 6.7694854736328125 GB (4741.07421875 MB free)
  Uptime: 566.42 sec
  Load Avg:  1.02  1.08  0.65
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, icelake-server)
  Threads: 1 on 2 virtual cores

---

Baseline result

Benchmark Report for /home/runner/work/E4ST.jl/E4ST.jl

Job Properties

• Time of benchmark: 23 Aug 2023 - 14:29
• Package commit: 5d1d0a
• Julia commit: e4ee48
• Julia command flags: None
• Environment variables: None

Results

Below is a table of this job's results, obtained by running the benchmarks.
The values listed in the ID column have the structure [parent_group, child_group, ..., key], and can be used to
index into the BaseBenchmarks suite to retrieve the corresponding benchmarks.
The percentages accompanying time and memory values in the below table are noise tolerances. The "true"
time/memory value for a given benchmark is expected to fall within this percentage of the reported value.
An empty cell means that the value was zero.

ID	time	GC time	memory	allocations
["get_af"]	99.176 ns (5%)		32 bytes (1%)	2
["get_generator"]	49.437 ns (5%)		48 bytes (1%)	1
["get_plnom"]	123.834 ns (5%)		48 bytes (1%)	3
["read_data"]	40.046 ms (5%)		9.99 MiB (1%)	340634
["run_e4st"]	71.142 s (5%)	3.000 s	5.15 GiB (1%)	78425580
["setup_model"]	1.575 s (5%)	500.078 ms	990.89 MiB (1%)	13400314

Benchmark Group List

Here's a list of all the benchmark groups executed by this job:

• []

Julia versioninfo

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz: 
              speed         user         nice          sys         idle          irq
       #1  2793 MHz       2979 s          0 s        218 s       4181 s          0 s
       #2  2793 MHz       5427 s          0 s        264 s       1693 s          0 s
  Memory: 6.7694854736328125 GB (4726.30859375 MB free)
  Uptime: 745.74 sec
  Load Avg:  1.0  1.05  0.73
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, icelake-server)
  Threads: 1 on 2 virtual cores

---

Runtime information

Runtime Info
BLAS #threads	1
BLAS.vendor()	lbt
Sys.CPU_THREADS	2

lscpu output:

Architecture:                    x86_64
CPU op-mode(s):                  32-bit, 64-bit
Address sizes:                   46 bits physical, 48 bits virtual
Byte Order:                      Little Endian
CPU(s):                          2
On-line CPU(s) list:             0,1
Vendor ID:                       GenuineIntel
Model name:                      Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz
CPU family:                      6
Model:                           106
Thread(s) per core:              1
Core(s) per socket:              2
Socket(s):                       1
Stepping:                        6
BogoMIPS:                        5586.87
Flags:                           fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ss ht syscall nx pdpe1gb rdtscp lm constant_tsc rep_good nopl xtopology cpuid pni pclmulqdq ssse3 fma cx16 pcid sse4_1 sse4_2 movbe popcnt aes xsave avx f16c rdrand hypervisor lahf_lm abm 3dnowprefetch invpcid_single pti fsgsbase bmi1 hle avx2 smep bmi2 erms invpcid rtm avx512f avx512dq rdseed adx smap clflushopt avx512cd avx512bw avx512vl xsaveopt xsavec xsaves md_clear
Hypervisor vendor:               Microsoft
Virtualization type:             full
L1d cache:                       96 KiB (2 instances)
L1i cache:                       64 KiB (2 instances)
L2 cache:                        2.5 MiB (2 instances)
L3 cache:                        48 MiB (1 instance)
NUMA node(s):                    1
NUMA node0 CPU(s):               0,1
Vulnerability Itlb multihit:     KVM: Mitigation: VMX unsupported
Vulnerability L1tf:              Mitigation; PTE Inversion
Vulnerability Mds:               Mitigation; Clear CPU buffers; SMT Host state unknown
Vulnerability Meltdown:          Mitigation; PTI
Vulnerability Mmio stale data:   Vulnerable: Clear CPU buffers attempted, no microcode; SMT Host state unknown
Vulnerability Retbleed:          Not affected
Vulnerability Spec store bypass: Vulnerable
Vulnerability Spectre v1:        Mitigation; usercopy/swapgs barriers and __user pointer sanitization
Vulnerability Spectre v2:        Mitigation; Retpolines, STIBP disabled, RSB filling, PBRSB-eIBRS Not affected
Vulnerability Srbds:             Not affected
Vulnerability Tsx async abort:   Mitigation; Clear CPU buffers; SMT Host state unknown

Cpu Property	Value
Brand	Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz
Vendor	:Intel
Architecture	:UnknownIntel
Model	Family: 0x06, Model: 0x6a, Stepping: 0x06, Type: 0x00
Cores	2 physical cores, 2 logical cores (on executing CPU)
	No Hyperthreading hardware capability detected
Clock Frequencies	Not supported by CPU
Data Cache	Level 1:3 : (48, 1280, 49152) kbytes
	64 byte cache line size
Address Size	48 bits virtual, 46 bits physical
SIMD	512 bit = 64 byte max. SIMD vector size
Time Stamp Counter	TSC is accessible via rdtsc
	TSC increased at every clock cycle (non-invariant TSC)
Perf. Monitoring	Performance Monitoring Counters (PMC) are not supported
Hypervisor	Yes, Microsoft

[sallyrobson]

looks good! ready to merge when you want

[github-actions]

Benchmark result

Judge result

Benchmark Report for /home/runner/work/E4ST.jl/E4ST.jl

Job Properties

• Time of benchmarks:
  • Target: 23 Aug 2023 - 19:40
  • Baseline: 23 Aug 2023 - 19:44
• Package commits:
  • Target: 9c6e1e
  • Baseline: e0fa85
• Julia commits:
  • Target: e4ee48
  • Baseline: e4ee48
• Julia command flags:
  • Target: None
  • Baseline: None
• Environment variables:
  • Target: None
  • Baseline: None

Results

A ratio greater than 1.0 denotes a possible regression (marked with ❌), while a ratio less
than 1.0 denotes a possible improvement (marked with ✅). Only significant results - results
that indicate possible regressions or improvements - are shown below (thus, an empty table means that all
benchmark results remained invariant between builds).

ID	time ratio	memory ratio
["get_af"]	1.11 (5%) ❌	1.00 (1%)
["get_generator"]	0.84 (5%) ✅	1.00 (1%)
["run_e4st"]	0.00 (5%) ✅	0.02 (1%) ✅
["setup_model"]	1.07 (5%) ❌	1.00 (1%)

Benchmark Group List

Here's a list of all the benchmark groups executed by this job:

• []

Julia versioninfo

Target

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz: 
              speed         user         nice          sys         idle          irq
       #1  2294 MHz       2190 s          0 s        302 s       5264 s          0 s
       #2  2294 MHz       6323 s          0 s        304 s       1136 s          0 s
  Memory: 6.7694854736328125 GB (4761.4453125 MB free)
  Uptime: 785.31 sec
  Load Avg:  1.0  1.15  0.82
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, broadwell)
  Threads: 1 on 2 virtual cores

Baseline

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz: 
              speed         user         nice          sys         idle          irq
       #1  2294 MHz       2279 s          0 s        355 s       7452 s          0 s
       #2  2294 MHz       8558 s          0 s        336 s       1208 s          0 s
  Memory: 6.7694854736328125 GB (4753.48046875 MB free)
  Uptime: 1019.42 sec
  Load Avg:  1.1  1.11  0.89
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, broadwell)
  Threads: 1 on 2 virtual cores

---

Target result

Benchmark Report for /home/runner/work/E4ST.jl/E4ST.jl

Job Properties

• Time of benchmark: 23 Aug 2023 - 19:40
• Package commit: 9c6e1e
• Julia commit: e4ee48
• Julia command flags: None
• Environment variables: None

Results

Below is a table of this job's results, obtained by running the benchmarks.
The values listed in the ID column have the structure [parent_group, child_group, ..., key], and can be used to
index into the BaseBenchmarks suite to retrieve the corresponding benchmarks.
The percentages accompanying time and memory values in the below table are noise tolerances. The "true"
time/memory value for a given benchmark is expected to fall within this percentage of the reported value.
An empty cell means that the value was zero.

ID	time	GC time	memory	allocations
["get_af"]	118.887 ns (5%)		32 bytes (1%)	2
["get_generator"]	59.369 ns (5%)		48 bytes (1%)	1
["get_plnom"]	132.706 ns (5%)		48 bytes (1%)	3
["read_data"]	53.252 ms (5%)		10.00 MiB (1%)	340881
["run_e4st"]	323.051 ms (5%)	12.118 ms	106.52 MiB (1%)	617451
["setup_model"]	2.690 s (5%)	889.102 ms	990.89 MiB (1%)	13400314

Benchmark Group List

Here's a list of all the benchmark groups executed by this job:

• []

Julia versioninfo

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz: 
              speed         user         nice          sys         idle          irq
       #1  2294 MHz       2190 s          0 s        302 s       5264 s          0 s
       #2  2294 MHz       6323 s          0 s        304 s       1136 s          0 s
  Memory: 6.7694854736328125 GB (4761.4453125 MB free)
  Uptime: 785.31 sec
  Load Avg:  1.0  1.15  0.82
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, broadwell)
  Threads: 1 on 2 virtual cores

---

Baseline result

Benchmark Report for /home/runner/work/E4ST.jl/E4ST.jl

Job Properties

• Time of benchmark: 23 Aug 2023 - 19:44
• Package commit: e0fa85
• Julia commit: e4ee48
• Julia command flags: None
• Environment variables: None

Results

Below is a table of this job's results, obtained by running the benchmarks.
The values listed in the ID column have the structure [parent_group, child_group, ..., key], and can be used to
index into the BaseBenchmarks suite to retrieve the corresponding benchmarks.
The percentages accompanying time and memory values in the below table are noise tolerances. The "true"
time/memory value for a given benchmark is expected to fall within this percentage of the reported value.
An empty cell means that the value was zero.

ID	time	GC time	memory	allocations
["get_af"]	107.121 ns (5%)		32 bytes (1%)	2
["get_generator"]	70.317 ns (5%)		48 bytes (1%)	1
["get_plnom"]	136.235 ns (5%)		48 bytes (1%)	3
["read_data"]	52.148 ms (5%)		9.99 MiB (1%)	340609
["run_e4st"]	94.931 s (5%)	4.417 s	5.15 GiB (1%)	78480446
["setup_model"]	2.520 s (5%)	785.164 ms	990.89 MiB (1%)	13400314

Benchmark Group List

Here's a list of all the benchmark groups executed by this job:

• []

Julia versioninfo

Julia Version 1.9.2
Commit e4ee485e909 (2023-07-05 09:39 UTC)
Platform Info:
  OS: Linux (x86_64-linux-gnu)
      Ubuntu 22.04.3 LTS
  uname: Linux 5.15.0-1041-azure #48-Ubuntu SMP Tue Jun 20 20:34:08 UTC 2023 x86_64 x86_64
  CPU: Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz: 
              speed         user         nice          sys         idle          irq
       #1  2294 MHz       2279 s          0 s        355 s       7452 s          0 s
       #2  2294 MHz       8558 s          0 s        336 s       1208 s          0 s
  Memory: 6.7694854736328125 GB (4753.48046875 MB free)
  Uptime: 1019.42 sec
  Load Avg:  1.1  1.11  0.89
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-14.0.6 (ORCJIT, broadwell)
  Threads: 1 on 2 virtual cores

---

Runtime information

Runtime Info
BLAS #threads	1
BLAS.vendor()	lbt
Sys.CPU_THREADS	2

lscpu output:

Architecture:                    x86_64
CPU op-mode(s):                  32-bit, 64-bit
Address sizes:                   46 bits physical, 48 bits virtual
Byte Order:                      Little Endian
CPU(s):                          2
On-line CPU(s) list:             0,1
Vendor ID:                       GenuineIntel
Model name:                      Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz
CPU family:                      6
Model:                           79
Thread(s) per core:              1
Core(s) per socket:              2
Socket(s):                       1
Stepping:                        1
BogoMIPS:                        4589.37
Flags:                           fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ss ht syscall nx pdpe1gb rdtscp lm constant_tsc rep_good nopl xtopology cpuid pni pclmulqdq ssse3 fma cx16 pcid sse4_1 sse4_2 movbe popcnt aes xsave avx f16c rdrand hypervisor lahf_lm abm 3dnowprefetch invpcid_single pti fsgsbase bmi1 hle avx2 smep bmi2 erms invpcid rtm rdseed adx smap xsaveopt md_clear
Hypervisor vendor:               Microsoft
Virtualization type:             full
L1d cache:                       64 KiB (2 instances)
L1i cache:                       64 KiB (2 instances)
L2 cache:                        512 KiB (2 instances)
L3 cache:                        50 MiB (1 instance)
NUMA node(s):                    1
NUMA node0 CPU(s):               0,1
Vulnerability Itlb multihit:     KVM: Mitigation: VMX unsupported
Vulnerability L1tf:              Mitigation; PTE Inversion
Vulnerability Mds:               Mitigation; Clear CPU buffers; SMT Host state unknown
Vulnerability Meltdown:          Mitigation; PTI
Vulnerability Mmio stale data:   Vulnerable: Clear CPU buffers attempted, no microcode; SMT Host state unknown
Vulnerability Retbleed:          Not affected
Vulnerability Spec store bypass: Vulnerable
Vulnerability Spectre v1:        Mitigation; usercopy/swapgs barriers and __user pointer sanitization
Vulnerability Spectre v2:        Mitigation; Retpolines, STIBP disabled, RSB filling, PBRSB-eIBRS Not affected
Vulnerability Srbds:             Not affected
Vulnerability Tsx async abort:   Mitigation; Clear CPU buffers; SMT Host state unknown

Cpu Property	Value
Brand	Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz
Vendor	:Intel
Architecture	:Broadwell
Model	Family: 0x06, Model: 0x4f, Stepping: 0x01, Type: 0x00
Cores	2 physical cores, 2 logical cores (on executing CPU)
	No Hyperthreading hardware capability detected
Clock Frequencies	Not supported by CPU
Data Cache	Level 1:3 : (32, 256, 51200) kbytes
	64 byte cache line size
Address Size	48 bits virtual, 46 bits physical
SIMD	256 bit = 32 byte max. SIMD vector size
Time Stamp Counter	TSC is accessible via rdtsc
	TSC increased at every clock cycle (non-invariant TSC)
Perf. Monitoring	Performance Monitoring Counters (PMC) are not supported
Hypervisor	Yes, Microsoft