Документация Engee

Внутренние компоненты

Функции, методы и типы, перечисленные на этой странице, являются внутренними сущностями пакета DataFrames и не являются частью общедоступного API.

# DataFrames.compacttype — Function

compacttype(T::Type, maxwidth::Int=8, initial::Bool=true)

Возвращает краткое строковое представление типа T.

При отображении фрейма данных строковое представление типа должно быть не длиннее maxwidth. Эта функция определяет то, как обрезаются имена типов, если их длина превышает maxwidth.

# DataFrames.gennames — Function

gennames(n::Integer)

Создает стандартные имена для столбцов объекта DataFrame. Первым именем будет :x1, вторым — :x2 и т. д.

# DataFrames.getmaxwidths — Function

DataFrames.getmaxwidths(df::AbstractDataFrame,
                        io::IO,
                        rowindices1::AbstractVector{Int},
                        rowindices2::AbstractVector{Int},
                        rowlabel::Symbol,
                        rowid::Union{Integer, Nothing},
                        show_eltype::Bool,
                        buffer::IOBuffer)

Для каждого столбца AbstractDataFrame вычисляет максимальную ширину строки для вывода имени столбца, его типа и самого длинного элемента в нем. Эта строка выводится в поток ввода-вывода. Значения ширины всех столбцов возвращаются в виде вектора.

Возвращает Vector{Int} со значениями максимальной ширины строк, необходимой для представления каждого столбца, включая его имя и тип.

ПРИМЕЧАНИЕ. Последний элемент итогового вектора — это ширина строки для столбца с идентификаторами строк, неявно имеющегося в каждом объекте AbstractDataFrame.

Аргументы

  • df::AbstractDataFrame: фрейм данных, столбцы которого выводятся.

  • io::IO: поток IO, в который должен выводиться фрейм данных df.

  • rowindices1::AbstractVector{Int}: набор индексов первого фрагмента AbstractDataFrame, выводимого в поток ввода-вывода.

  • rowindices2::AbstractVector{Int}: набор индексов второго фрагмента AbstractDataFrame, выводимого в поток ввода-вывода. Может быть пустым, если объект AbstractDataFrame будет выводиться полностью.

  • rowlabel::AbstractString: метка, которая будет использоваться при выводе числового идентификатора каждой строки. Обычно применяется метка «Строка».

  • rowid: используется для управления отображением DataFrameRow.

  • show_eltype: нужно ли выводить тип столбца под его именем в заголовке.

  • buffer: буфер, передаваемый во избежание повторного выделения памяти в ourstrwidth.

# DataFrames.ourshow — Function

DataFrames.ourshow(io::IO, x::Any, truncstring::Int)

Выводит значение в объект IO в краткой форме с использованием функции print. truncstring означает примерное количество символов, до которого должен усекаться выводимый текст (если значение не положительное, текст не усекается).

# DataFrames.ourstrwidth — Function

DataFrames.ourstrwidth(io::IO, x::Any, buffer::IOBuffer, truncstring::Int)

Определяет число символов для вывода значения.

# DataFrames.@spawn_for_chunks — Macro

@spawn_for_chunks basesize for i in range ... end

Запускает параллельное выполнение цикла for, порождая отдельные задачи для итерации по фрагменту размером не менее basesize элементов в range.

Допускается порождение более чем Threads.nthreads() задач, так как это позволяет более эффективно балансировать нагрузку в случае, если некоторые потоки заняты (вложенный параллелизм).

# DataFrames.@spawn_or_run_task — Macro

@spawn_or_run_task threads expr

Равносильно Threads.@spawn, если threads === true. В противном случае выполняет выражение expr и возвращает задачу (Task), возвращающую его значение.

# DataFrames.@spawn_or_run — Macro

@spawn_or_run threads expr

Равносильно Threads.@spawn, если threads === true. В противном случае выполняет выражение expr.

# DataFrames.default_table_transformation — Function

default_table_transformation(df_sel::AbstractDataFrame, fun)

Это реализация по умолчанию, вызываемая при запросе AsTable(...) => fun. Аргумент df_sel представляет собой фрейм данных, в котором хранятся столбцы, выбранные с помощью селектора AsTable(...).

# DataFrames.isreadonly — Function

isreadonly(fun)

Признак, возвращающий индикатор Bool, если функция fun просто считывает переданный аргументом. Такая функция гарантированно не изменяет и не возвращает в той или иной форме переданный аргумент. По умолчанию возвращается false.

В будущем эта функция может стать частью общедоступного API пакета DataFrames.jl. Сейчас она должна рассматриваться как экспериментальная. Добавление метода в isreadonly для определенной функции fun повысит производительность операции AsTable(...) => ByRow(fun∘collect).