Manipulating datasets tutorial

[kdayday]

Merged Anna's branch to NREL-Sienna/ branch

[github-actions]

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

JuliaFormatter

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 80 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 83 in 3fea206

Now using the [`set_base_voltage!`](@ref) function and a `for loop` we can update the voltage:

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 84 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 86 to 87 in 3fea206

	set_base_voltage!(i, 250.0)
	end

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 89 in 3fea206

We can see that all of the buses now have a `base_voltage` of 250.0:

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 90 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 93 in 3fea206

If we are interested in updating the `fuel` in all the thermal generators, we would use a similar approach. We begin by grabbing an iterator for all the components in [`ThermalStandard`](@ref).

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 94 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 97 to 98 in 3fea206

	Now, using the [`set_fuel!`](@ref) and a for loop, we will update the `fuel` to `NATURAL_GAS`.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 100 in 3fea206

set_fuel!(i, ThermalFuels.NATURAL_GAS)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 103 to 104 in 3fea206

	We can see that the `fuel` types for all the thermal generators has been updated.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 107 to 108 in 3fea206

	We can also use a dot operator with a specific `get_*` function and the [`get_components`](@ref) function to return a vector of parameters for multiple components:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 111 in 3fea206

Notice that the `fuel` type for all the thermal generators is returned.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 112 in 3fea206

