Environment Analysis Class#

class rocketpy.EnvironmentAnalysis[source]#

Class for analyzing the environment.

List of properties currently implemented:
  • average max/min temperature at surface level

  • record max/min temperature at surface level

  • temperature progression throughout the day

  • temperature profile over an average day

  • average max wind gust at surface level

  • record max wind gust at surface level

  • average, 1, 2, 3 sigma wind profile

  • average day wind rose

  • animation of how average wind rose evolves throughout an average day

  • animation of how wind profile evolves throughout an average day

  • pressure profile over an average day

  • wind velocity x profile over average day

  • wind velocity y profile over average day

  • wind speed profile over an average day

  • average max surface 100m wind speed

  • average max surface 10m wind speed

  • average min surface 100m wind speed

  • average min surface 10m wind speed

  • average sustained surface100m wind along day

  • average sustained surface10m wind along day

  • maximum surface 10m wind speed

  • average cloud base height

  • percentage of days with no cloud coverage

  • percentage of days with precipitation

You can also visualize all those attributes by exploring the methods:
  • plot of wind gust distribution (should be Weibull)

  • plot wind profile over average day

  • plot sustained surface wind speed distribution over average day

  • plot wind gust distribution over average day

  • plot average day wind rose all hours

  • plot average day wind rose specific hour

  • plot average pressure profile

  • plot average surface10m wind speed along day

  • plot average sustained surface100m wind speed along day

  • plot average temperature along day

  • plot average wind speed profile

  • plot surface10m wind speed distribution

  • animate wind profile over average day

  • animate sustained surface wind speed distribution over average day

  • animate wind gust distribution over average day

  • animate average wind rose

  • animation of how the wind gust distribution evolves over average day

  • all_info

All items listed are relevant to either
  1. participant safety

  2. launch operations (range closure decision)

  3. rocket performance

How does this class work?
  • The class is initialized with a start_date, end_date, start_hour and end_hour.

  • The class then parses the weather data from the start date to the end date. Always parsing the data from start_hour to end_hour.

  • The class then calculates the average max/min temperature, average max wind gust, and average day wind rose.

  • The class then allows for plotting the average max/min temperature, average max wind gust, and average day wind rose.

__init__(start_date, end_date, latitude, longitude, start_hour=0, end_hour=24, surface_data_file=None, pressure_level_data_file=None, timezone=None, unit_system='metric', forecast_date=None, forecast_args=None, max_expected_altitude=None)[source]#

Constructor for the EnvironmentAnalysis class.

Parameters:
  • start_date (datetime.datetime) – Start date and time of the analysis. When parsing the weather data from the source file, only data after this date will be parsed.

  • end_date (datetime.datetime) – End date and time of the analysis. When parsing the weather data from the source file, only data before this date will be parsed.

  • latitude (float) – Latitude coordinate of the location where the analysis will be carried out.

  • longitude (float) – Longitude coordinate of the location where the analysis will be carried out.

  • start_hour (int, optional) – Starting hour of the analysis. When parsing the weather data from the source file, only data after this hour will be parsed.

  • end_hour (int, optional) – End hour of the analysis. When parsing the weather data from the source file, only data before this hour will be parsed.

  • surface_data_file (str, optional) – Path to the netCDF file containing the surface data.

  • pressure_level_data_file (str, optional) – Path to the netCDF file containing the pressure level data.

  • timezone (str, optional) – Name of the timezone to be used when displaying results. To see all available time zones, import pytz and run print(pytz.all_timezones). Default time zone is the local time zone at the latitude and longitude specified.

  • unit_system (str, optional) – Unit system to be used when displaying results. Options are: SI, metric, imperial. Default is metric.

  • forecast_date (datetime.date, optional) – Date for the forecast models. It will be requested the environment forecast for multiple hours within that specified date.

  • forecast_args (dictionary, optional) – Arguments for setting the forecast on the Environment class. With this argument it is possible to change the forecast model being used.

  • max_expected_altitude (float, optional) – Maximum expected altitude for your analysis. This is used to calculate plot limits from pressure level data profiles. If None is set, the maximum altitude will be calculated from the pressure level data. Default is None.

