Skip to main content
Skip table of contents

GPX™ Reusability Tutorial: Asset Export and Import

This tutorial explores the ability to reuse assets from existing projects in your current project.

In this tutorial, we will cover:

Creating a new GPX™ project and adding a default compound

  1. Open GPX™ and, in the Dashboard view, click on the icon next to New to create a new project.

  2. Enter a Project Name, for example “Asset Import and Export”.

  3. Click Browse to select the desired Project Location folder.

  4. Click to turn on the toggle next to From Template.

  5. Click on the template called S+ Human Template to select this to use.

  6. Click Create.

image-20250729-155049.png
  1. The name of the project should now be visible in the top right corner of the program.

  2. Navigate to the Compounds view.

  3. Click Add and enter the name of the compound – we are going to use the default compound properties for this tutorial and so you can name the compound as “Example Compound”, then click OK (or press Enter).

  4. Navigate to the Pharmacokinetics view and expand the Compartmental panel (by clicking on the green arrow or double clicking on the panel header bar). This pairs your compound with the displayed physiology.

  5. Save the project and click OK (or press Enter).

image-20240911-183301.png

NB – numbers reflect the order of the steps in the screenshot, rather than corresponding to the steps in the tutorial.

Importing a previously created Physiology Schedule into a new Project

  1. Navigate to the Dashboard.

  2. Click on the icon next to Import.

  3. Click Browse, navigate to the C:\Users\<user>\AppData\Local\Simulations Plus, Inc\GastroPlus\10.2\Tutorials\Example Project A and select the project file Example Project A.gpproject by clicking on it and clicking Open.

  4. Click in the box displaying Compound to open the drop-down list and select Physiology Schedule by clicking on it.

image-20250729-155506.png

NB – numbers reflect the order of the steps in the screenshot, rather than corresponding to the steps in the tutorial.

  1. Check to ensure that the toggle next to Import All is off (the toggle should be grey, not green).

  2. Click on both the Physiology Schedules that are displayed – the table on the right should populate with the Asset Type and Asset Name.

  3. Click on Import then clear the information message that tells you Asset Import Completed by clicking OK.

image-20250729-155720.png

NB – numbers reflect the order of the steps in the screenshot, rather than corresponding to the steps in the tutorial.

  1. Navigate to the Physiology Schedules view and observe that the two Physiology Schedules we have just imported are now available.

  2. Navigate to the Simulations view and click Add to enter a new Simulation. Name the Simulation “Fasted 100mg PO Tablet with meals” and click OK.

  3. In the Drug Administration panel, check the assets that have been selected for the Compound and Dose Schedule before altering the Physiology Schedule to use “Fasted dosing Std meal schedule”.

  4. The Physiomolecular Properties Selection box will come up. This allows you to tell the program which physiomolecular properties you want to use for each compound physiology pair. The box will come up for each of the Physiologies in the Physiology Schedule, so five times in total. Each time it appears, select the Human 85.53kg 30y physiology as shown in the screenshot below and click Select.

image-20250729-155941.png
  1. In the Compound Settings panel, click Estimate to calculate the Liver First Pass Extraction.

  2. At the top of the interface, clear the message regarding the Physiology Schedule from the Message Center.

  3. Repeat steps 9 to 13 to create a second Simulation called “Fed 100mg PO Tablet with meals” that uses the Physiology Schedule “Fed dosing Std meal schedule”. The Physiomolecular Properties Selection box will come up once this time, as there is only one additional Physiology used in this Physiology Schedule.

  4. Save the Project.

  5. Click Check Warnings and then click Run Simulation for each Simulation created.

  6. When each Simulation completes, the program will automatically switch to the Analysis view. Once both Simulations have been run, select the previously run Simulation from the Simulation list.

  7. Expand the Additional Features pane by clicking on the “+”. Click on the box containing “Tissue” to activate the Color by drop-down list. Select “Random” and click the Color by: button to activate this setting in the plot (NB the colors you get may be different to the screenshot – repeatedly clicking the Color by: button cycles through different color options). To identify which curve represents which simulation, click the “-” next to Additional Features and expand the Plot Settings pane by clicking on the “+” then hover over the plot name to display the complete text.

  8. Observe how dosing in the Fed state delays the predicted Tmax and increases the predicted Cmax.

image-20250729-160955.png

NB – numbers reflect the order of the steps in the screenshot, rather than corresponding to the steps in the tutorial.

Exporting a previously created Compound

  1. Navigate to the Dashboard view, click on the icon next to Select to open an Existing project.

  2. Click Browse and navigate to the C:\Users\<user>\AppData\Local\Simulations Plus, Inc\GastroPlus\10.2\Tutorials\GPX Library and select the project file GPX Library.gpproject by clicking on it and clicking Open.

image-20240911-183553.png

NB – numbers reflect the order of the steps in the screenshot, rather than corresponding to the steps in the tutorial.

  1. Click the icon next to Export.

  2. Enter a Project Name by typing in the box called Project Name, for example “Piroxicam”, and select a file location by using the Browse button.

  3. The asset type defaults to Compound so we can go ahead and select Piroxicam from the list. There is also the option to export a Physiology, Formulation, Dosing Schedule, Physiology Schedule, Simulation, Run, Pharmacokinetic Parameters or Profiles and all these can be accessed by clicking in the box that says Compound to activate the drop-down list.

  4. Click Export.

  5. Click OK on the Asset Export Completed message.

image-20240911-184053.png

NB – numbers reflect the order of the steps in the screenshot, rather than corresponding to the steps in the tutorial.

  1. Click on the icon next to Select to open an Existing project.

  2. Click Browse and navigate to the folder where the Piroxicam project was saved, select the Piroxicam.gpproject and click Open.

  3. A message will appear to ask you to confirm that any changes to the current project have been saved – click Yes to continue.

  4. Move through the views on the navigation pane from Compounds to Simulations, observing the information that has been entered in this project. As we selected to export only the Compound there is simply a Compound and the associated Physiology and Pharmacokinetics. This can now be imported into another project, or additional assets can be added to this one to enable a Simulation to be run. To export a ready-made Simulation, select Simulation as the asset type and the Simulation that includes the compound of interest.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.