!!! warning

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 113 to 115 in 3fea206

	Using the "dot" access to get a parameter value from a component is actively discouraged, use `get_*` functions instead. Julia syntax enables access to this data using the "dot" access, however this is discouraged for two reasons:
	1. We make no guarantees on the stability of component structure definitions. We will maintain version stability on the accessor methods.
	2. Per-unit conversions are made in the return of data from the accessor functions. (see the [per-unit](https://nrel-sienna.github.io/PowerSystems.jl/stable/explanation/per_unit/#per_unit) section for more details)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 118 to 120 in 3fea206

	We have seen how to update a single component, and all the components of a specific type, but what if we are interested in updating particular components? We can do this using filter functions. For example, let's say we are interested in updating all the `active_power` parameters of the thermal generators except `Solitude`.
	Let's start by seeing the current `active_power` parameters.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 123 to 124 in 3fea206

	Let's grab an iterator for the all the thermal generators except `Solitude` using a filter function:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 127 to 128 in 3fea206

	We can see that four [`ThermalStandard`](@ref) components are returned. Now let's update the `active_power` parameter of these four thermal generators using the [`set_active_power!`](@ref) function.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 130 in 3fea206

set_active_power!(i, 0.0)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 133 in 3fea206

Let's check the update using [`show_components`](@ref):

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 134 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 137 in 3fea206

We can see that all the `active_power` parameters are 0.0, except `Solitude`.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 140 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 143 to 145 in 3fea206

	We can see that `Solitude` has a rating of 5.2 and `Alta` has a rating of 0.5.
	```@repl system
	thermal_rating = get_components(x -> get_rating(x) == 5.2 || get_rating(x) == 0.5, ThermalStandard, sys )

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 147 to 150 in 3fea206

	We can see that two components are returned. If we wanted to update those ratings to 4.0:
	```@repl system
	for i in thermal_rating
	set_rating!(i, 4.0)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 153 to 154 in 3fea206

	The rating parameters of `Solitude` and `Alta` are now 4.0:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 159 to 160 in 3fea206

	The [`get_available_components`](@ref) function allows us to grab all the components of a particular type that are available. For example, if we are interested in grabbing all the available renewable generators:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 163 in 3fea206

The two [`RenewableDispatch`](@ref) components are returned because they are available.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 166 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 169 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 171 in 3fea206

set_available!(i, 0)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 174 in 3fea206

Let's check the availability of our [`ThermalStandard`](@ref) components.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 175 in 3fea206

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 178 in 3fea206

Recall that the default columns returned when using [`show_components`](@ref) are the name and availability.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 181 in 3fea206

We can access the [`ACBus`](@ref), notice that we need define some basic data, including the bus's

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 182 in 3fea206

components in the system using the [`get_buses`](@ref) function. There are multiple approaches to using this function, but in this tutorial we are going to focus on getting buses using the ID numbers.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 184 to 185 in 3fea206

	components using the [`get_bus_numbers`](@ref) function.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 188 to 189 in 3fea206

	We can see that a vector of values 1:5 is returned. Now let's grab the buses using the [`get_buses`](@ref) function.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 192 in 3fea206

The 5 buses in the system are returned.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 196 to 198 in 3fea206

	We can also access and update the component name parameter using the [`get_name`](@ref) and [set_name!](@ref) functions.
	Recall that we created an iterator called `thermal_gens` for all the thermal generators. We can use the [`get_name`](@ref) function to access the `name` parameter for these components.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 200 to 201 in 3fea206

	for i in thermal_gens
	@show get_name(i)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 204 to 205 in 3fea206

	To update the names we will use the [set_name!](@ref) function. However, it is important to note that using [set_name!](@ref) not only changes the field `name`, but also changes the container itself. Therefore, it is crucial to do the following:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 207 in 3fea206

set_name!(sys, thermal_gen, get_name(thermal_gen)*"-renamed")

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 210 to 213 in 3fea206

	Now we can check the names using the [`get_name`](@ref) function again.
	```@repl system
	get_name.(get_components(ThermalStandard,sys))
	```

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 215 in 3fea206

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 217 to 218 in 3fea206

	So far we have seen that we can view different data types in our system using the `show_components` function, we can access those types using the `get_*` function, and we can manipulate them using the `set_*` functions.
	Follow the next tutorials to learn how to [work with time series](https://nrel-sienna.github.io/PowerSystems.jl/stable/tutorials/working_with_time_series/).

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 84.30%. Comparing base (effc91c) to head (199900e).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1245   +/-   ##
=======================================
  Coverage   84.30%   84.30%           
=======================================
  Files         181      181           
  Lines        8409     8409           
=======================================
  Hits         7089     7089           
  Misses       1320     1320           

Flag	Coverage Δ
unittests	84.30% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

[github-actions]

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

JuliaFormatter

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 102 in 1c70e53

See that the pretty-print summarizes this set of components, but let's check what was actually returned:

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 103 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 108 in 1c70e53

Notice that `PowerSystems.jl` returns Julia iterators in order to avoid unnecessary memory allocations

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 116 in 1c70e53

Use [`collect`](https://docs.julialang.org/en/v1/base/collections/#Base.collect-Tuple{Any})

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 120 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 122 to 123 in 1c70e53

	set_base_voltage!(i, 250.0)
	end

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 129 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 132 in 1c70e53

We can see that all of the buses now have a `base_voltage` of 250.0 kV.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 135 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 138 to 139 in 1c70e53

	Now, using the [`set_fuel!`](@ref set_fuel!(value::ThermalStandard)) and a `for` loop, we will update the `fuel` to `NATURAL_GAS`.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 141 in 1c70e53

set_fuel!(i, ThermalFuels.NATURAL_GAS)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 144 in 1c70e53

We can verify that the `fuel` types for all the thermal generators has been updated,

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 146 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 151 to 153 in 1c70e53

	We have seen how to update a single component, and all the components of a specific type, but what if we are interested in updating only particular components? We can do this using filter functions. For example, let's say we are interested in updating all the `active_power` values of the thermal generators except `Solitude`.
	Let's start by seeing the current `active_power` values.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 156 in 1c70e53

Let's grab an iterator for the all the thermal generators except `Solitude` by adding a filter function

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 158 to 161 in 1c70e53

	filter_func::Function,
	::Type{T},
	sys::System;
	subsystem_name = nothing,

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 163 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 166 to 167 in 1c70e53

	We can see that four [`ThermalStandard`](@ref) components are returned. Now let's update the `active_power` field of these four thermal generators using the [`set_active_power!`](@ref) function.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 169 in 1c70e53

set_active_power!(i, 0.0)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 172 in 1c70e53

Let's check the update using [`show_components`](@ref):

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 173 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 176 in 1c70e53

We can see that all the `active_power` values are 0.0, except `Solitude`.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 180 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 182 in 1c70e53

set_available!(i, 0)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 187 in 1c70e53

The [`get_available_components`](@ref) function is a useful short-hand function with a

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 190 to 191 in 1c70e53

	For example, if we are interested in grabbing all the available [`ThermalStandard`](@ref):
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 194 to 195 in 1c70e53

	We only retrieved one component, because the rest have been set to unavailable:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 200 in 1c70e53

We can retrieve the [`ACBus`](@ref) components using

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 206 to 207 in 1c70e53

	components using the [`get_bus_numbers`](@ref) function.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 210 in 1c70e53

We can see that these bus IDs are numbered 1 through 5.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 212 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 215 in 1c70e53

and update their base voltage to 330 kV:

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 216 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 218 in 1c70e53

set_base_voltage!(i, 330.0)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 223 in 1c70e53

```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 229 to 230 in 1c70e53

	We can also access and update the component name field using the [`get_name`](@ref) and [set_name!](@ref) functions.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 232 in 1c70e53

We can use the [`get_name`](@ref) function to access the `name` field for these components.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 234 to 235 in 1c70e53

	for i in thermal_gens
	@show get_name(i)

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 238 in 1c70e53

To update the names we will use the [set_name!](@ref) function.

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 241 in 1c70e53

Specifically when using [set_name!](@ref), it is important to note that using

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 246 to 248 in 1c70e53

	calling [`collect`](https://docs.julialang.org/en/v1/base/collections/#Base.collect-Tuple{Any})
	on the iterator:
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 250 in 1c70e53

set_name!(sys, thermal_gen, get_name(thermal_gen)*"-renamed")

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 253 to 254 in 1c70e53

	Now we can check the names using the [`get_name`](@ref) function again.
	```@repl system

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Line 259 in 1c70e53

So far we have seen that we can view different data types in our system using the

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 261 to 264 in 1c70e53

	filter_func::Function,
	::Type{T},
	sys::System;
	subsystem_name = nothing,

---

[JuliaFormatter] _{reported by reviewdog 🐶}

PowerSystems.jl/docs/src/tutorials/manipulating_datasets.md

Lines 266 to 267 in 1c70e53

	them using the `set_*` functions.
	Follow the next tutorials to learn how to [work with time series](@ref tutorial_time_series).

[github-actions]

[JuliaFormatter] _{reported by reviewdog 🐶}

Suggested change

	1. We make no guarantees on the stability of component structure definitions. We will maintain version stability on the accessor methods.
	2. Per-unit conversions are made in the return of data from the accessor functions. (see the [per-unit](https://nrel-sienna.github.io/PowerSystems.jl/stable/explanation/per_unit/#per_unit) section for more details)
	1. We make no guarantees on the stability of component structure definitions. We will maintain version stability on the accessor methods.
	2. Per-unit conversions are made in the return of data from the accessor functions. (see the [per-unit](https://nrel-sienna.github.io/PowerSystems.jl/stable/explanation/per_unit/#per_unit) section for more details)