Return type:

None

property original_pressure_level_data#

Return the original pressure level data dictionary. Units are defined by the units in the file.

Returns:

Dictionary with the original pressure level data. This dictionary has the following structure:

original_pressure_level_data = {
    "date" : {
        "hour": {
            "data": ...,
            "data": ...
        },
        "hour": {
            "data": ...,
            "data": ...
        }
    },
    "date" : {
        "hour": {
        ...
        }
    }
}

Return type:

dictionary

property pressure_level_lat0#

Return the initial latitude of the pressure level data.

property pressure_level_lat1#

Return the final latitude of the pressure level data.

property pressure_level_lon0#

Return the initial longitude of the pressure level data.

property pressure_level_lon1#

Return the final longitude of the pressure level data.

property original_surface_data#

Returns the surface data dictionary. Units are defined by the units in the file.

Returns:

Dictionary with the original surface data. This dictionary has the following structure:

original_surface_data: {
    "date" : {
        "hour": {
            "data": ...,
            "data": ...
        },
        "hour": {
            "data": ...,
            "data": ...
        }
    },
    "date" : {
        "hour": {
        ...
        }
    }
}

Return type:

dictionary

property original_elevation#

Return the elevation of the surface data.

property single_level_lat0#

Return the initial latitude of the surface data.

property single_level_lat1#

Return the final latitude of the surface data.

property single_level_lon0#

Return the initial longitude of the surface data.

property single_level_lon1#

Return the final longitude of the surface data.

property converted_pressure_level_data#

Convert pressure level data to desired unit system. This method will loop through all the data (dates, hours and variables) and convert the units of each variable. therefore, the performance of this method is not optimal. However, this method is only called once and the results are cached, so that the conversion is only done once.

Returns:

Dictionary with the converted pressure level data. This dictionary has the same structure as the original_pressure_level_data dictionary.

Return type:

dictionary

property converted_surface_data#

Convert surface data to desired unit system. This method will loop through all the data (dates, hours and variables) and convert the units of each variable. Therefore, the performance of this method is not optimal. However, this method is only called once and the results are cached, so that the conversion is only done once.

Returns:

Dictionary with the converted surface data. This dictionary has the same structure as the original_surface_data dictionary.

Return type:

dictionary

property hours#

A list containing all the hours available in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once.

Returns:

List with all the hours available in the dataset.

Return type:

list

property days#

A list containing all the days available in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once.

Returns:

List with all the days available in the dataset.

Return type:

list

property converted_elevation#

The surface elevation converted to the preferred unit system. The result is cached so that the computation is only done once.

Returns:

Surface elevation converted to the preferred unit system.

Return type:

float

property cloud_base_height#

A np.ma.array containing the cloud base height for each hour and day in the dataset. The array is masked where no cloud base height is available. The array is flattened, so that it is a 1D array with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Array with cloud base height for each hour and day in the dataset.

Return type:

np.ma.array

property pressure_at_surface_list#

A list containing the pressure at surface for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with pressure at surface for each hour and day in the dataset.

Return type:

list

property temperature_list#

A list containing the temperature for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with temperature for each hour and day in the dataset.

Return type:

list

property max_temperature_list#

A list containing the maximum temperature for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with maximum temperature for each day in the dataset.

Return type:

list

property min_temperature_list#

A list containing the minimum temperature for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with minimum temperature for each day in the dataset.

Return type:

list

property wind_gust_list#

A list containing the wind gust for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with wind gust for each hour and day in the dataset.

Return type:

list

property max_wind_gust_list#

A list containing the maximum wind gust for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with maximum wind gust for each day in the dataset.

Return type:

list

property precipitation_per_day#

A list containing the total precipitation for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with total precipitation for each day in the dataset.

Return type:

list

property surface_10m_wind_speed_list#

A list containing the wind speed at surface+10m level for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with surface 10m wind speed for each hour and day in the dataset.

Return type:

list

property max_surface_10m_wind_speed_list#

