Sign Up

Login

Email
Password
Find Account Info
Aren't you a member yet? Sign Up

BlueBerry User Manual

Profile
PK-Square

Introduction

BlueBerry is a web software with a graphical interface that has a goal of providing a standard Moment analysis module with personalized user experience. Because it is a web-based software, we are trying to make it available on various environments (e.g., operating systems and devices). This document may be updated as long as the software updates specifically pharmacokinetic analyses.

This document contains user guide and formulas in the BlueBerry software. BlueBerry is a web-based software. We are actively listening to you. Please leave your comments on PK Square.

As with anything man-made, it may not be perfect. Comments are always welcome, and the software will be continuously improved. The updates would be shared with the update history. We hope this software, released with good intentions, is helpful. There is no warranty for the results that this software produce and the software itself. Please, use this software from a critical viewpoint based on the pharmacokinetic knowledge you have.

This page is printable. This guide is based on the BlueBerry 2021.07.25 update. You can write comments on this manual. If you have any comments, please leave them in the comment section below.

Requirements

This section introduces the environment for developing and testing this program currently. In the environment written here, we are trying to support all possible features. However, in the case of mobile devices, there may be some limitations. We strive to make all features available on a fixed device such as a PC or laptop. We are developing so that there is no inconvenience in reading data on mobile devices.

The support environment below will change according to the latest environment over time. Microsoft Internet Explorer is not supported due to supported technical issues.

How to use

Access

You can use BlueBerry by accessing https://nca.simcube.org/blueberry. If the access address is changed, the URL would be automatically redirected to the changed address.

Enter data

Click the Add Data button at the top of the list page.

