open-space-toolkit-astrodynamics 10.0.0__py310-none-manylinux2014_x86_64.whl → 10.1.0__py310-none-manylinux2014_x86_64.whl

{open_space_toolkit_astrodynamics-10.0.0.dist-info → open_space_toolkit_astrodynamics-10.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: open-space-toolkit-astrodynamics
-Version: 10.0.0
+Version: 10.1.0
 Summary: Orbit, attitude, access.
 Author: Open Space Collective
 Author-email: contact@open-space-collective.org

{open_space_toolkit_astrodynamics-10.0.0.dist-info → open_space_toolkit_astrodynamics-10.1.0.dist-info}/RECORD

@@ -2,9 +2,10 @@ ostk/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
 ostk/astrodynamics/OpenSpaceToolkitAstrodynamicsPy.cpython-310-x86_64-linux-gnu.so,sha256=Nyt1LHvXCuRprozBe4r0J9g2ZhaoD8xJd6GUAn6xJAg,2320256
 ostk/astrodynamics/__init__.py,sha256=3gWyqFIbhAfcdeMhmfBPQPlPQTmaOzm-6flkJe745Zk,251
 ostk/astrodynamics/converters.py,sha256=vsm7SHdlPIyIxW1h5ZGAizl284koGaRmyPCu--AQJfA,4670
+ostk/astrodynamics/dataframe.py,sha256=njimcfT2cvnSOp9eBR1Ej-LuYpXbVieAVEBk2tYW4Vg,18761
 ostk/astrodynamics/display.py,sha256=KiEGsjNftQfoUe-HfZeYpQQQ4TkaEnxtEl6p5_LX5f0,6303
 ostk/astrodynamics/libopen-space-toolkit-astrodynamics.so.10,sha256=JKGGWpUWmd9uKuF4Xgd7y3j5MaQggDNV1w3MFKEyNLY,81543536
-ostk/astrodynamics/utilities.py,sha256=Jw-AT9CU-a2ERDDSNp7rEhZQKhbmZSCr2flGti9XysU,4813
+ostk/astrodynamics/utilities.py,sha256=Yu5Yydq22gNIHi6ylqeujDENcueb1JfUE6d93h1m9XE,4795
 ostk/astrodynamics/viewer.py,sha256=8UxqsvU5wui7gPUwxXaKcIB-509NJiih9Df3mQgXyXY,11776
 ostk/astrodynamics/pytrajectory/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
 ostk/astrodynamics/pytrajectory/pystate.py,sha256=ByOq8szit74xQ-pnLz0uGGxM6Jqfa17dFJyFB8qIXUg,1033
@@ -12,7 +13,8 @@ ostk/astrodynamics/test/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3I
 ostk/astrodynamics/test/conftest.py,sha256=fsdUQnLxyfvBzfaSCkgipkPIhkPHchQqbeAro1pF648,2717
 ostk/astrodynamics/test/test_access.py,sha256=MCBsUPtuVm7NgHZR0z0DpWnPZ_qBu4aRhLI2PnRNUYs,3940
 ostk/astrodynamics/test/test_converters.py,sha256=hnvqOCtUGrzBvjv7GnmaRdl2mlKM3eWuJUspe305B-A,12114
-ostk/astrodynamics/test/test_display.py,sha256=YnwnqXh-a1OODN2YqHr-l5-q1DrgZ-P4pOY5gxJp4II,3732
+ostk/astrodynamics/test/test_dataframe.py,sha256=IJMOODzTVYtiPxekmltH6lOMArPXbHwSEAl-jg0Ab2g,28414
+ostk/astrodynamics/test/test_display.py,sha256=Ykvw2rUWWw8jsX0Suy11X27bHjwm_ira__xj0ZyHHxw,3672
 ostk/astrodynamics/test/test_event_condition.py,sha256=mhMTH7wAoYFWRYt_8l2d1vjNPrFhVjMAEET4INLCVXY,1472
 ostk/astrodynamics/test/test_import.py,sha256=py_hALBR0IYuUzv9dfgQZzrrLHJIpnyKvt3Oi1XBqCg,1251
 ostk/astrodynamics/test/test_root_solver.py,sha256=hQ8O6g-WP49gZH_H3Rdufv0F0gQorpzJyIcjBGGUQ34,1831
@@ -86,13 +88,13 @@ ostk/astrodynamics/test/trajectory/orbit/models/sgp4/__init__.py,sha256=epnVn2Pw
 ostk/astrodynamics/test/trajectory/orbit/models/sgp4/test_tle.py,sha256=jkyRr5NJQMaSpI3ey7cKcH0E-BlalaUlf_mZPYTSow8,11482
 ostk/astrodynamics/test/trajectory/state/test_coordinate_broker.py,sha256=ho5FBfB3IvIjfQl7EYoIN1KBuH9lu76IiNMuweq8cqg,2844
 ostk/astrodynamics/test/trajectory/state/test_coordinate_subset.py,sha256=KjltLEPbxMfyebwjG5mulyGCT5INtiItPq6ID6sP9jI,1289
-ostk/astrodynamics/test/trajectory/state/test_numerical_solver.py,sha256=_t4OKnYLzTjOhSkVTgT2307DQkz_DnGxqqLx8mmzLRA,9389
+ostk/astrodynamics/test/trajectory/state/test_numerical_solver.py,sha256=PcLU8XTiDHZ-yplYvHZFX32yTUoua9MhKrMmQPINl9w,9386
 ostk/astrodynamics/test/trajectory/state/coordinate_subset/test_angular_velocity.py,sha256=xjyGREKpxDuT8gjtBPkV4osfW-6UyWv9hgvBXZVb_wk,625
 ostk/astrodynamics/test/trajectory/state/coordinate_subset/test_attitude_quaternion.py,sha256=UEu9ApzQLmT87eeISw6_gcHTlX-4b2scIvHz-uE1p_c,393
 ostk/astrodynamics/test/trajectory/state/coordinate_subset/test_cartesian_position.py,sha256=XvHdk1KjacTwtkgx2jUAc9I9N3nvjPDv03FAanpv8jQ,2702
 ostk/astrodynamics/test/trajectory/state/coordinate_subset/test_cartesian_velocity.py,sha256=-kd5TZO5TICihbkqDTew2i_tDpggdpe3Yf23046FATM,3057
-open_space_toolkit_astrodynamics-10.0.0.dist-info/METADATA,sha256=kTX3aUOHCyRMiuocFwxsUbTMFfv8uFIGSqlSKQAK1KU,1916
-open_space_toolkit_astrodynamics-10.0.0.dist-info/WHEEL,sha256=EfzGwk6HazeuFg6dmyxdAa9hqpFBtmJ_haGsqhCVSCQ,110
-open_space_toolkit_astrodynamics-10.0.0.dist-info/top_level.txt,sha256=zOR18699uDYnafgarhL8WU_LmTZY_5NVqutv-flp_x4,5
-open_space_toolkit_astrodynamics-10.0.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-open_space_toolkit_astrodynamics-10.0.0.dist-info/RECORD,,
+open_space_toolkit_astrodynamics-10.1.0.dist-info/METADATA,sha256=4JCiBdx8g8GootL2UgFMCtDDgnNZTRG7yh3IxMaOuNU,1916
+open_space_toolkit_astrodynamics-10.1.0.dist-info/WHEEL,sha256=EfzGwk6HazeuFg6dmyxdAa9hqpFBtmJ_haGsqhCVSCQ,110
+open_space_toolkit_astrodynamics-10.1.0.dist-info/top_level.txt,sha256=zOR18699uDYnafgarhL8WU_LmTZY_5NVqutv-flp_x4,5
+open_space_toolkit_astrodynamics-10.1.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+open_space_toolkit_astrodynamics-10.1.0.dist-info/RECORD,,

ostk/astrodynamics/dataframe.py

@@ -0,0 +1,477 @@
+# Copyright © Loft Orbital Solutions Inc.
+
+import numpy as np
+
+import pandas as pd
+
+from ostk.mathematics.curve_fitting import Interpolator
+
+from ostk.physics.environment.object import Celestial
+from ostk.physics.environment.object.celestial import Earth
+from ostk.physics.time import Instant
+from ostk.physics.coordinate import Frame
+
+from ostk.astrodynamics.converters import coerce_to_datetime
+from ostk.astrodynamics.converters import coerce_to_instant
+from ostk.astrodynamics.trajectory import State
+from ostk.astrodynamics.trajectory import StateBuilder
+from ostk.astrodynamics.trajectory import Orbit
+from ostk.astrodynamics.trajectory.state import CoordinateSubset
+from ostk.astrodynamics.trajectory.state.coordinate_subset import CartesianPosition
+from ostk.astrodynamics.trajectory.state.coordinate_subset import CartesianVelocity
+from ostk.astrodynamics.trajectory.state.coordinate_subset import AttitudeQuaternion
+from ostk.astrodynamics.trajectory.state.coordinate_subset import AngularVelocity
+from ostk.astrodynamics.trajectory.orbit.model import Tabulated as TabulatedOrbit
+from ostk.astrodynamics.flight import Profile
+from ostk.astrodynamics.flight.profile.model import Tabulated as TabulatedProfile
+
+
+DEFAULT_REFERENCE_FRAME: Frame = Frame.GCRF()
+DEFAULT_TIME_COLUMN: str = "Timestamp"
+DEFAULT_POSITION_COLUMNS_FORMAT: list[str] = [
+    "r_{frame}_x",
+    "r_{frame}_y",
+    "r_{frame}_z",
+]
+DEFAULT_VELOCITY_COLUMNS_FORMAT: list[str] = [
+    "v_{frame}_x",
+    "v_{frame}_y",
+    "v_{frame}_z",
+]
+DEFAULT_ATTITUDE_COLUMNS_FORMAT: list[str] = [
+    "q_B_{frame}_x",
+    "q_B_{frame}_y",
+    "q_B_{frame}_z",
+    "q_B_{frame}_s",
+]
+DEFAULT_ANGULAR_VELOCITY_COLUMNS_FORMAT: list[str] = [
+    "w_B_{frame}_in_B_x",
+    "w_B_{frame}_in_B_y",
+    "w_B_{frame}_in_B_z",
+]
+CARTESIAN_POSITION_SUBSET: CartesianPosition = CartesianPosition.default()
+CARTESIAN_VELOCITY_SUBSET: CartesianVelocity = CartesianVelocity.default()
+ATTITUDE_QUATERNION_SUBSET: AttitudeQuaternion = AttitudeQuaternion.default()
+ANGULAR_VELOCITY_SUBSET: AngularVelocity = AngularVelocity.default()
+
+DEFAULT_INTERPOLATION_TYPE: Interpolator.Type = Interpolator.Type.BarycentricRational
+
+
+def generate_column_names(
+    reference_frame: Frame,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    attitude_columns: list[str] | None = None,
+    angular_velocity_columns: list[str] | None = None,
+) -> tuple[str, list[str], list[str], list[str], list[str]]:
+    """
+    Generate column names for a DataFrame containing orbit data.
+
+    Args:
+        reference_frame (Frame): Reference frame.
+        time_column (str | None): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None): List of column names containing the velocity data in [m/s].
+        attitude_columns (list[str] | None): List of column names containing the attitude data in [x, y, z, s] form.
+        angular_velocity_columns (list[str] | None): List of column names containing the angular velocity data in [rad/s].
+
+    Returns:
+        tuple[str, list[str], list[str], list[str], list[str]: Tuple containing the column names.
+    """
+    reference_frame_name: str = reference_frame.get_name()
+
+    return (
+        time_column or DEFAULT_TIME_COLUMN,
+        position_columns
+        or [
+            column.format(frame=reference_frame_name)
+            for column in DEFAULT_POSITION_COLUMNS_FORMAT
+        ],
+        velocity_columns
+        or [
+            column.format(frame=reference_frame_name)
+            for column in DEFAULT_VELOCITY_COLUMNS_FORMAT
+        ],
+        attitude_columns
+        or [
+            column.format(frame=reference_frame_name)
+            for column in DEFAULT_ATTITUDE_COLUMNS_FORMAT
+        ],
+        angular_velocity_columns
+        or [
+            column.format(frame=reference_frame_name)
+            for column in DEFAULT_ANGULAR_VELOCITY_COLUMNS_FORMAT
+        ],
+    )
+
+
+def generate_states_from_dataframe(
+    dataframe: pd.DataFrame,
+    reference_frame: Frame | None = None,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    attitude_columns: list[str] | None = None,
+    angular_velocity_columns: list[str] | None = None,
+    output_frame: Frame | None = None,
+) -> list[State]:
+    """
+    Generate a list of OSTk States from a Pandas DataFrame.
+
+    Args:
+        dataframe (pd.DataFrame): Pandas DataFrame containing the orbit data.
+        reference_frame (Frame | None, optional): Reference frame of the states in the dataframe.
+        time_column (str | None, optional): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None, optional): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None, optional): List of column names containing the velocity data in [m/s].
+        attitude_columns (list[str] | None, optional): List of column names containing the attitude data in [x, y, z, s] form.
+        angular_velocity_columns (list[str] | None, optional): List of column names containing the angular velocity data in [rad/s].
+        output_frame (Frame | None, optional): Output frame for the states.
+
+    Returns:
+        list[State]: List of OSTk States.
+    """
+
+    reference_frame = reference_frame or DEFAULT_REFERENCE_FRAME
+
+    output_frame = output_frame or reference_frame
+
+    (
+        time_column,
+        position_columns,
+        velocity_columns,
+        attitude_columns,
+        angular_velocity_columns,
+    ) = generate_column_names(
+        reference_frame=reference_frame,
+        time_column=time_column,
+        position_columns=position_columns,
+        velocity_columns=velocity_columns,
+        attitude_columns=attitude_columns,
+        angular_velocity_columns=angular_velocity_columns,
+    )
+
+    if not set(position_columns).issubset(dataframe.columns):
+        raise ValueError("Position columns are not present in the DataFrame.")
+
+    if not set(velocity_columns).issubset(dataframe.columns):
+        raise ValueError("Velocity columns are not present in the DataFrame.")
+
+    # check if the dataframe contains a timestamp column
+    has_timestamp: bool = time_column in dataframe.columns
+
+    # check if the dataframe contains attitude
+    has_attitude: bool = set(attitude_columns).issubset(dataframe.columns)
+
+    # check if the dataframe contains angular velocity
+    has_angular_velocity: bool = set(angular_velocity_columns).issubset(dataframe.columns)
+
+    coordinate_subsets = [
+        CARTESIAN_POSITION_SUBSET,
+        CARTESIAN_VELOCITY_SUBSET,
+    ]
+
+    if has_attitude:
+        coordinate_subsets.extend([ATTITUDE_QUATERNION_SUBSET])
+
+    if has_angular_velocity:
+        coordinate_subsets.extend([ANGULAR_VELOCITY_SUBSET])
+
+    state_builder: StateBuilder = StateBuilder(
+        frame=reference_frame,
+        coordinate_subsets=coordinate_subsets,
+    )
+
+    states: list[State] = []
+    for index, row in dataframe.to_dict("index").items():
+
+        coordinates: list[float] = [
+            *[row[column] for column in position_columns],
+            *[row[column] for column in velocity_columns],
+        ]
+
+        if has_attitude:
+            coordinates.extend([row[column] for column in attitude_columns])
+
+        if has_angular_velocity:
+            coordinates.extend([row[column] for column in angular_velocity_columns])
+
+        states.append(
+            state_builder.build(
+                instant=coerce_to_instant(
+                    row[time_column] if has_timestamp else index,
+                ),
+                coordinates=coordinates,
+            ).in_frame(output_frame)
+        )
+
+    return states
+
+
+def generate_dataframe_from_states(
+    states: list[State],
+    reference_frame: Frame | None = None,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    attitude_columns: list[str] | None = None,
+    angular_velocity_columns: list[str] | None = None,
+    set_time_index: bool = True,
+) -> pd.DataFrame:
+    """
+    Generate a Pandas DataFrame from a list of OSTk States.
+
+    Args:
+        states (list[State]): List of OSTk States.
+        reference_frame (Frame | None, optional): The desired reference frame.
+        time_column (str | None, optional): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None, optional): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None, optional): List of column names containing the velocity data in [m/s].
+        attitude_columns (list[str] | None, optional): List of column names containing the attitude data in [x, y, z, s] form.
+        angular_velocity_columns (list[str] | None, optional): List of column names containing the angular velocity data in [rad/s].
+        set_time_index (bool, optional): Whether to set the time column as the index. Defaults to True.
+
+    Returns:
+        pd.DataFrame: Pandas DataFrame containing the orbit data.
+    """
+    has_attitude: bool = states[0].has_subset(ATTITUDE_QUATERNION_SUBSET)
+    has_angular_velocity: bool = states[0].has_subset(ANGULAR_VELOCITY_SUBSET)
+
+    reference_frame = reference_frame or DEFAULT_REFERENCE_FRAME
+
+    (
+        time_column,
+        position_columns,
+        velocity_columns,
+        attitude_columns,
+        angular_velocity_columns,
+    ) = generate_column_names(
+        reference_frame=reference_frame,
+        time_column=time_column,
+        position_columns=position_columns,
+        velocity_columns=velocity_columns,
+        attitude_columns=attitude_columns,
+        angular_velocity_columns=angular_velocity_columns,
+    )
+
+    if len(position_columns) != 3:
+        raise ValueError("Position columns must be a list of length 3.")
+
+    if len(velocity_columns) != 3:
+        raise ValueError("Velocity columns must be a list of length 3.")
+
+    if len(attitude_columns) != 4:
+        raise ValueError("Attitude columns must be a list of length 4.")
+
+    if len(angular_velocity_columns) != 3:
+        raise ValueError("Angular velocity columns must be a list of length 3.")
+
+    data: list[dict] = []
+
+    for state in states:
+        state = state.in_frame(reference_frame)
+
+        datum: dict = {
+            time_column: coerce_to_datetime(state.get_instant()),
+            **_get_entry_from_state(state, position_columns, CARTESIAN_POSITION_SUBSET),
+            **_get_entry_from_state(state, velocity_columns, CARTESIAN_VELOCITY_SUBSET),
+        }
+
+        if has_attitude:
+            datum.update(
+                _get_entry_from_state(state, attitude_columns, ATTITUDE_QUATERNION_SUBSET)
+            )
+        if has_angular_velocity:
+            datum.update(
+                _get_entry_from_state(
+                    state, angular_velocity_columns, ANGULAR_VELOCITY_SUBSET
+                )
+            )
+
+        data.append(datum)
+
+    dataframe: pd.DataFrame = pd.DataFrame(data)
+    if set_time_index:
+        dataframe.set_index(time_column, inplace=True)
+
+    return dataframe
+
+
+def generate_orbit_from_dataframe(
+    dataframe: pd.DataFrame,
+    central_body: Celestial = Earth.default(),
+    reference_frame: Frame | None = None,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    initial_revolution_number: int = 1,
+    interpolation_type: Interpolator.Type | None = None,
+    output_frame: Frame | None = None,
+) -> Orbit:
+    """
+    Generate an OSTk Orbit from a Pandas DataFrame.
+
+    Args:
+        dataframe (pd.DataFrame): Pandas DataFrame containing the orbit data.
+        central_body (Celestial, optional): Celestial object around which the Orbit is defined. Defaults to Earth.
+        reference_frame (Frame | None, optional): Reference frame.
+        time_column (str | None, optional): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None, optional): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None, optional): List of column names containing the velocity data in [m/s].
+        initial_revolution_number (int, optional): Initial revolution number. Defaults to 1.
+        interpolation_type (Interpolator.Type | None, optional): Interpolation type.
+        output_frame (Frame | None, optional): Output frame for the states.
+
+    Returns:
+        Orbit: OSTk Orbit.
+    """
+
+    return Orbit(
+        model=TabulatedOrbit(
+            states=generate_states_from_dataframe(
+                dataframe=dataframe,
+                time_column=time_column,
+                position_columns=position_columns,
+                velocity_columns=velocity_columns,
+                reference_frame=reference_frame,
+                output_frame=output_frame,
+            ),
+            initial_revolution_number=initial_revolution_number,
+            interpolation_type=interpolation_type or DEFAULT_INTERPOLATION_TYPE,
+        ),
+        celestial_object=central_body,
+    )
+
+
+def generate_dataframe_from_orbit(
+    orbit: Orbit,
+    instants: list[Instant],
+    reference_frame: Frame | None = None,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    set_time_index: bool = True,
+) -> pd.DataFrame:
+    """
+    Generate a Pandas DataFrame from an OSTk Orbit.
+
+    Args:
+        orbit (Orbit): OSTk Orbit.
+        instants (list[Instant]): List of instants at which the Orbit is to be evaluated.
+        reference_frame (Frame | None, optional): Reference frame.
+        time_column (str | None, optional): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None, optional): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None, optional): List of column names containing the velocity data in [m/s].
+        set_time_index (bool, optional): Whether to set the time column as the DataFrame index. Defaults to True.
+
+    Returns:
+        pd.DataFrame: Pandas DataFrame containing the Orbit data.
+    """
+
+    states: list[State] = orbit.get_states_at(instants)
+
+    return generate_dataframe_from_states(
+        states,
+        reference_frame=reference_frame,
+        time_column=time_column,
+        position_columns=position_columns,
+        velocity_columns=velocity_columns,
+        set_time_index=set_time_index,
+    )
+
+
+def generate_profile_from_dataframe(
+    dataframe: pd.DataFrame,
+    reference_frame: Frame | None = None,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    attitude_columns: list[str] | None = None,
+    angular_velocity_columns: list[str] | None = None,
+    output_frame: Frame | None = None,
+) -> Profile:
+    """
+    Generate an OSTk Profile from a Pandas DataFrame.
+
+    Args:
+        dataframe (pd.DataFrame): Pandas DataFrame containing the Profile data.
+        reference_frame (Frame | None, optional): Reference frame.
+        time_column (str | None, optional): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None, optional): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None, optional): List of column names containing the velocity data in [m/s].
+        attitude_columns (list[str] | None, optional): List of column names containing the attitude data in [x, y, z, s] form.
+        angular_velocity_columns (list[str] | None, optional): List of column names containing the angular velocity data in [rad/s].
+        output_frame (Frame | None, optional): Output frame for the states.
+
+    Returns:
+        Profile: OSTk Profile.
+    """
+
+    return Profile(
+        model=TabulatedProfile(
+            states=generate_states_from_dataframe(
+                dataframe=dataframe,
+                reference_frame=reference_frame,
+                time_column=time_column,
+                position_columns=position_columns,
+                velocity_columns=velocity_columns,
+                attitude_columns=attitude_columns,
+                angular_velocity_columns=angular_velocity_columns,
+                output_frame=output_frame,
+            ),
+        ),
+    )
+
+
+def generate_dataframe_from_profile(
+    profile: Profile,
+    instants: list[Instant],
+    reference_frame: Frame | None = None,
+    time_column: str | None = None,
+    position_columns: list[str] | None = None,
+    velocity_columns: list[str] | None = None,
+    attitude_columns: list[str] | None = None,
+    angular_velocity_columns: list[str] | None = None,
+    set_time_index: bool = True,
+) -> pd.DataFrame:
+    """
+    Generate a Pandas DataFrame from an OSTk Profile.
+
+    Args:
+        profile (Profile): OSTk Profile.
+        instants (list[Instant]): List of instants at which the Profile is to be evaluated.
+        reference_frame (Frame | None, optional): Reference frame.
+        time_column (str | None, optional): Name of the column containing the time data in [UTC].
+        position_columns (list[str] | None, optional): List of column names containing the position data in [m].
+        velocity_columns (list[str] | None, optional): List of column names containing the velocity data in [m/s].
+        attitude_columns (list[str] | None, optional): List of column names containing the attitude data in [x, y, z, s] form.
+        angular_velocity_columns (list[str] | None, optional): List of column names containing the angular velocity data in [rad/s].
+        set_time_index (bool, optional): Whether to set the time column as the DataFrame index. Defaults to True.
+
+    Returns:
+        pd.DataFrame: Pandas DataFrame containing the Profile data.
+    """
+
+    states: list[State] = profile.get_states_at(instants)
+
+    return generate_dataframe_from_states(
+        states,
+        reference_frame=reference_frame,
+        time_column=time_column,
+        position_columns=position_columns,
+        velocity_columns=velocity_columns,
+        attitude_columns=attitude_columns,
+        angular_velocity_columns=angular_velocity_columns,
+        set_time_index=set_time_index,
+    )
+
+
+def _get_entry_from_state(
+    state: State, columns: list[str], subset: CoordinateSubset
+) -> dict:
+    coordinates: np.ndarray = state.extract_coordinate(subset)
+    return {
+        column.format(frame=state.get_frame().get_name()): coordinates[idx]
+        for idx, column in enumerate(columns)
+    }