A list containing the maximum wind speed at surface+10m level for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with maximum wind speed at surface+10m level for each day in the dataset.

Return type:

list

property min_surface_10m_wind_speed_list#

A list containing the minimum wind speed at surface+10m level for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with minimum wind speed at surface+10m level for each day.

Return type:

list

property surface_100m_wind_speed_list#

A list containing the wind speed at surface+100m level for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with surface 100m wind speed for each hour and day in the dataset.

Return type:

list

property max_surface_100m_wind_speed_list#

A list containing the maximum wind speed at surface+100m level for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with maximum wind speed at surface+100m level for each day.

Return type:

list

property min_surface_100m_wind_speed_list#

A list containing the minimum wind speed at surface+100m level for each day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with minimum wind speed at surface+100m level for each day.

Return type:

list

property record_max_surface_100m_wind_speed#

The overall maximum wind speed at surface+100m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Record maximum wind speed at surface+100m level.

Return type:

float

property record_min_surface_100m_wind_speed#

The overall minimum wind speed at surface+100m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Record minimum wind speed at surface+100m level.

Return type:

float

property record_min_cloud_base_height#

The overall minimum cloud base height considering all the days available in the surface level dataset. It uses the converted surface level data.

Returns:

Record minimum cloud base height.

Return type:

float

property record_max_temperature#

The overall maximum temperature considering all the days available in the surface level dataset. It uses the converted surface level data.

Returns:

Record maximum temperature.

Return type:

float

property record_min_temperature#

The overall minimum temperature considering all the days available in the surface level dataset. It uses the converted surface level data.

Returns:

Record minimum temperature.

Return type:

float

property record_max_wind_gust#

The overall maximum wind gust considering all the days available

Returns:

Record maximum wind gust.

Return type:

float

property record_max_surface_wind_speed#

The overall maximum wind speed at surface level considering all the days available in the surface level dataset. Units are converted to the preferred unit system.

Returns:

Record maximum wind speed at surface level.

Return type:

float

property record_min_surface_wind_speed#

The overall minimum wind speed at surface level considering all the days available in the surface level dataset. Units are converted to the preferred unit system.

Returns:

Record minimum wind speed at surface level.

Return type:

float

property record_max_surface_10m_wind_speed#

The overall maximum wind speed at surface+10m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Record maximum wind speed at surface+10m level.

Return type:

float

property record_min_surface_10m_wind_speed#

The overall minimum wind speed at surface+10m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Record minimum wind speed at surface+10m level.

Return type:

float

property average_surface_pressure#

The average surface pressure for all the days and hours available in the surface level dataset. Units are converted to the preferred unit system.

Returns:

Average surface pressure.

Return type:

float

property std_surface_pressure#

The standard deviation of the surface pressure for all the days and hours available in the surface level dataset. Units are converted to the preferred unit system.

property average_cloud_base_height#

The average cloud base height considering all the days available in the surface level dataset. It uses the converted surface level data. If information is not available for a certain day, the day will be ignored.

Returns:

Average cloud base height.

Return type:

float

property average_max_temperature#

The average maximum temperature considering all the days available in the surface level dataset. It uses the converted surface level data.

Returns:

Average maximum temperature.

Return type:

float

property average_min_temperature#

The average minimum temperature considering all the days available in the surface level dataset. It uses the converted surface level data.

Returns:

Average minimum temperature.

Return type:

float

property average_max_wind_gust#

The average maximum wind gust considering all the days available in the surface level dataset. It uses the converted surface level data.

Returns:

Average maximum wind gust.

Return type:

float

property average_max_surface_10m_wind_speed#

The average maximum wind speed at surface+10m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Average maximum wind speed at surface+10m level.

Return type:

float

property average_min_surface_10m_wind_speed#

The average minimum wind speed at surface+10m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Average minimum wind speed at surface+10m level.

Return type:

float

property average_max_surface_100m_wind_speed#

The average maximum wind speed at surface+100m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Average maximum wind speed at surface+100m level.

Return type:

float

property average_min_surface_100m_wind_speed#