You can enter new data on the next page ( https://nca.simcube.org/blueberry/nca ). Data entry pages may change as new analysis methods are added to Blueberry.

Browse data

Select the data you want to view on the list page (https://nca.simcube.org/blueberry). You can see the result values, graphs, etc. analyzed through the input data and moment analysis.

The structure of the data view page address is https://nca.simcube.org/blueberry/data:[data number]@[data creator ID]. Data can be accessed only by the creator of the data or by those authorized to be shared.

We are developing a data sharing function, and when the sharing function is applied, we plan to make it available to attach data on your posts so that you can share your opinions. Access rights to data are reserved by the data creator or those designated by the data creator. Through future development, we plan to allow authors to specify permissions for specific groups.

Edit data

Entered data can be corrected. You can edit the entered data by clicking the "Edit" button at the bottom of the view page. Automatically calculated values cannot be modified.

The structure of the data editing page address is https://nca.simcube.org/blueberry/nca/data:[data number]@[data creator ID]. The right to modify the data is held by the data creator or the person designated by the data creator.

Analysis of data

The entered data is automatically analyzed according to the information entered by the data creator.

Unit conversion

If the units entered for dose do not match the units entered for concentrations, the prefix is interpreted as follows to match the two units.

International unit prefix (SI Prefix)

SI Prefix Scientific Notation
Y 1024
Z 1021
E 1018
P 1015
T 1012
G 109
M 106
k 103
h 102
1 100
d 10-1
c 10-2
m 10-3
u 10-6
μ 10-6
n 10-9
p 10-12
f 10-15
a 10-18
z 10-21
y 10-24

 

Calculation of PK parameters

PK parameters are calculated based on the input data. The formula for each parameter is as follows. Significant digits indicated when calculating parameters are unified to 4 digits. These significant figures are rounded up and displayed at the very end of the calculation process, and the most accurate mathematical constants that can be obtained in a 64-bit system were used for the calculation. However, since we did not receive information about the significant digits of the number entered, it does not mean information about the actual significant digits. Please consider the significant digits that are meaningful for your data.

Dose

Outputs the dose entered by the user. When used for calculation, it is used after unit conversion. If entered in mol-based unit, it can be calculated after converting to gram using the molecular weight.

C0

It means the concentration at the time zero (0). Blueberry will estimate the concentration at the time zero for a single dose, and at the time of the last administration for repeated doses. If there are other inputs from the user, an estimate is obtained according to the following rules:

  • Extravenous route, or intravenously infusion
    • In the case of repeated doses, the time will be counted from the time of the last dose.
      • If there is input concentration at the time zero, the value will be incorporated. At this time, in order to reflect the difficulty of displaying exact 0 in floating-point calculations in computer calculations, if the difference from 0 is 0.000001 or less, it will be regarded as 0.
      • If there are no observations at the time zero in the case of repeated doses, the minimum value observed after the last dose is used as C0.
    • For a single dose, C0 will be assumed to be zero.
  • Intravenously rapid infusion (IV bolus)
    • In the case of repeated doses, input concentration at the time right after the last dose will be used.
    • Plot a concentration-time graph of the first two observations and find the slope on a semi-log scale. Perform a linear regression on the graph with time on the x-axis and concentration on the y-axis, transforming the concentration so that the base is the natural constant e.
      • If the straight line from these first two observations has a negative slope, then the y-intercept of the linear regression is converted to the concentration (not log-transformed value) term and this value is assumed to be C0.
      • If the straight line from these first two observations has a positive slope, assume the first concentration observation to be C0.
    • If either of the first two observations contains a number equal to or less than zero, or a non-numeric term, the first concentration observation with a positive value is assumed to be C0.
    • If either of the first two observations contains a number or non-numeric term equal to or less than zero, and neither value is positive, assume zero for the value of C0.

Interpolation methods

There are three interpolation methods to choose from for calculating AUC and AUMC. If you choose the log-trapezoidal method, the interval where the concentration increases over time is still calculated according to the linear-trapezoidal method.

  • Linear-Trapezoidal Method
    • In a concentration-time plot, a straight line will be assumed for the time range between two points, meaning that the area under the curve (AUCt) between the two points is calculated as follows
    • If tn>tn-1, it will be written as follows:
  • Log-Trapezoidal Method
    • In a concentration-time plot, an exponential function will be assumed for the time range between two points, which means that the area under the curve (AUCt) between the two points is calculated as follows
    • If tn>tn-1, it will be written as follows:
  • Linear-trapezoidal method with error correction
    • Introduce a correction term that uses a first-order derivative to a linear-trapezoidal method that assumes a first-order expression between two points in a concentration-time plot. The underlying equation is as follows The level of error improves from O(h2) for linear-trapezoidal to O(h4). [Reference: J. J. Hart (1952), A Correction for the Trapezoidal Rule, The American Mathematical Monthly, pp. 33-37.]
    • In other words, the area under the curve (AUCt) between two points is calculated as follows.
    • If tn>tn-1, it will be written as follows:
    • The slope between two points is approximated by assuming that the function df/dt is a linear function of the slope.

AUClast

Calculates the area under the curve of the concentration-time curve from time 0 to the last observation time based on the interpolation method you selected. However, if you selected the log-trapezoidal formula, if two concentrations have the same value in an interval, or if one of the values is not positive, the linear-trapezoidal formula is used to calculate that interval.

AUC

Calculate the area under the curve (AUC) of the concentration-time curve from time 0 to infinity. Extrapolate by assuming that the concentration after the concentration at the time of the last observation decreases as a single exponential function. Do not calculate if λZ is negative (when the concentration in the terminal phase increases with time).

%ExtrapolatedAUC

Indicates the percentage extrapolated when calculating the AUC.

AUCτ

For repeated doses, calculates the area under the concentration-time curve from the time of the last dose to τ. The calculation method depends on the selected interpolation method.

AUMClast

Calculates the area under the curve of the concentration-(time*time) curve from time 0 to the last observation based on the interpolation method you selected. However, if the log-trapezoidal formula is selected and the two concentrations are equal or non-positive in an interval, the area under the curve for that interval is calculated using the linear-trapezoidal formula.

AUMC

Calculate the area under the curve of the concentration-(time*time) curve from time 0 to time infinity. Concentrations after the concentration at the time of the last observation are extrapolated by assuming that the concentration-time curve follows an exponential function. If λZ is negative (the concentration of the terminal phase increases with time), it is not extrapolated to the time infinity.

%ExtrapolatedAUMC

Indicates the extrapolated ratio when calculating AUMC.

AUMCτ

In the case of repeated administration, the area under the curve of the concentration-(time*time) curve from the time of the last administration to τ is calculated. The calculation method depends on the selected interpolation method.

CL

Calculate systemic clearance.

For extravascular route data, since AUC includes bioavailability (F), it is calculated as:

 

For repeated dose data, CLss is calculated because steady state is assumed.

MRT

If the input data is repeated dose, AUCτ and  AUMCτ would be calculated. In the case of single dose, AUC and AUMC would be calculated and utilized for the further estimation. In the case of extravascular input, The value of MRT will contain mean absorption time (or mean input time).

  • Single dose
  • Repeated dose

If the data indicates IV infusion, 주입 시간을 고려하여 계산합니다. Tin은 주입 시간을 의미합니다.

  • 단회투여
  • 반복투여

MRTlast

Estimated mean residence time calculated by the concentration from zero to the last sampling time.

  • If it is not the IV infusion:
  • In the case of IV infusion:

Vss

The volume of distribution at steady-state. This will be calculated only in the case of IV bolus injection and continuous IV infusion because estimated MRT after extravascular input (e.g., oral administration) will contain the time delay by absorption and the mathmatical formula below cannot estimate the Vss.

VZ

The volume of distribution based on terminal phase.

  • IV bolus or continuous IV infusion:
  • Considering bioavailability (F) for extravascular input.

 

The steady-state will be assumed for the repeated dose, and the volume (VZ or VZ/F) will be calculated by below:

  • IV bolus or continuous IV infusion:
  • Considering bioavailability (F) for extravascular input.

 

Accumulation Index

In the case of repeated dose, the ratio of accumulated concentration by steady state will be estimated by below:

λZ

The slope of terminal phase. This parameter will be estimated by a linear regression of log-transformed concentration over time plot. The range of terminal phase will be determined by the biggest Adjusted R2, but the higher number of observation for terminal phase will be selected if the difference of  Adjusted R2 is smaller than 0.0001 among the comparison. The range before Tmax will not be included in the terminal phase. In the case of infusion, the observed concentrations during the infusion time will not be included in the terminal phase.  If the data is not after IV bolus input, Tmax will not be included in the terminal phase.

At least three observation which is acceptable for the critera above is needed for the terminal phase estimation.

If the concentration increases during the terminal phase, λZ will not be estimated.

t1/2, terminal

The terminal phase half-life.

Number of points to estimate λZ

The number of observations in the terminal phase which is selected by the method above (see section λZ).

R2

The squared Pearson correlation coefficient for the estimation of λZ. The R2 will be calculated in the log-transformed concentration-time profiles.

Adjusted R2

This parameter is calculated for the selection of the number of terminal phase.  The Adjusted R2 is calculated because the R2 has tendency to become higher in the more number of observations.

Css, avg

The averaged concentration at the steady state.

Profile
PK-Square
Level 3
1124/1440
50%
Written by the same author
Comment
4
  • adme
    2021.12.07

    자세하게 설명되어 있는 덕분에 Blueberry 이용 시 큰 도움이 되고 있습니다. 고맙습니다!

  • adme
    운영자
    작성자
    2021.12.07
    @adme 님에게 보내는 답글

    감사합니다. 사용자 인터페이스 부분 설명이 조금 부실한 것 같기도 한데, 추후 업데이트에서 개선될 예정입니다.

  • Emma_
    2021.12.30

    자세한 설명 감사합니다.

    아주 요긴하게 잘 사용하고 있습니다!

     

  • Emma_
    운영자
    작성자
    2022.01.05
    @Emma_ 님에게 보내는 답글

    잘 사용해주셔서 감사합니다.

Write a comment
You do not have permission to access.

Login

Email
Password
Find Account Info
Aren't you a member yet? Sign Up