The average minimum wind speed at surface+100m level considering all the days available in the surface level dataset. It uses the converted surface level data. Units are converted to the preferred unit system.

Returns:

Average minimum wind speed at surface+100m level.

Return type:

float

property percentage_of_days_with_no_cloud_coverage#

Calculate percentage of days with cloud coverage.

Returns:

Percentage of days with no cloud coverage.

Return type:

float

property percentage_of_days_with_precipitation#

Computes the ratio between days with precipitation (> 10 mm) and total days. The result is cached so that the computation is only done once.

Returns:

Percentage of days with precipitation.

Return type:

float

property temperature_by_hour#

A dictionary containing the temperature for each hour and day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system. It flips the data dictionary to get the hour as key instead of the date.

Returns:

Dictionary with temperature for each hour and day. The dictionary has the following structure:

dictionary = {
    hour1: {
        date1: temperature1,
        date2: temperature2,
        ...
        dateN: temperatureN,
    },
    ...
    hourN: {
        date1: temperature1,
        date2: temperature2,
        ...
        dateN: temperatureN,
    },
}

Return type:

dictionary

property average_temperature_by_hour#

The average temperature for each hour of the day. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average temperature for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: average_temperature1,
    hour2: average_temperature2,
    ...
    hourN: average_temperatureN
}

Return type:

dictionary

property std_temperature_by_hour#

The standard deviation of the temperature for each hour of the day. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with standard deviation of the temperature for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: std_temperature1,
    hour2: std_temperature2,
    ...
    hourN: std_temperatureN
}

Return type:

dictionary

property surface_10m_wind_speed_by_hour#

A dictionary containing the wind speed at surface+10m level for each hour and day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system. It flips the data dictionary to get the hour as key instead of the date.

Returns:

Dictionary with surface 10m wind speed for each hour and day. The dictionary has the following structure:

dictionary = {
    hour1: {
        date1: wind_speed1,
        date2: wind_speed2,
        ...
        dateN: wind_speedN
    },
    ...
    hourN: {
        date1: wind_speed1,
        date2: wind_speed2,
        ...
        dateN: wind_speedN
    }
}

Return type:

dictionary

property average_surface_10m_wind_speed_by_hour#

The average wind speed at surface+10m level for each hour of the day. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average surface 10m wind speed for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: average_surface_10m_wind_speed1,
    hour2: average_surface_10m_wind_speed2,
    ...
    hourN: average_surface_10m_wind_speedN
}

Return type:

dictionary

property std_surface_10m_wind_speed_by_hour#

The standard deviation of the wind speed at surface+10m level for each hour of the day. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with standard deviation of the surface 10m wind speed for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: std_surface_10m_wind_speed1,
    hour2: std_surface_10m_wind_speed2,
    ...
    hourN: std_surface_10m_wind_speedN
}

Return type:

dictionary

property surface_100m_wind_speed_by_hour#

A dictionary containing the wind speed at surface+100m level for each hour and day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system. It flips the data dictionary to get the hour as key instead of the date.

Returns:

Dictionary with surface 100m wind speed for each hour and day. The dictionary has the following structure:

dictionary = {
    hour1: {
        date1: wind_speed1,
        date2: wind_speed2,
        ...
        dateN: wind_speedN
    },
    ...
    hourN: {
        date1: wind_speed1,
        date2: wind_speed2,
        ...
        dateN: wind_speedN
    }
}

Return type:

dictionary

property average_surface_100m_wind_speed_by_hour#

The average wind speed at surface+100m level for each hour of the day. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average surface 100m wind speed for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: average_surface_100m_wind_speed1,
    hour2: average_surface_100m_wind_speed2,
    ...
    hourN: average_surface_100m_wind_speedN
}

Return type:

dictionary

property std_surface_100m_wind_speed_by_hour#

The standard deviation of the wind speed at surface+100m level for each hour of the day. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with standard deviation of the surface 100m wind speed for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: std_surface_100m_wind_speed1,
    hour2: std_surface_100m_wind_speed2,
    ...
    hourN: std_surface_100m_wind_speedN
}

Return type:

dictionary

property surface_wind_speed_by_hour#

A dictionary containing the wind speed at surface level for each hour and day in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system. It flips the data dictionary to get the hour as key instead of the date.

Returns:

Dictionary with surface wind speed for each hour and day. The dictionary has the following structure:

dictionary = {
    hour1: [wind_speed1, wind_speed2, ..., wind_speedN],
    ...
    hourN: [wind_speed1, wind_speed2, ..., wind_speedN]
}

Return type:

dictionary

property surface_wind_direction_by_hour#

A dictionary containing the wind direction at surface level for each hour and day in the dataset. It flips the data dictionary to get the hour as key instead of the date.

Returns:

Dictionary with surface wind direction for each hour and day. The dictionary has the following structure:

dictionary = {
    hour1: {
        date1: wind_direction1,
        date2: wind_direction2,
        ...
        dateN: wind_directionN
    },
    ...
    hourN: {
        date1: wind_direction1,
        date2: wind_direction2,
        ...
        dateN: wind_directionN
    }
}

Return type:

dictionary

property altitude_AGL_range#

The altitude range for the pressure level data. The minimum altitude is always 0, and the maximum altitude is the maximum altitude of the pressure level data, or the maximum expected altitude if it is set. Units are kept as they are in the original data.

Returns:

Tuple containing the minimum and maximum altitude. The first element is the minimum altitude, and the second element is the maximum.

Return type:

tuple

property altitude_list#

A list of altitudes, from 0 to the maximum altitude of the pressure level data, or the maximum expected altitude if it is set. The list is cached so that the computation is only done once. Units are kept as they are in the original data.

Parameters:

points (int, optional) – Number of points to use in the list. The default is 200.

Returns:

List of altitudes.

Return type:

numpy.ndarray

property pressure_at_1000ft_list#

A list containing the pressure at 1000 feet for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. It uses the converted pressure level data.

property pressure_at_10000ft_list#

A list containing the pressure at 10000 feet for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. It uses the converted pressure level data.

Returns:

List with pressure at 10000 feet for each hour and day in the dataset.

Return type:

list

property pressure_at_30000ft_list#

A list containing the pressure at 30000 feet for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. It uses the converted pressure level data.

Returns:

List with pressure at 30000 feet for each hour and day in the dataset.

Return type:

list

property average_temperature_profile_by_hour#

Compute the average temperature profile for each available hour of a day, over all days in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average temperature profile for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: [average_temperature_profile1, altitude_list1],
    hour2: [average_temperature_profile2, altitude_list2],
    ...
    hourN: [average_temperature_profileN, altitude_listN]
}

Return type:

dictionary

property average_pressure_profile_by_hour#

Compute the average pressure profile for each available hour of a day, over all days in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average pressure profile for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: [average_pressure_profile1, altitude_list1],
    hour2: [average_pressure_profile2, altitude_list2],
    ...
    hourN: [average_pressure_profileN, altitude_listN]
}

Return type:

dictionary

property average_wind_speed_profile_by_hour#

Compute the average wind speed profile for each available hour of a day, over all days in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average wind profile for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: [average_wind_profile1, altitude_list1],
    hour2: [average_wind_profile2, altitude_list2],
    ...
    hourN: [average_wind_profileN, altitude_listN]
}

Return type:

dictionary

property average_wind_velocity_x_profile_by_hour#

Compute the average wind_velocity_x profile for each available hour of a day, over all days in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average wind_velocity_x profile for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: [average_windVelocityX_profile1, altitude_list1],
    hour2: [average_windVelocityX_profile2, altitude_list2],
    ...
    hourN: [average_windVelocityX_profileN, altitude_listN]
}

Return type:

dictionary

property average_wind_velocity_y_profile_by_hour#

Compute the average wind_velocity_y profile for each available hour of a day, over all days in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average wind_velocity_y profile for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: [average_windVelocityY_profile1, altitude_list1],
    hour2: [average_windVelocityY_profile2, altitude_list2],
    ...
    hourN: [average_windVelocityY_profileN, altitude_listN]
}

Return type:

dictionary

property average_wind_heading_profile_by_hour#

Compute the average wind heading profile for each available hour of a day, over all days in the dataset. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

Dictionary with average wind heading profile for each hour of the day. The dictionary has the following structure:

dictionary = {
    hour1: [average_wind_heading_profile1, altitude_list1],
    hour2: [average_wind_heading_profile2, altitude_list2],
    ...
    hourN: [average_wind_heading_profileN, altitude_listN]
}

Return type:

dictionary

property wind_speed_profiles_list#

A list containing the wind speed profile for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with wind speed profile for each hour and day in the dataset.

Return type:

list

property pressure_profiles_list#

A list containing the pressure profile for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with pressure profile for each hour and day in the dataset.

Return type:

list

property temperature_profiles_list#

A list containing the temperature profile for each hour and day in the dataset. The list is flattened, so that it is a 1D list with all the values. The result is cached so that the computation is only done once. The units are converted to the preferred unit system.

Returns:

List with temperature profile for each hour and day in the dataset.

Return type:

list

property max_average_temperature_at_altitude#

The maximum average temperature considering all the hours of the day and all the days available in the pressure level dataset. It uses the converted pressure level data. Units are converted to the preferred unit system.

Returns:

Maximum average temperature.

Return type:

float

property min_average_temperature_at_altitude#

The minimum average temperature considering all the hours of the day and all the days available in the pressure level dataset. It uses the converted pressure level data. Units are converted to the preferred unit system.

Returns:

Minimum average temperature.

Return type:

float

property max_average_wind_speed_at_altitude#

The maximum average wind speed considering all the hours of the day and all the days available in the pressure level dataset. It uses the converted pressure level data. Units are converted to the preferred unit system. The result is cached so that the computation is only done once.

Returns:

Maximum average wind speed.

Return type:

float

property average_pressure_at_1000ft#

The average pressure at 1000 feet for all the days and hours available in the pressure level dataset. It uses the converted pressure level data.

property std_pressure_at_1000ft#

The standard deviation of the pressure at 1000 feet for all the days and hours available in the pressure level dataset. It uses the converted pressure level data.

Returns:

Standard deviation of the pressure at 1000 feet.

Return type:

float

property average_pressure_at_10000ft#

The average pressure at 10000 feet for all the days and hours available in the pressure level dataset. It uses the converted pressure level data.

Returns:

Average pressure at 10000 feet.

Return type:

float

property std_pressure_at_10000ft#

The standard deviation of the pressure at 10000 feet for all the days and hours available in the pressure level dataset. It uses the converted pressure level data.

Returns:

Standard deviation of the pressure at 10000 feet.

Return type:

float

property average_pressure_at_30000ft#

The average pressure at 30000 feet for all the days and hours available in the pressure level dataset. It uses the converted pressure level data.

Returns:

Average pressure at 30000 feet.

Return type:

float

property std_pressure_at_30000ft#

The standard deviation of the pressure at 30000 feet for all the days and hours available in the pressure level dataset. It uses the converted pressure level data.

Returns:

Standard deviation of the pressure at 30000 feet.

Return type:

float

info()[source]#

Prints out the most important data and graphs available about the Environment Analysis.

Return type:

None

all_info()[source]#

Prints out all data and graphs available.

Return type:

None

export_mean_profiles(filename='export_env_analysis')[source]#

Exports the mean profiles of the weather data to a file in order to it be used as inputs on Environment Class by using the custom_atmosphere model.

Parameters:

filename (str, optional) – Name of the file where to be saved, by default “env_analysis_dict”

Return type:

None

classmethod load(filename='env_analysis_dict')[source]#

Load a previously saved Environment Analysis file. Example: EnvA = EnvironmentAnalysis.load(“filename”).

Parameters:

filename (str, optional) – Name of the previous saved file, by default “env_analysis_dict”

Return type:

EnvironmentAnalysis object

save(filename='env_analysis_dict')[source]#

Save the Environment Analysis object to a file so it can be used later.

Parameters:

filename (str, optional) – Name of the file where to be saved, by default “env_analysis_dict”

Return type:

None